Skip to main content
GET
Search and filter locations

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

after
string

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.

Minimum string length: 1
limit
number
default:50

Results per page (1–200)

token_id
string

End-user token id; resolves through its token group to the reachable SUB networks.

token_group_id
string

Token group id (peer to token_id); resolves to its assigned SUB networks.

start_charging_capability
enum<string>

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).

Available options:
RFID,
APP
vehicle_types
enum<string>[]

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).

Available options:
MOTORCYCLE,
PERSONAL_VEHICLE,
PERSONAL_VEHICLE_WITH_TRAILER,
VAN,
SEMI_TRACTOR,
RIGID,
TRUCK_WITH_TRAILER,
BUS,
DISABLED
cpo_ids
string[]

Filter by CPO operator id (eMI3, e.g. DK*SPI). Matches any listed value.

countries
string[]

Filter by country code. Matches any listed value.

latitude
number

Center latitude for a geo-distance radius search.

longitude
number

Center longitude for a geo-distance radius search.

radius
number

Search radius in metres, 100-50000 (requires latitude + longitude).

bounding_box
string

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.

Example:

"55.6,12.5,55.7,12.6"

connector_types
enum<string>[]

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.

Available options:
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
min_power
number

Minimum connector power in watts; matches locations with a connector at or above it.

availability
enum<string>

Keep only locations with an AVAILABLE / UNAVAILABLE EVSE; ALL (default) applies no filter.

Available options:
AVAILABLE,
UNAVAILABLE,
ALL
q
string

Free-text search over name, city, postal code, and country. Filters; does not re-rank.

sort_by
enum<string>

Property to sort by; defaults to created_at. distance requires latitude + longitude.

Available options:
created_at,
last_updated,
name,
distance
sort_direction
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc

Response

Paginated list of locations matching the search filters.

pagination
object
required

Pagination state for this page.

next_cursor
string | null
required
deprecated

Deprecated: use pagination.end_cursor.

Example:

null

has_next
boolean
required
deprecated

Deprecated: use pagination.has_next.

Example:

false

data
object[]
required