List chargers

GET

/chargers

List all chargers matching criteria

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

Pattern

"^\\d{4}-\\d{2}-\\d{2}$"

organization-id*

Type

string

Required

Min Length

1

Max Length

40

x-ignore-forbidden-include

Type

string

Valid values

"1""true"

Query Parameters

filter

Filter criteria for chargers. Allowed fields: id, ipAddress, status, plugncharge, name, locationId, type, createdAt. Allowed operators: eq, ne, lt, gt, lte, gte, contains

sort

Type

string

Default

"-createdAt"

Min Length

1

Max Length

256

include

Related entities to include in the response. Allowed fields: connectors, location

Type

string

Default

"connectors"

Min Length

1

Max Length

512

aggregate

Aggregation functions to apply. Supported functions: count, sum, avg, min, max. Format: function:field.subfield (e.g. count:id, sum:connectors.max-power)

Type

string

Min Length

1

Max Length

512

aggregate_interval

Time bucket interval (e.g. 1m, 2h, 1d). Required when aggregate is set.

Type

string

Min Length

2

Max Length

16

page

1-based page index

Type

integer

Default

1

Exclusive Minimum

0

Maximum

4294967295

per_page

Page size

Type

integer

Default

10

Exclusive Minimum

0

Maximum

100

Responses

success.charger.list

Content-Type

application/json

object

object[]

Required

Minimum0

Maximum9007199254740991