Skip to main content
GET
List Transactions
Returns a paginated list of transactions for a specific charger.
string
required
The UUID of the charger.
integer
Maximum number of transactions to return. Between 1 and 10,000.
string
Filter by transaction status. One of active or finished.
string
Filter transactions started from this date. ISO 8601 date format.
string
Filter transactions stopped until this date. Must be after or equal to filter[started_from]. ISO 8601 date format.
string
Sort field. One of created_at, started_at, stopped_at, total_kwh, meter_start, or meter_stop. Prefix with - for descending order. Defaults to -started_at.

Response

integer
The transaction ID.
integer
The ID of the charger.
integer
The ID of the connector used.
integer
The reservation ID, if applicable. May be null.
string
The RFID tag or token used to authorize the transaction.
integer
The meter reading at the start of the transaction in Wh.
integer
The meter reading at the end of the transaction in Wh. May be null for active transactions.
boolean
true when no StopTransaction was received and Plugchoice inferred meter_stop, from the last meter value or from the next transaction’s start reading on the same connector.
number
The total energy consumed in kWh.
string
ISO 8601 timestamp of when the transaction started.
string
ISO 8601 timestamp of when the transaction stopped. May be null for active transactions.
string
The reason the transaction was stopped (e.g., Remote, EVDisconnected). May be null.
boolean
Whether the transaction is considered valid. May be null if not yet determined.
boolean
Whether the charger reported a meter stop its meter cannot have counted and the transaction is awaiting review. meter_stop then holds the highest value the connector’s meter supports, not the charger’s reading.
string
Why the charger’s meter stop was not booked as reported: meter_below_start, exceeds_connector_meter, exceeds_physical_max or no_meter_reading. Kept after the review is resolved. null when the reading was booked as reported.
boolean
Whether the transaction was imported through the API rather than reported by the charger over OCPP.
string
The system the transaction was imported from, e.g. Plugchoice app. null for transactions reported by the charger.
object
The charger associated with this transaction.
object
The connector used for this transaction.
string
ISO 8601 timestamp of when the transaction record was created.
string
ISO 8601 timestamp of when the transaction record was last updated.