API URL
GET /stations
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
lat
required
float
Latitude coordinate
lon
required
float
Longitude coordinate
address
required
string
Address for location search (for `/stations/search` endpoint)
id
required
string
Station identifier (for `/stations/:id` and `/status/:id` endpoints)
station_ids
required
array[string]
Array of station IDs for batch status check (for `/status/batch` endpoint, max 50)
radius_km
optional
number
Search radius in kilometers (default: 10)
plug_type
optional
string
Filter by plug type (e.g. J1772, CCS)
level
optional
integer
Filter by charger level (1, 2, or 3)
network
optional
string
Filter by network name
open_now
optional
boolean
Return only 24/7 stations
Example GET Request
Code
{
"lat": 37.7749,
"lon": -122.4194,
"radius_km": 10,
"plug_type": "J1772",
"level": 2
}Successful Response
Status
HTML
200 OKBody
Code
[
{
"id": "fd3a7fa1",
"name": "Mission Street Garage",
"address": {
"street": "475 Mission St",
"city": "San Francisco",
"state": "CA",
"postal": "94105"
},
"geo": {
"lat": 37.7891,
"lon": -122.3942
},
"network": "ChargePoint",
"plug_types": [
"J1772"
],
"levels": [
2
],
"hours": "24/7",
"access": "public",
"last_updated": "2025-07-26T18:04:12Z"
}
]Field
Type
Description
id
string
id (string) – Unique identifier
name
string
name (string) – Station name
address
object
address (object) – Full address block
address.street
string
geo (object) – Latitude and longitude
address.city
string
network (string) – Charging network name
address.state
string
plug_types (array[string]) – Supported plug types
address.postal
string
levels (array[int]) – Supported charging levels
geo
object
hours (string) – Operating hours
geo.lat
number
access (string) – Access type (e.g. public)
geo.lon
number
last_updated (string) – Last update timestamp (ISO8601)
network
string
—
plug_types
array
—
levels
array
—
hours
string
—
access
string
—
pricing
object
—
pricing.type
string
—
pricing.rate
string
—
station_count
integer
—
available_count
integer
—
status
string
—
Error Response
Example
Code
400 MISSING_LAT_LON – If required lat/lon parameters are missing
503 UPSTREAM_UNAVAILABLE – If fallback mode is on but OCM failsLast Updated: May 4, 2026