1. Create an account
Verify your email and open the account dashboard.
Sign upDeveloper documentation
UK public transport data in one API
Search national stops and stations, resolve source identifiers, and explore operators, routes and ordered calling patterns across bus, rail, tram and metro datasets.
2. Create a key
Name the key and copy it when shown. Plaintext is displayed once.
3. Send requests
Include the key in the X-API-Key header.
Quick start
curl -H "X-API-Key: ukpt_your_key" \
+ "https://api.ukpt.botric.co.uk/v1/locations/search?q=Manchester%20Piccadilly"Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/locations | List and filter transport locations |
| GET | /v1/locations/search?q=Piccadilly | Search locations by name |
| GET | /v1/locations/near?lat=&lon=&radius= | Find nearby locations |
| GET | /v1/operators?mode=tram | List operators by mode |
| GET | /v1/operators/{id}/routes | List routes for one operator |
| GET | /v1/routes?mode=metro | List routes by mode |
| GET | /v1/routes/{id}/stops | Get a route’s ordered stops |
| GET | /v1/resolve?crs=&naptan=&atco=&tiploc= | Resolve source identifiers |
| GET | /v2/locations/RailReplacement | List tagged rail-replacement stops |
| GET | /v2/rail/stations/{crs}/nearby-bus-services?distance=500 | Find bus operators and routes near a rail station |
| GET | /v1/rail/railreplacement?date=YYYY-MM-DD&toc=XX | List live and 12-week planned replacements; TOC is optional |
| GET | /v1/rail/railreplacement/{rid} | Get a replacement journey and linked ATCO stops |
| GET | /v1/rail/railreplacement/{uid}/{date} | Get a future or live replacement by UID and date |
| GET | /v1/rail/train/{rid} | Get an ordered rail journey by RID |
| GET | /v1/tfl/rail | List TfL rail, Tube, DLR and tram lines |
| GET | /v1/tfl/bus | List TfL bus lines and matched operating-company tags |
| GET | /v1/tfl/stations | List TfL stations |
| GET | /v1/tfl/bus-stops | List TfL bus stops |
| GET | /v1/tfl/operators | List operators matched to TfL lines |
| GET | /v1/tfl/search?q=FirstLondon | Search TfL lines, stops, stations and operators |
| GET | /v1/tfl/bus/{route_number} | Get a TfL bus route with operators, patterns and identified stops |
| GET | /v1/tfl/rail/{line_name} | Get all calling patterns and stops for a TfL rail line |
| GET | /v1/tfl/rail/status | Get current TfL rail network status |
Authentication and limits
Keys are scoped to your account and can be rotated or revoked immediately. Free keys include 10,000 requests per calendar month and allow 60 requests per minute. Responses include quota headers.
Coverage
NaPTAN/NPTG supplies national locations, BODS supplies English bus timetables, TfL supplies London modes, TNDS supplies selected tram and metro timetables, and DfT supplies rail-replacement locations. Network Rail and National Rail feeds supply rail identifiers, schedules, live running updates, incidents, accessibility and operator status.