Skip to main content
GET
ChargePoints / List

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Scopes

asset:chargepoints

Headers

Accept-Language
string

BCP 47 language tag for content negotiation (e.g. en, de-DE).

Example:

"en"

Query Parameters

evse_id
string

Restricts the list to the charge point carrying this EVSE ID. Separators are ignored, so DEABCE1234, DE-ABC-E1234 and DEABCE1234 all resolve to the same charge point.

Required string length: 3 - 100
station_uuid
string

Restricts the list to the charge points of this station. The station must belong to the authenticated client; an unknown UUID returns 404.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
controller_uuid
string

Restricts the list to the charge points connected to this controller. The controller must belong to the authenticated client; an unknown UUID returns 404.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
location_uuid
string

Restricts the list to the charge points at this location. The location must belong to the authenticated client; an unknown UUID returns 404.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
limit
integer<int64>

Maximum number of items per page. Maximum value is 25.

Required range: 1 <= x <= 25
Example:

"10"

page
integer<int64>

Page number to retrieve (starting from 1).

Required range: x >= 1
Example:

"1"

Response

Paginated list of charging points visible to the authenticated client.

chargepoints
object[]
required

The charging points in this page. Empty when no matches.

pagination
object

Pagination