Skip to main content
GET
/
v3
/
chargers
/
{charger}
/
transactions
List Transactions
curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/transactions \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "charger_id": 123,
  "charger_connector_id": 123,
  "reservation_id": 123,
  "id_tag": "<string>",
  "meter_start": 123,
  "meter_stop": 123,
  "total_kwh": 123,
  "started_at": "<string>",
  "stopped_at": "<string>",
  "stop_reason": "<string>",
  "is_valid": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}
Returns a paginated list of transactions for a specific charger.
​
charger
string
required
The UUID of the charger.
​
limit
integer
Maximum number of transactions to return. Between 1 and 10,000.
​
filter[status]
string
Filter by transaction status. One of active or finished.
​
filter[started_from]
string
Filter transactions started from this date. ISO 8601 date format.
​
filter[stopped_until]
string
Filter transactions stopped until this date. Must be after or equal to filter[started_from]. ISO 8601 date format.

​
Response

​
id
integer
The transaction ID.
​
charger_id
integer
The ID of the charger.
​
charger_connector_id
integer
The ID of the connector used.
​
reservation_id
integer
The reservation ID, if applicable. May be null.
​
id_tag
string
The RFID tag or token used to authorize the transaction.
​
meter_start
integer
The meter reading at the start of the transaction in Wh.
​
meter_stop
integer
The meter reading at the end of the transaction in Wh. May be null for active transactions.
​
total_kwh
number
The total energy consumed in kWh.
​
started_at
string
ISO 8601 timestamp of when the transaction started.
​
stopped_at
string
ISO 8601 timestamp of when the transaction stopped. May be null for active transactions.
​
stop_reason
string
The reason the transaction was stopped (e.g., Remote, EVDisconnected). May be null.
​
is_valid
boolean
Whether the transaction is considered valid.
​
created_at
string
ISO 8601 timestamp of when the transaction record was created.
​
updated_at
string
ISO 8601 timestamp of when the transaction record was last updated.