London TfL transit — real-time Tube arrivals, bus predictions, line status, service disruptions, journey planning, and route info for the London Underground, DLR, Overground, Elizabeth line, and buses. Use when the user asks about London public transport, Tube times, bus arrivals, or TfL service status.
Real-time London TfL transit data — Tube arrivals, bus predictions, line status, disruptions, journey planning, and route information. Uses TfL's single unified REST API for all modes. API key optional (free, recommended for higher rate limits).
TfL has a () that returns JSON for ALL modes — Tube, bus, DLR, Overground, Elizabeth line, trams, river bus, cable car. No protobuf, no SIRI, no multiple feed formats. Just one clean REST API with consistent JSON responses.
api.tfl.gov.ukAPI key: Register for a free app_key at https://api-portal.tfl.gov.uk/ — append ?app_key={KEY} to requests. The API works without a key for basic usage but is rate-limited; with a key you get 500 requests per minute.
| Endpoint | Description |
|---|---|
/Line/Mode/tube/Status | All Tube line statuses |
/Line/{lineId}/Status | Specific line status |
/StopPoint/{naptanId}/Arrivals | Arrivals at a stop |
/Line/{lineId}/Arrivals/{stopPointId} | Arrivals filtered by line |
/StopPoint/Search/{query} | Search stops by name |
/StopPoint?lat=&lon=&radius= | Stops near location |
/Line/{lineId}/StopPoints | Stops on a line |
/Line/{lineId}/Route/Sequence/{dir} | Route stop sequence |
/Line/{lineId}/Disruption | Disruptions on a line |
/Journey/JourneyResults/{from}/to/{to} | Journey planning |
/Line/Mode/bus | All bus routes |
All endpoints return JSON. Append ?app_key={KEY} for authenticated requests.
The scripts in this skill's scripts/ directory handle fetching, parsing, and presenting TfL data.
scripts/tfl.mjsMain entry point. Supports these commands:
# Tube line status
node scripts/tfl.mjs status
node scripts/tfl.mjs status --all
node scripts/tfl.mjs status --line victoria
# Arrivals at a station
node scripts/tfl.mjs arrivals --station "Oxford Circus"
node scripts/tfl.mjs arrivals --stop 940GZZLUOXC
node scripts/tfl.mjs arrivals --stop-search "kings cross"
node scripts/tfl.mjs arrivals --stop-search "kings cross" --line piccadilly
# Bus arrivals
node scripts/tfl.mjs bus-arrivals --stop 490005183E
node scripts/tfl.mjs bus-arrivals --stop-search "oxford circus"
node scripts/tfl.mjs bus-arrivals --stop-search "oxford circus" --route 24
# Disruptions
node scripts/tfl.mjs disruptions
node scripts/tfl.mjs disruptions --line northern
# Routes and stops
node scripts/tfl.mjs routes
node scripts/tfl.mjs routes --all
node scripts/tfl.mjs bus-routes
node scripts/tfl.mjs stops --search "waterloo"
node scripts/tfl.mjs stops --near 51.5074,-0.1278 --radius 500
node scripts/tfl.mjs stops --line victoria
node scripts/tfl.mjs route-info --line bakerloo
node scripts/tfl.mjs route-info --route 24
# Journey planning
node scripts/tfl.mjs journey --from "waterloo" --to "kings cross"
node scripts/tfl.mjs journey --from "51.5031,-0.1132" --to "51.5308,-0.1238"
Basic functionality works without a key (rate-limited). For 500 requests/minute:
TFL_API_KEY| Line ID | Line Name | Emoji | Terminals |
|---|---|---|---|
| bakerloo | Bakerloo | brown | Harrow & Wealdstone <-> Elephant & Castle |
| central | Central | red | Epping / Ealing Broadway <-> West Ruislip |
| circle | Circle | yellow | Hammersmith (loop via Liverpool Street) |
| district | District | green | Richmond / Ealing Broadway <-> Upminster |
| hammersmith-city | Hammersmith & City | pink | Hammersmith <-> Barking |
| jubilee | Jubilee | silver | Stanmore <-> Stratford |
| metropolitan | Metropolitan | magenta | Chesham / Amersham / Uxbridge <-> Aldgate |
| northern | Northern | black | Edgware / High Barnet <-> Morden / Battersea |
| piccadilly | Piccadilly | dark blue | Heathrow T5 / Uxbridge <-> Cockfosters |
| victoria | Victoria | light blue | Walthamstow Central <-> Brixton |
| waterloo-city | Waterloo & City | teal | Waterloo <-> Bank |
| Line ID | Name | Type |
|---|---|---|
| dlr | DLR | Docklands Light Railway |
| liberty | Liberty | Overground (Romford — Upminster) |
| lioness | Lioness | Overground (Watford — Euston) |
| mildmay | Mildmay | Overground (Stratford — Richmond/Clapham) |
| suffragette | Suffragette | Overground (Gospel Oak — Barking) |
| weaver | Weaver | Overground (Liverpool St — Enfield/Cheshunt/Chingford) |
| windrush | Windrush | Overground (Highbury — Crystal Palace/Clapham/W Croydon) |
| elizabeth | Elizabeth line | Crossrail |
| tram | London Trams | Croydon Tramlink |
| Fare Type | Price |
|---|---|
| Tube Zone 1 (Oyster/contactless, peak) | £2.80 |
| Tube Zone 1 (Oyster/contactless, off-peak) | £2.70 |
| Tube Zones 1-2 (peak) | £2.80 |
| Tube Zones 1-2 (off-peak) | £2.70 |
| Tube Zones 1-3 (peak) | £3.50 |
| Tube Zones 1-3 (off-peak) | £2.80 |
| Bus & Tram (any journey) | £1.75 |
| Hopper fare (unlimited bus/tram within 1 hour) | £1.75 total |
| Daily cap Zones 1-2 | £8.90 |
| Weekly cap Zones 1-2 | £44.70 |
| Cash single (ticket machine) | £6.70 (Zone 1) |
Peak: Mon-Fri 6:30-9:30am and 4:00-7:00pm (except public holidays).
940GZZLU{code} format--station or --stop-search for name-based lookups; use --stop for exact NaPTAN IDsarrivals command uses timeToStation (seconds) from the TfL API for ETA490{code} formatTFL_API_KEY is not set, requests still work but are rate-limited — a note is printedWhen presenting transit info to the user:
timeToStation / 60)| Endpoint | Data Sent | Data Received |
|---|---|---|
api.tfl.gov.uk/Line/*/Status | API key (query param, optional) | Line status (JSON) |
api.tfl.gov.uk/StopPoint/*/Arrivals | API key (query param, optional) | Arrivals (JSON) |
api.tfl.gov.uk/StopPoint/Search/* | API key (query param, optional) | Stop search results (JSON) |
api.tfl.gov.uk/StopPoint?lat=&lon= | API key (query param, optional) | Nearby stops (JSON) |
api.tfl.gov.uk/Line/*/StopPoints | API key (query param, optional) | Stops on line (JSON) |
api.tfl.gov.uk/Line/*/Route/Sequence/* | API key (query param, optional) | Route sequence (JSON) |
api.tfl.gov.uk/Line/*/Disruption | API key (query param, optional) | Disruptions (JSON) |
api.tfl.gov.uk/Journey/JourneyResults/* | API key (query param, optional) | Journey results (JSON) |
api.tfl.gov.uk/Line/Mode/bus | API key (query param, optional) | Bus routes (JSON) |
API key is passed as a query parameter to TfL's official API. No other user data is transmitted.
This skill reads publicly available transit data from TfL's official Unified API. The optional API key is used only for TfL API rate-limit authentication. The skill does not access, store, or transmit any personal information beyond the API key configured by the user.