List Transactions

GET /v3/chargers/{charger}/transactions

List Transactions

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/transactions \
  --header 'Authorization: Bearer <token>'

200

{
  "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.