GET /api/chargers
Chargers in a map viewport
Charging locations inside a bounding box, nearest the centre first unless sorted otherwise, in the compact form the map uses. When more sites match than are returned, or the box is too wide to scan in one request, truncated is true and total gives the full count. Unknown or malformed filter values are ignored. Pass ids instead of a box to fetch saved chargers in full.
Parameters
minLat- South edge, decimal degrees (WGS 84). Use with the other three edges for a viewport query; an omitted edge reads as 0.
minLng- West edge, decimal degrees. Use with the other three edges.
maxLat- North edge, decimal degrees. Use with the other three edges.
maxLng- East edge, decimal degrees. Use with the other three edges.
conn- Connectors, any of: ccs, chademo, type2, j1772 (Type 1), 3pin. Comma-separated.
kw- Minimum power in kW: 7, 22, 50 or 150.
open- 1 = only sites with a socket free now (live status).
hideoff- 1 = hide sites that are out of service.
network- Network slugs, comma-separated, as in /networks/{slug}. At most 20.
h24- 1 = only sites that publish 24-hour opening.
free- 1 = free to use.
hub- 1 = four or more chargers.
price- Maximum price, pence per kWh.
public- 1 = public access only.
rel- 1 = in service 95% or more of the last 30 days (measured from live status).
sort- Which sites fill the results when more match: near (default), price, speed, open or reliable.
view- count = return only the number of matching sites. With ids, status = return only the live status fields.
ids- Up to 100 charger ids, comma-separated. Returns those chargers in full instead of a viewport.
Example
curl 'https://ampmap.co.uk/api/chargers?minLat=53.46&minLng=-2.26&maxLat=53.49&maxLng=-2.22&conn=ccs&kw=50'
GET /api/chargers/{id}
One charging location
One location in full - sockets with live status, plugs, prices, opening hours and its data sources - with measured busy times by hour, 30-day reliability and recent driver activity.
Parameters
id required- Charger id, as in /charger/{id}.
Example
curl 'https://ampmap.co.uk/api/chargers/be-ev-golden-hill-uk'
GET /api/search
Search places, postcodes, chargers, networks and vehicles
What the site search box shows: matching places (with a bounding box to show on a map), a UK postcode, charging locations, networks and vehicle guides.
Parameters
q- Search text. Under 2 characters (or none) returns empty results; longer queries are cut to 80.
Example
curl 'https://ampmap.co.uk/api/search?q=manchester'
GET /api/embed/chargers
Slim charger rows for widgets
Charger rows in the slim form the embeddable widgets use. Either nearest to a point (at, n, dist) or inside a bounding box (minLat, minLng, maxLat, maxLng). Network slugs that match no network return an empty list.
Parameters
at- Point to search from, as lng,lat in decimal degrees: latitude within ±85, at most 8 decimal places. Nearest mode.
n- Nearest mode: how many chargers, 3 to 25 (default 10).
dist- Nearest mode: search radius in miles, 1 to 100.
minLat- Viewport mode: south edge, decimal degrees.
minLng- Viewport mode: west edge, decimal degrees.
maxLat- Viewport mode: north edge, decimal degrees.
maxLng- Viewport mode: east edge, decimal degrees.
network- Network slugs, comma-separated. At most 10.
speed- Speed bands, any of: slow, fast, rapid, ultra. Comma-separated.
conn- Connectors, any of: type2, ccs, chademo, j1772 (Type 1), 3pin. Comma-separated.
open- 1 = only chargers with a socket free now.
sort- near (default), speed, price, value or open.
Example
curl 'https://ampmap.co.uk/api/embed/chargers?at=-2.24,53.48&n=5'
GET /api/cars
Vehicle catalogue
Every electric and plug-in hybrid car in the UK catalogue, with battery size and peak AC and DC charging rates.
Example
curl 'https://ampmap.co.uk/api/cars'
GET /api/cars/{id}
One vehicle
One vehicle's full specification: battery, charging rates and connectors, range, and the source of the figures.
Parameters
id required- Vehicle id, from the catalogue.
Example
curl 'https://ampmap.co.uk/api/cars/audi-a6-e-tron-95kwh-2025'
GET /api/health
Service health
Whether the service and its database are up. Answers 503 while the database cannot be reached.
Example
curl 'https://ampmap.co.uk/api/health'