# London road disruptions (TfL)

Works, incidents and closures on London's roads as TfL lists them: severity, category, place, TfL's description and the period.

Three layers: **the source** (who publishes it, the terms, when it was read), **the raw data** as the publisher served it, and **the processed data**, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.

## 1. The source

## At a glance

| Field | Value |
|---|---|
| Publisher | Transport for London (TfL), Unified API |
| Source | [https://api.tfl.gov.uk/](https://api.tfl.gov.uk/) |
| Reader page | [https://api-portal.tfl.gov.uk/](https://api-portal.tfl.gov.uk/) |
| Schedule | daily: once a day at data.b@'s morning wake: one GET of api.tfl.gov.uk/Road/all/Disruption, no key; the page reads it live in the browser |
| Owner | data.b@PrompTugal.dinis |
| Collector | [sources/tfl-road-disruptions/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/tfl-road-disruptions/collect.mjs) |
| Since | 2026-11-21 |
| Last read | 2026-11-21 09:20 UTC |
| Last run | ok: 1 requests ok, 0 failed |
| Now | 112 disruptions |
| Licence | The data: [TfL Transport Data Service terms (OGL v2.0 based)](https://tfl.gov.uk/corporate/terms-and-conditions/transport-data-service) (Transport for London). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

TfL's Transport Data Service terms (based on the Open Government Licence v2.0 with TfL amendments): free to copy, publish, distribute, transmit and adapt the information and to exploit it commercially and non-commercially; credit "Powered by TfL Open Data"; at most 500 calls a minute per feed; no implied endorsement. Reuse: yes, with the credit "Powered by TfL Open Data"; commercial use allowed.

> You are free to: Copy, publish, distribute and transmit the Information; Adapt the Information and Exploit the Information commercially and non-commercially
>
> The publisher's words (en), from [https://tfl.gov.uk/corporate/terms-and-conditions/transport-data-service](https://tfl.gov.uk/corporate/terms-and-conditions/transport-data-service), read on 2026-11-18.

## 2. The raw data

The raw answer is TfL's road disruption list (about 250 KB), kept in the vault copy: [the address](https://api.tfl.gov.uk/Road/all/Disruption).

## 3. The processed data

The collector reads TfL's road disruptions once a day and keeps each one's id, severity, category, place, description, period and position; a field our wording check refuses is dropped and counted. Powered by TfL Open Data. The result: [latest.json](/api/v1/tfl-road-disruptions/latest.json).

Each disruption with its severity, category, place and period at the read. The live list is on [London, live](/london/). The data: [/api/v1/tfl-road-disruptions/latest.json](/api/v1/tfl-road-disruptions/latest.json).

## More about this source

## What runs by code, by agents and by people

### Code

- the collector reads the source once a day and keeps the archive; the page reads the live figures in the visitor's browser

### Agents

- data.b@PrompTugal.dinis wrote the collector and card on 21 November 2026, for Dinis's London demos (tier 1 of board/team/data/london-feeds.md)

### People

- Dinis Cruz chose tier 1 on 21 November 2026, about 09:16 UTC; no person has checked the values (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | data.b@'s session |
| build tokens | not measured |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/tfl-road-disruptions/latest.json](https://data.promptugal.news/api/v1/tfl-road-disruptions/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/tfl-road-disruptions/reads.json](https://data.promptugal.news/api/v1/tfl-road-disruptions/reads.json) |
| Card | [https://data.promptugal.news/api/v1/tfl-road-disruptions/card.json](https://data.promptugal.news/api/v1/tfl-road-disruptions/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/tfl-road-disruptions/openapi.json](https://data.promptugal.news/api/v1/tfl-road-disruptions/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/tfl-road-disruptions/latest.json
curl -s https://data.promptugal.news/api/v1/tfl-road-disruptions/reads.json | head -c 600
```

## Vault

Vault not yet created. The collector writes the bytes of each read to a vault copy; until the vault exists they are not kept.

## Last runs

| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-21 09:20 UTC | 1 | 0 | 1 of 1 |

Showing 1 of 1 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/tfl-road-disruptions/reads.json).

## Preview of the values

The first 5 of 112 entries in `disruptions`, as read 2026-11-21 09:20 UTC. Source: [https://api.tfl.gov.uk/](https://api.tfl.gov.uk/). Long values are shortened here; the file has them whole.

| id | severity | category | sub_category | status | level_of_interest | Source |
|---|---|---|---|---|---|---|
| TIMS-224034 | Minimal | Works | Borough works | Active | Medium | [source](https://api.tfl.gov.uk/) |
| TIMS-238466 | Minimal | Emergency service incidents | Police activity | Active | Medium | [source](https://api.tfl.gov.uk/) |
| TIMS-238465 | Moderate | Works | Construction activity | Active | High | [source](https://api.tfl.gov.uk/) |
| TIMS-237961 | Minimal | Works | Utility works | Active | Low | [source](https://api.tfl.gov.uk/) |
| TIMS-238443 | Minimal | Works | Collaborative works | Active | Low | [source](https://api.tfl.gov.uk/) |

---

Version v0.1.151 · data read 2026-11-21 09:20 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/tfl-road-disruptions/
