Skip to content

List charger connections​

GET
/chargers/analytics/connections

Connect and disconnect times of charger WebSocket sessions for the last 30 days (default), scoped to the organization, a location, or charger filters

Authorizations​

bearerAuth

Generate an API token here

Type
HTTP (bearer)

Parameters​

Header Parameters

compatibility-date*

API compatibility date in YYYY-MM-DD format. Must be a date after 2025-11-01.

Type
string
Required
Example"2025-11-02"
Pattern
^\d{4}-\d{2}-\d{2}$
organization-id*

Routes the request to the organization named by this ID. The bearer token must be authorized for that organization.

Type
string
Required
Example"3b241101-e2bb-4255-8caf-4136c566a962"
Min Length
1
Max Length
40
x-ignore-forbidden-include

If an include requests data the token cannot view, set this to true or 1 to omit that included field instead of returning 403. This does not grant the missing permission.

Type
string
Valid values
"1""true"
Examples
"true""1"

Query Parameters

filter

Use : for equality, <> for inequality, < and > for strict comparisons, <: and >: for inclusive comparisons, and ~ for substring matching. Use semicolons to AND conditions; multiple filter entries are OR alternatives.

sort

Sort by up to 3 fields from: chargerId, locationId, connectionId, connectedAt, disconnectedAt, reason. Prefix with + for ascending or - for descending, and separate fields with commas.

Type
string
Example"-chargerId"
Default
"-connectedAt"
Min Length
1
Max Length
256
since
Type
string
Format
"date-time"
Pattern
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
until
Type
string
Format
"date-time"
Pattern
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
page
Type
integer
Default
1
Exclusive Minimum
0
Maximum
9007199254740991
per_page
Type
integer
Default
100
Exclusive Minimum
0
Maximum
5000

Responses​

success.charger-analytics.connections.list

application/json
Minimum0
Maximum9007199254740991

Playground​

Authorization
Headers
Variables
Key
Value

Samples​