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>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt

Use this file to discover all available pages before exploring further.

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.