Charging Events
Context
The Charging Events API provides access to completed charging session records for your sites. Each event represents a single transaction — from the moment a charging session starts to the moment it ends — and includes energy, timing, and state-of-charge data where available.
Available Endpoints
GET /charging-events/site/{id}- Retrieve charging events for a specific site
Returns a paginated list of charging events for the given site, filtered by time range and optionally searchable and sortable.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The ID of the site for which to retrieve charging events |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
from | string (ISO 8601) | Yes | Start of the time range |
to | string (ISO 8601) | Yes | End of the time range |
search_text | string | No | Free-text search across charging event data (max 100 characters) |
sort_field | string | No | Field to sort results by — see Sort Fields |
sort_order | asc | desc | No | Sort order for results |
take | number | No | Number of records to return (max 1000) |
skip | number | No | Number of records to skip, for pagination |
Response
The endpoint returns a JSON array of charging event objects, ordered according to the sort_field and sort_order parameters. Use take and skip to page through the results.
[
{
"TransactionID": 123456,
"SiteName": "Berlin Depot",
"ChargerType": "AC",
"ChargerID": "charger-01",
"ConnectorID": 1,
"StartAt": "2026-01-01T08:00:00.000Z",
"EndAt": "2026-01-01T11:30:00.000Z",
"InitialSoC": 20,
"BusID": "Fleet Vehicle 7",
"EndSoC": 85,
"EnergyDelivered": 42.5
}
]Data
Each charging event contains the following fields:
| Field | Type | Description |
|---|---|---|
TransactionID | number | Unique identifier for the charging transaction |
SiteName | string | null | Display name of the site where the session occurred |
ChargerType | AC | DC | null | Whether the charger is AC or DC |
ChargerID | string | ID of the charging station |
ConnectorID | number | Connector number on the charging station |
StartAt | string (ISO 8601) | Start time of the charging session |
EndAt | string (ISO 8601) | End time of the charging session |
InitialSoC | number | null | State of charge at the start of the session (%) |
BusID | string | null | Identifier associated with the session, derived from the RFID tag name |
EndSoC | number | null | State of charge at the end of the session (%) |
EnergyDelivered | number | null | Total energy delivered during the session (kWh) |
Sort Fields
The sort_field query parameter accepts the following values. Sorting is applied to the underlying session record, so some sort keys (e.g. cost, duration) are valid even though they are not returned in the response body:
| Value | Description |
|---|---|
occurrence_time | Sort by when the event was recorded |
rfid | Sort by RFID tag |
rfid_name | Sort by RFID tag display name |
energy_consumed | Sort by energy delivered |
duration | Sort by session duration |
cost | Sort by actual cost |
optimized_cost | Sort by DTO-optimised cost |
cost_savings | Sort by cost savings |