# London cycle hire docks (TfL Santander Cycles)

Every Santander Cycles dock in London with its bikes, e-bikes and empty docks, and London's totals.

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/BikePoint (about 2.2 MB), no key; the page reads it live in the browser |
| Owner | data.b@PrompTugal.dinis |
| Collector | [sources/tfl-bikepoint/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/tfl-bikepoint/collect.mjs) |
| Since | 2026-11-21 |
| Last read | 2026-11-21 09:20 UTC |
| Last run | ok: 1 requests ok, 0 failed |
| Now | 800 docks listed |
| 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 BikePoint list (about 2.2 MB), kept in the vault copy: [the address](https://api.tfl.gov.uk/BikePoint).

## 3. The processed data

The collector reads TfL's dock list once a day and keeps each dock's name, position, bikes, e-bikes, empty docks and whether it is in service, with London's totals. Powered by TfL Open Data. The result: [latest.json](/api/v1/tfl-bikepoint/latest.json).

Every dock with its bikes, e-bikes and empty docks at the read. The live totals are on [London, live](/london/). The data: [/api/v1/tfl-bikepoint/latest.json](/api/v1/tfl-bikepoint/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-bikepoint/latest.json](https://data.promptugal.news/api/v1/tfl-bikepoint/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/tfl-bikepoint/reads.json](https://data.promptugal.news/api/v1/tfl-bikepoint/reads.json) |
| Card | [https://data.promptugal.news/api/v1/tfl-bikepoint/card.json](https://data.promptugal.news/api/v1/tfl-bikepoint/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/tfl-bikepoint/openapi.json](https://data.promptugal.news/api/v1/tfl-bikepoint/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/tfl-bikepoint/latest.json
curl -s https://data.promptugal.news/api/v1/tfl-bikepoint/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-bikepoint/reads.json).

## Preview of the values

The first 5 of 800 entries in `docks`, 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 | name | lat | lon | bikes | standard | Source |
|---|---|---|---|---|---|---|
| BikePoints_1 | River Street , Clerkenwell | 51.52916 | -0.10997 | 2 | 0 | [source](https://api.tfl.gov.uk/) |
| BikePoints_2 | Phillimore Gardens, Kensington | 51.49961 | -0.19757 | 15 | 14 | [source](https://api.tfl.gov.uk/) |
| BikePoints_3 | Christopher Street, Liverpool Street | 51.52128 | -0.0846 | 4 | 3 | [source](https://api.tfl.gov.uk/) |
| BikePoints_4 | St. Chad's Street, King's Cross | 51.53006 | -0.12097 | 22 | 21 | [source](https://api.tfl.gov.uk/) |
| BikePoints_5 | Sedding Street, Sloane Square | 51.49313 | -0.15688 | 8 | 7 | [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-bikepoint/
