Search and filter locations
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
Cursor to start fetching records after — the pagination.end_cursor of a previous response. Omit it to fetch the first page, and stop paging once pagination.has_next is false. Sending it empty is a 400: an empty cursor is a broken cursor, not a request for the first page.
1Results per page (1–200)
End-user token id; resolves through its token group to the reachable SUB networks.
Token group id (peer to token_id); resolves to its assigned SUB networks.
Keep only locations with an EVSE usable with this start-charging method. RFID matches a location with at least one EVSE exposing an RFID reader; APP matches one with an EVSE that can be remote-started. Existential (any EVSE) and availability-agnostic (occupied or faulted EVSEs still count).
RFID, APP Keep only locations with an EVSE that fits any of these vehicle types. Values are the OCPI VehicleType enum. Matches a location with at least one EVSE advertising ANY listed value (multi-value is OR). Existential (any EVSE) and availability-agnostic (occupied or faulted EVSEs still count).
MOTORCYCLE, PERSONAL_VEHICLE, PERSONAL_VEHICLE_WITH_TRAILER, VAN, SEMI_TRACTOR, RIGID, TRUCK_WITH_TRAILER, BUS, DISABLED Filter by CPO operator id (eMI3, e.g. DK*SPI). Matches any listed value.
Filter by country code. Matches any listed value.
Center latitude for a geo-distance radius search.
Center longitude for a geo-distance radius search.
Search radius in metres, 100-50000 (requires latitude + longitude).
Viewport as SW_lat,SW_lng,NE_lat,NE_lng (south-west then north-east corner). Alternative to the latitude/longitude/radius search — the two are mutually exclusive.
"55.6,12.5,55.7,12.6"
Filter by connector standard (e.g. IEC_62196_T2). Matches a location with at least one connector of ANY listed standard (multi-value is OR). An unrecognised standard is a 400, not an empty page.
CHADEMO, CHAOJI, DOMESTIC_A, DOMESTIC_B, DOMESTIC_C, DOMESTIC_D, DOMESTIC_E, DOMESTIC_F, DOMESTIC_G, DOMESTIC_H, DOMESTIC_I, DOMESTIC_J, DOMESTIC_K, DOMESTIC_L, DOMESTIC_M, DOMESTIC_N, DOMESTIC_O, GBT_AC, GBT_DC, IEC_60309_2_single_16, IEC_60309_2_three_16, IEC_60309_2_three_32, IEC_60309_2_three_64, IEC_62196_T1, IEC_62196_T1_COMBO, IEC_62196_T2, IEC_62196_T2_COMBO, IEC_62196_T3A, IEC_62196_T3C, MCS, NEMA_10_30, NEMA_10_50, NEMA_14_30, NEMA_14_50, NEMA_5_20, NEMA_6_30, NEMA_6_50, OTHER, PANTOGRAPH_BOTTOM_UP, PANTOGRAPH_TOP_DOWN, SAE_J3400, TESLA_R, TESLA_S Minimum connector power in watts; matches locations with a connector at or above it.
Keep only locations with an AVAILABLE / UNAVAILABLE EVSE; ALL (default) applies no filter.
AVAILABLE, UNAVAILABLE, ALL Free-text search over name, city, postal code, and country. Filters; does not re-rank.
Property to sort by; defaults to created_at. distance requires latitude + longitude.
created_at, last_updated, name, distance Sort direction.
asc, desc Response
Paginated list of locations matching the search filters.