Legacy v1

EV Charging Stations

Last updated:

API reference for searching and retrieving electric vehicle charging stations.

Docs for the previous API generation. v1 endpoints keep working, but new work should target v2. See v2 documentation.

The charging endpoint returns electric vehicle charging locations. Search by location, filter by connector type, and get station details including real-time availability.

Search charging stations

GET /v1/charging

Search EV charging stations by location and filters. Each station in the response includes its connectors and operational status.

Required parameters

ParameterTypeDescription
countrystringTwo-letter country code (e.g., "US", "CA").

Optional parameters

ParameterTypeDescription
latitudenumberLatitude coordinate for location-based search.
longitudenumberLongitude coordinate for location-based search.
radiusnumberSearch radius in kilometers (default: 10).
regionstringState/province code for regional search.
connectorstringFilter by connector type (type1, type2, ccs1, ccs2, chademo, tesla, nacs).
minPowernumberMinimum power output in kilowatts.
limitnumberMaximum number of results to return (default: 20).
includeInactivebooleanInclude non-operational stations.
includePhotosbooleanInclude station photos in response.
curl "https://api.cardog.app/v1/charging" \
  -H "x-api-key: your-api-key" \
  -G \
  -d "country=US" \
  -d "latitude=37.7749" \
  -d "longitude=-122.4194" \
  -d "radius=10" \
  -d "connector=ccs1" \
  -d "minPower=50" \
  -d "limit=2"
import { CardogClient } from "@cardog/api";

const client = new CardogClient({ apiKey: "your-api-key" });

// Find EV charging stations nearby
const stations = await client.charging.search({
  lat: 37.7749,
  lng: -122.4194,
  radius: 10,
  minPower: 50, // DC fast chargers only
  limit: 10,
});

for (const station of stations.stations) {
  console.log(station.name);
  console.log(`${station.connections[0].powerKW}kW - ${station.status}`);
}
import requests
response = requests.get('https://api.cardog.app/v1/charging', params={
  'country': 'US',
  'latitude': 37.7749,
  'longitude': -122.4194,
  'radius': 10,
  'connector': 'ccs1',
  'minPower': 50,
  'limit': 2
}, headers={'x-api-key': 'your-api-key'})
data = response.json()

Example

3 keys
"response": {
"stations": [
0: {15 items}
],
"totalCount": 20,
"location": {
"name": "Utica",
"countryCode": "US",
"regionCode": null
}
}

Was this helpful?