Skip to main content
POST
ev.chargers.search

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
center
object

Center of a circular search.

radiusMeters
integer

Circle radius in meters, up to 100000.

Required range: 1 <= x <= 100000
bounds
object

Search rectangle; must not cross the date line.

route
object[]

Route points for a corridor search.

Required array length: 2 - 1000 elements
corridorWidthMeters
integer

Route corridor width in meters.

Required range: x <= 10000
connectorTypes
enum<string>[]

Required connector standards.

Required array length: 1 - 7 elements

Charging connector standard.

Available options:
ccs1,
ccs2,
chademo,
type1,
type2,
type2-socket,
nacs
statuses
enum<string>[]

Required point statuses.

Required array length: 1 - 5 elements

Reported charging point status.

Available options:
available,
occupied,
reserved,
out-of-service,
unknown
minPowerKw
number

Minimum charging power in kilowatts.

Required range: x >= 0
maxPowerKw
number

Maximum charging power in kilowatts.

accessTypes
enum<string>[]

Allowed station access types.

Required array length: 1 - 5 elements
Available options:
public,
authorized,
restricted,
private,
unknown
operatorNames
string[]

Exact operator names to filter by.

Required array length: 1 - 20 elements
Required string length: 1 - 128
paymentBrands
string[]

Payment brand names accepted at the station.

Required array length: 1 - 20 elements
Required string length: 1 - 128
language
string

Language tag, such as en-GB.

Pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,2}$
view
enum<string>

View used for disputed territories.

Available options:
Unified,
AR,
IL,
IN,
MA,
PK,
RS,
RU,
TR,
CN,
TW
limit
number

Stations to return, up to 100; default 10.

Required range: x >= 1

Response

The result

results
object[]
required

Matching charging stations.