GET/v1/transit/departures

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/v1/transit/departures?stop=…" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
stop	query	yes	Required. The stop's NaPTAN ATCO code, as `/v1/transit/stops` returns it
at	query	no	Start of the window, RFC 3339 (default now). Must fall inside the three service days the index holds
window_minutes	query	no	Window length, 1 to 180 minutes (default 60)
limit	query	no	Most departures to return, 1 to 30 (default 8)

Responses

200Timetabled departures from BODS timetables, in order, each with its line, destination, operator, scheduled_at and a live vehicle on that line seen heading towards the stop (or null). basis is always timetable and label says what a live entry is: an observation, never an arrival prediction

Field	Type	Required	Description
attribution	string	yes	NaPTAN and BODS attribution (both OGL v3.0).
basis	string	yes	Always `timetable`.
coverage	string	yes	What this covers and what it does not.
departures	TransitDeparture[]	yes	In timetable order.
generated_at	string	yes	When this answer was assembled (RFC 3339).
label	string	yes	The honesty line, verbatim. Show it with the departures.
stop	TransitStop	yes
timetable_date	string	yes	The service date the requested time falls on, `YYYY-MM-DD`.

400stop missing or malformed, at malformed or outside the timetable window this gateway holds (the message names the window), or a malformed window_minutes or limit. Not billed

401Missing or invalid API key

404No such stop in the index (bus and coach stops in England only). Not billed

429Quota or rate limit exceeded

501Timetable departures not enabled (SN_TRANSIT_DIR unset, or no departures index built yet). Not billed

Error bodies follow the shared problem model documented on API conventions.

Also under transit

GET /v1/transit/stops GET /v1/transit/vehicles

Generated from https://api.mapmap.ai/openapi.json on 2026-10-12 · operationId get_transit_departures