API reference

Charging

Last updated: October 2026

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/stationssince 2026-08-31

EV charging stations near a point

Radius search over our own copy of the Open Charge Map dataset — no live upstream. Nearest first. Open Charge Map data is ODbL 1.0: responses carry the `attribution` string; surface it wherever stations render.

Query parameters

latnumberrequired

Search-center latitude

lngnumberrequired

Search-center longitude

radius_kmnumberoptional

Search radius in km

connectorintegeroptional

OCM ConnectionTypeID filter — stations with at least one matching connector

min_power_kwnumberoptional

Minimum station max-power in kW

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

Status filter; default serves only operational stations

limitintegeroptional

Station cap

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

Response

200ChargingSearch

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)

poistring | null

The place this station is at: a poi:{geohash} ref, readable at /v2/locations/{geohash}. A fuel station or dealer at the same spot shares it. Null when the station has no place.

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: {18 items},

1: {18 items},

2: {18 items},

3: {18 items},

4: {18 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}since 2026-08-31

One charging station by source id

Each station carries `poi` (added 2026-10-26, additive): the `poi:{geohash}` ref of the place it is at, readable at `/v2/locations/{geohash}`, or null when the station has no place.

Path parameters

idstringrequired

Source station id (OCM ChargePoint ID)

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

Response

200ChargingStationDetail

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)

poistring | null

The place this station is at: a poi:{geohash} ref, readable at /v2/locations/{geohash}. A fuel station or dealer at the same spot shares it. Null when the station has no place.

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",

"poi": null,

"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

Was this helpful?