v1 · legacyPreserved docs for the previous API generation — v1 endpoints keep working, but new work should target v2. See v2 documentation.

EV Charging Stations

API reference for searching and retrieving electric vehicle charging stations.

The EV charging station endpoints provide access to a comprehensive database of electric vehicle charging locations. Using these endpoints, you can search for charging stations by location, filter by connector types, and get detailed station information including real-time availability.

Search charging stations

GET /v1/charging

This endpoint allows you to search for EV charging stations based on location and various filtering criteria. The response includes detailed information about each station, including available connectors and operational status.

Required parameters

Parameter	Type	Description
`country`	string	Two-letter country code (e.g., "US", "CA").

Optional parameters

Parameter	Type	Description
`latitude`	number	Latitude coordinate for location-based search.
`longitude`	number	Longitude coordinate for location-based search.
`radius`	number	Search radius in kilometers (default: 10).
`region`	string	State/province code for regional search.
`connector`	string	Filter by connector type (type1, type2, ccs1, ccs2, chademo, tesla, nacs).
`minPower`	number	Minimum power output in kilowatts.
`limit`	number	Maximum number of results to return (default: 20).
`includeInactive`	boolean	Include non-operational stations.
`includePhotos`	boolean	Include station photos in response.

bash

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"

typescript

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}`);
}

python

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

}