Location
No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.
Get Map Locations
Returns clustered charging location data optimized for map visualization. Locations are automatically clustered based on zoom level and geographic proximity to improve map performance. The bounding box must not exceed the zoom-dependent maximum size (90° at zoom 3, scaling down as zoom increases). For detailed information about individual locations, use the individual location endpoint.
Query parameters3
Northeast corner coordinates of the bounding box in 'latitude,longitude' format (e.g., '52.5200,13.4050')
Southwest corner coordinates of the bounding box in 'latitude,longitude' format (e.g., '52.5000,13.3800')
Map zoom level determining clustering granularity. Higher values show more detailed clustering (range: 1-20). Values below 3 are clamped to 3.
200Successfully returns clustered location data optimized for map visualization within the specified geographic bounds. application/json
clustersobject[]Array of location clusters within the requested bounding box, grouped by geographic proximity and zoom level
Array of location clusters within the requested bounding box, grouped by geographic proximity and zoom level
Array of location UUIDs included in this cluster (present when cluster contains few locations)
Latitude coordinate of the cluster center
Longitude coordinate of the cluster center
Number of locations aggregated in this cluster
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
Stable error identifier for programmatic handling (e.g., 'validation.failed', 'resource.not_found')
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
Search Locations
Search and retrieve charging locations by their IDs. Provide multiple location IDs to get detailed information about specific locations. Maximum 50 location IDs allowed per request.
Query parameters1
Location UUIDs to retrieve. Repeat parameter for multiple IDs (e.g., 'location_id=uuid1&location_id=uuid2'). Maximum 50 IDs per request.
200Successfully returns a paginated list of charging locations matching the specified search criteria. application/json
locationsobject[]Array of charging locations matching the search criteria
Array of charging locations matching the search criteria
Timestamp when this location was last updated
Timestamp when this location was created
Display name of the charging location
Street address of the location
City where the location is situated
ISO 3166-1 alpha-2 country code
Postal code of the location
geo_locationobjectGeographic coordinates of the location
Geographic coordinates of the location
Latitude coordinate in decimal degrees
Longitude coordinate in decimal degrees
Unique identifier of the location
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
Stable error identifier for programmatic handling (e.g., 'validation.failed', 'resource.not_found')
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
Get Location
Retrieves detailed information about a specific charging location. Optionally include charge point details and tariff information for comprehensive location data.
Path parameters1
Query parameters2
Include detailed charge point information in the response. When enabled, provides connector types, power ratings, and availability status for each charge point. Default is false.
Include pricing and tariff information in the response. Shows applicable rates and billing structures. Requires 'enrich_charge_points' to be enabled. Default is false.
200Successfully returns detailed location information, optionally enriched with charge points and tariff data. application/json
Timestamp when this location was last updated
Timestamp when this location was created
Display name of the charging location
Street address of the location
City where the location is situated
ISO 3166-1 alpha-2 country code
Postal code of the location
charge_pointsobject[]List of charge points available at this location (included when enrich_charge_points=true)
List of charge points available at this location (included when enrich_charge_points=true)
qualityobjectQuality metrics for this charge point
Quality metrics for this charge point
When this quality score was last updated
Average seconds from Pending to Started
Average seconds from Stopped to Settled
User-friendly reliability label: excellent, good, fair, poor, very_poor, or insufficient_data
Composite quality score from 0 (worst) to 100 (best)
Ratio of settled sessions (0.0–1.0)
Ratio of settled sessions that never reached Started (0.0–1.0)
Total number of terminal sessions
Type of power delivery (AC or DC)
Type of connector available at this charge point
Current operational status of the charge point
tariffsobject[]Applicable pricing tariffs for this charge point
Applicable pricing tariffs for this charge point
Timestamp of last external update
Timestamp when this record was created in our system
Timestamp when this record was last updated in our system
End date and time when this tariff expires
URL to external tariff information page
min_priceobjectMinimum price for this tariff
Minimum price for this tariff
max_priceobjectMaximum price for this tariff
Maximum price for this tariff
Start date and time when this tariff becomes active
Type of tariff (e.g., regular, ad-hoc)
ISO 4217 currency code
elementsobject[]List of tariff elements defining the pricing structure
List of tariff elements defining the pricing structure
tariff_alt_textobject[]Alternative tariff information in multiple languages
Alternative tariff information in multiple languages
Unique identifier of the tariff
Maximum power output in kilowatts
Unique identifier of the charge point
geo_locationobjectGeographic coordinates of the location
Geographic coordinates of the location
Latitude coordinate in decimal degrees
Longitude coordinate in decimal degrees
Unique identifier of the location
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
Stable error identifier for programmatic handling (e.g., 'validation.failed', 'resource.not_found')