# Transport for London API: Get line status

> Gets the current or future-day service status for London Tube, Elizabeth line, DLR, Overground, tram or a named bus route. Multiple notices on one line are combined into the most disruptive status.

Unofficial. Not affiliated with or endorsed by Transport for London.

- Page: https://fous.com/methods/tfl.gov.uk/get-line-status
- Method: `tfl.gov.uk/get_line_status`, version 1
- Website: tfl.gov.uk
- Returns: line name, type, status, reason, valid from/to, line id, severity number
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no |  | Future service date in YYYY-MM-DD, such as 2026-10-03. Omit for the current live status. Must be today or later. |
| `line` | string | no |  | Line name or bus route number, such as Northern, Elizabeth line, Mildmay, Overground or 73. Omit for all rail and tram lines. Default "". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "lines": [
    {
      "type": "Tube",
      "reason": null,
      "status": "Good service",
      "line_id": "bakerloo",
      "valid_to": null,
      "line_name": "Bakerloo",
      "page_link": "https://tfl.gov.uk/tube-bus-river/status/",
      "valid_from": null,
      "severity_number": 10
    },
    {
      "type": "Tube",
      "reason": "Central Line: Minor delays due to an earlier faulty train at Perivale and following a late finish of engineering work.",
      "status": "Minor delays",
      "line_id": "central",
      "valid_to": "2026-10-24T01:29:00+01:00",
      "line_name": "Central",
      "page_link": "https://tfl.gov.uk/tube-bus-river/status/",
      "valid_from": "2026-10-23T07:42:07+01:00",
      "severity_number": 9
    },
    {
      "type": "Tube",
      "reason": "Circle Line: Minor delays due to an earlier faulty train at Euston Square.",
      "status": "Minor delays",
      "line_id": "circle",
      "valid_to": "2026-10-24T01:29:00+01:00",
      "line_name": "Circle",
      "page_link": "https://tfl.gov.uk/tube-bus-river/status/",
      "valid_from": "2026-10-23T09:08:25+01:00",
      "severity_number": 9
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"tfl.gov.uk/get_line_status","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Is the Northern line running normally right now?
- What's the service status for the Elizabeth line on 2026-10-03?
- Any delays on bus route 73 today?
- Check whether the DLR has part-suspended service this evening.
- Are there planned closures on the Overground for 2026-11-14 on tfl.gov.uk?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10,
      "minLength": 10,
      "description": "Future service date in YYYY-MM-DD, such as 2026-10-03. Omit for the current live status. Must be today or later."
    },
    "line": {
      "type": "string",
      "default": "",
      "description": "Line name or bus route number, such as Northern, Elizabeth line, Mildmay, Overground or 73. Omit for all rail and tram lines."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "lines"
  ],
  "properties": {
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "line_name",
          "type",
          "status",
          "reason",
          "valid_from",
          "valid_to",
          "page_link",
          "line_id",
          "severity_number"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "Transport type."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Explanation when service is not good, or null."
          },
          "status": {
            "type": "string",
            "description": "Service status in words."
          },
          "line_id": {
            "type": "string",
            "description": "TfL line identifier.",
            "x-fous-developer": true
          },
          "valid_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "End of the reported status in London local time, or null."
          },
          "line_name": {
            "type": "string",
            "description": "Line or bus route name."
          },
          "page_link": {
            "type": "string",
            "description": "TfL service status page for this line."
          },
          "valid_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Beginning of the reported status in London local time, or null."
          },
          "severity_number": {
            "type": "integer",
            "description": "TfL status severity number.",
            "x-fous-developer": true
          }
        },
        "additionalProperties": false
      },
      "description": "Service status in TfL line order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Transport for London API: Plan a London journey](https://fous.com/methods/tfl.gov.uk/plan-journey.md): Plans a London public transport journey between two places, stations, addresses or postcodes with the TfL Journey Planner, leaving or arriving at a given time. Returns journey options in TfL order with leg directions and an adult pay-as-you-go fare when available.
- [MTA API: Get service status](https://fous.com/methods/mta.info/get-service-status.md): Gets current MTA line statuses and active alerts for subway, bus, Long Island Rail Road, or Metro-North lines, optionally for one line. Bus and rail status reflects published alerts; no alert means Good service.
- [Flightradar24 API: Check flight status](https://fous.com/methods/flightradar24.com/check-flight-status.md): Checks a flight's public status and times on Flightradar24 by flight number and the departure date at the origin airport.
- [FlightAware API: Check flight status](https://fous.com/methods/flightaware.com/check-flight-status.md): Checks the public FlightAware status of an airline flight (airline name or code plus number) on a departure date, by default today at the departure airport: airports, scheduled, estimated and actual gate times in local time, delays, gates, terminals, aircraft and distance. A date older than FlightAware's public two-week list is looked up on the flight's history page when FlightAware still shows it.
- [Atlassian API: Get service status](https://fous.com/methods/atlassian.com/get-service-status.md): Gets the official overall status, components, active incidents and scheduled maintenance for a service from its Atlassian Statuspage summary feed.
- [Downdetector API: Check service status](https://fous.com/methods/downdetector.com/check-service-status.md): Checks whether an app or website has current problems in a country on Downdetector: its status, reports in the latest 15-minute interval, the usual report count, the most reported problem types and the most affected locations when shown. The service must have a public Downdetector page in that country.
- [FlixBus API: Search bus trips](https://fous.com/methods/flixbus.com/search-bus-trips.md): Finds dated FlixBus trip options between two cities, with stops, local times, availability and displayed per-person prices, including partner operators on some routes.
- [TVmaze API: Get TV schedule](https://fous.com/methods/tvmaze.com/get-tv-schedule.md): Gets the TV broadcasts scheduled in a country for a date from TVmaze. It can also add local and worldwide streaming releases. Airtimes are shown in the service's timezone, or in UTC when the service has none.
- [All Transport for London methods](https://fous.com/methods/tfl.gov.uk.md)
