Skip to main content
GET
/
v3
/
sites
/
{site}
/
transactions
List Transactions
curl --request GET \
  --url https://app.plugchoice.com/api/v3/sites/{site}/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,
  "charger": {
    "uuid": "<string>",
    "identity": "<string>",
    "reference": "<string>"
  },
  "connector": {
    "connector_id": 123
  },
  "created_at": "<string>",
  "updated_at": "<string>"
}
Returns a paginated list of transactions for all chargers at a specific location. Includes the total energy consumption across the location.
site
string
required
The UUID of the location.
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[charger_uuid]
string
Filter by a specific charger UUID.
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. May be null.
is_valid
boolean
Whether the transaction is considered valid.
charger
object
The charger associated with this transaction.
connector
object
The connector used for this transaction.
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.
The response includes an additional top-level field:
total_kwh
number
The total energy consumption in kWh across all chargers at the location.