Charging

live

EV charging stations (Open Charge Map data, ODbL)

GET/v2/charging/stationsEV charging stations near a point
GET/v2/charging/stations/{id}One charging station by source id

GET/v2/charging/stations

EV charging stations near a point

Radius search over our own copy of the Open Charge Map dataset; no live upstream call is made. Results are nearest first. Open Charge Map data is ODbL 1.0: responses carry the `attribution` string, and it must be shown wherever stations render.

Query parameters

7 parameters

latnumberrequired

Search-center latitude

lngnumberrequired

Search-center longitude

radius_kmnumberoptional

Search radius in km

connectorintegeroptional

Open Charge Map connection type id. Only stations with at least one connector of this type are returned.

min_power_kwnumberoptional

Only stations whose highest-rated connector is at least this many kW

status"Operational" | "NonOperational" | "any"optional

Status filter; default serves only operational stations

limitintegeroptional

Maximum stations returned

curl "https://api.cardog.app/v2/charging/stations?lat=43.6532&lng=-79.3832&radius_km=10" \
  -H "x-api-key: $CARDOG_API_KEY"

Response

200ChargingSearch

37 fields

totalinteger

Number of stations returned, at most limit

stationsobject[]

Nearest first

refstring

Entity ref ({domain}:{key}) in the "station" domain. Example: "station:ocm/248113"

idstring

Station id in the source dataset (Open Charge Map ChargePoint ID)

sourcestring

Source dataset: "ocm" (Open Charge Map). Other values may be added.

namestring | null

addressobject

streetstring | null

citystring | null

statestring | null

postalCodestring | null

countrystring | null

Country code (ISO 3166-1 alpha-2)

locationobject

latitudenumber

longitudenumber

connectorsobject[]

connectionTypeIdinteger

Open Charge Map connection type id (0 = unspecified)

connectionTypestring

Connector type name, e.g. "CCS Type 1", "NACS"

powerKWnumber

Rated power in kW (0 = unknown)

currentType"AC" | "DC"

levelinteger

Charging level 1–3 (0 = unspecified)

voltagenumber

Volts (0 = unknown)

amperagenumber

Amps (0 = unknown)

quantityinteger | null

Number of connectors of this type at the station

maxPowerKwnumber | null

Highest rated power of any connector at the station, in kW

numberOfPointsinteger | null

Number of charge points at the station

operatorstring | null

statusstring

Station status: "Operational" or "NonOperational". Decommissioned stations are kept in the dataset, so filter on this field.

usagestring | null

Usage class, e.g. "Public", "Private - Restricted Access"

isMembershipRequiredboolean | null

isPayAtLocationboolean | null

dateCreatedstring | null

When the source first recorded the station (ISO 8601)

dateLastVerifiedstring | null

Last source verification (ISO 8601)

linksobjectoptional

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

asOfstringoptional

When the data was last refreshed (ISO 8601)

attributionstring

Open Charge Map attribution string (ODbL 1.0 licence). Must be shown wherever station data is displayed.

linksobjectoptional

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

Example response

5 keys

"response": {

"total": 5,

"stations": [

0: {17 items},

1: {17 items},

2: {17 items},

3: {17 items},

4: {17 items}

"asOf": "2026-08-23T12:15:55.919Z",

"attribution": "Charging station data (c) Open Charge Map contributors, ODbL 1.0 (https://openchargemap.org)",

"links": {

"self": "/v2/charging/stations"

}

Errors400401402429500every non-2xx body is the error envelope

GET/v2/charging/stations/{id}

One charging station by source id

Path parameters

1 parameter

idstringrequired

Station id in the source dataset (Open Charge Map ChargePoint ID)

curl "https://api.cardog.app/v2/charging/stations/248113" \
  -H "x-api-key: $CARDOG_API_KEY"

Response

200ChargingStationDetail

35 fields

stationobject

refstring

Entity ref ({domain}:{key}) in the "station" domain. Example: "station:ocm/248113"

idstring

Station id in the source dataset (Open Charge Map ChargePoint ID)

sourcestring

Source dataset: "ocm" (Open Charge Map). Other values may be added.

namestring | null

addressobject

streetstring | null

citystring | null

statestring | null

postalCodestring | null

countrystring | null

Country code (ISO 3166-1 alpha-2)

locationobject

latitudenumber

longitudenumber

connectorsobject[]

connectionTypeIdinteger

Open Charge Map connection type id (0 = unspecified)

connectionTypestring

Connector type name, e.g. "CCS Type 1", "NACS"

powerKWnumber

Rated power in kW (0 = unknown)

currentType"AC" | "DC"

levelinteger

Charging level 1–3 (0 = unspecified)

voltagenumber

Volts (0 = unknown)

amperagenumber

Amps (0 = unknown)

quantityinteger | null

Number of connectors of this type at the station

maxPowerKwnumber | null

Highest rated power of any connector at the station, in kW

numberOfPointsinteger | null

Number of charge points at the station

operatorstring | null

statusstring

Station status: "Operational" or "NonOperational". Decommissioned stations are kept in the dataset, so filter on this field.

usagestring | null

Usage class, e.g. "Public", "Private - Restricted Access"

isMembershipRequiredboolean | null

isPayAtLocationboolean | null

dateCreatedstring | null

When the source first recorded the station (ISO 8601)

dateLastVerifiedstring | null

Last source verification (ISO 8601)

linksobjectoptional

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

asOfstringoptional

When the data was last refreshed (ISO 8601)

attributionstring

Open Charge Map attribution string (ODbL 1.0 licence). Must be shown wherever station data is displayed.

Example response

3 keys

"response": {

"station": {

"ref": "station:ocm/248113",

"id": "248113",

"source": "ocm",

"name": "Nathan Phillips Square",

"address": {5 items},

"location": {2 items},

"connectors": [1 item],

"maxPowerKw": 3.7,

"numberOfPoints": null,

"operator": null,

"status": "Operational",

"usage": "Public",

"isMembershipRequired": false,

"isPayAtLocation": false,

"dateCreated": "2023-03-07T05:48:00Z",

"dateLastVerified": "2024-02-20T10:40:00Z",

"links": {1 item}

"asOf": "2026-08-23T12:15:55.919Z",

"attribution": "Charging station data (c) Open Charge Map contributors, ODbL 1.0 (https://openchargemap.org)"

}

Errors400401402404429500every non-2xx body is the error envelope

Generated from the contract. Machine-readable spec: GET https://api.cardog.app/v2/openapi.json · markdown twin: /docs/reference/charging.md