---
title: "`GET /v1/transit/stops?lat=&lon=&radius_m=500&limit=10`."
method: GET
path: "/v1/transit/stops"
tags: ["transit"]
---

# \`GET /v1/transit/stops?lat=&lon=&radius_m=500&limit=10\`.

`GET /v1/transit/stops`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/transit/stops`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `lat` number, double, required
- `lon` number, double, required
- `radius_m` integer
- `limit` integer

## Response `200`

England bus and coach stops (NaPTAN) near the point, nearest first, each with its ATCO code, distance, bearing from the point and the lines the BODS timetable has calling there; `coverage` and the OGL v3.0 `attribution` on every answer. Bus only: rail, tram and ferry are not included

- TransitStopsResponse: `GET /v1/transit/stops` answer.
  - `attribution` string, required: NaPTAN and BODS attribution (both OGL v3.0), to be shown with the data.
  - `coverage` string, required: What this covers and what it does not.
  - `stops` TransitStop[], required: Nearest first.
    - `bearing_deg` integer, nullable: Bearing from the queried point to the stop, degrees clockwise from true north (stops search only).
    - `distance_m` integer, nullable: Distance from the queried point, metres (stops search only).
    - `id` string, required: The NaPTAN ATCO code, e.g. `490008660N`. Pass it to `/v1/transit/departures?stop=`.
    - `indicator` string, nullable: The on-street indicator, e.g. `Stop S`, or `null`.
    - `lat` number, double, required
    - `lines` string[], required: Line names the timetable has calling here, e.g. `["9","15","23"]`.
    - `locality` string, nullable: The NaPTAN locality, or `null`.
    - `lon` number, double, required
    - `name` string, required: The stop's common name.

## Other responses

- `400`: `lat` or `lon` missing or out of range, or a malformed `radius_m` or `limit`. Not billed
- `401`: Missing or invalid API key
- `429`: Quota or rate limit exceeded
- `501`: Transit stops not enabled (`SN_TRANSIT_DIR` unset, or no departures index built yet). Not billed

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)