{
 "openapi": "3.1.0",
 "info": {
  "title": "London cycle hire docks (TfL Santander Cycles): data.promptugal.news",
  "version": "v0.1.151",
  "description": "Every Santander Cycles dock in London with its bikes, e-bikes and empty docks, and London's totals.\n\nPublisher: Transport for London (TfL), Unified API. 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. Not a warning service: follow IPMA and ANEPC.\n\nCode: Apache-2.0. Text: CC BY 4.0. The data keeps the terms of its own source (see each source card); nothing here relaxes them.",
  "license": {
   "name": "Apache-2.0 for code; each source keeps its own data terms",
   "identifier": "Apache-2.0"
  },
  "contact": {
   "name": "PrompTugal.news data",
   "url": "https://github.com/PrompTugal/PrompTugal__News__Data"
  }
 },
 "servers": [
  {
   "url": "https://data.promptugal.news",
   "description": "Production"
  }
 ],
 "externalDocs": {
  "description": "How to use the API",
  "url": "https://data.promptugal.news/api/"
 },
 "paths": {
  "/api/v1/tfl-bikepoint/latest.json": {
   "get": {
    "operationId": "get_tfl_bikepoint_latest",
    "tags": [
     "tfl-bikepoint"
    ],
    "summary": "London cycle hire docks (TfL Santander Cycles): the latest read",
    "description": "Every Santander Cycles dock in London, with its bikes, e-bikes and empty docks as Transport for London published them at the read, and London's totals. Collected once a day as the archive; the page shows the live figures read in your browser from TfL.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "api": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "api"
           ]
          },
          "country": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "live": {
           "type": "object",
           "properties": {
            "url": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "url",
            "how"
           ]
          },
          "attribution": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "docks_listed": {
             "type": "integer"
            },
            "in_service": {
             "type": "integer"
            },
            "bikes": {
             "type": "integer"
            },
            "standard": {
             "type": "integer"
            },
            "ebikes": {
             "type": "integer"
            },
            "empty_docks": {
             "type": "integer"
            },
            "dock_spaces": {
             "type": "integer"
            },
            "dropped": {
             "type": "integer"
            }
           },
           "required": [
            "docks_listed",
            "in_service",
            "bikes",
            "standard",
            "ebikes",
            "empty_docks",
            "dock_spaces",
            "dropped"
           ]
          },
          "docks": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "lat": {
              "type": "number"
             },
             "lon": {
              "type": "number"
             },
             "bikes": {
              "type": "integer"
             },
             "standard": {
              "type": "integer"
             },
             "ebikes": {
              "type": "integer"
             },
             "empty": {
              "type": "integer"
             },
             "docks": {
              "type": "integer"
             },
             "installed": {
              "type": "boolean"
             },
             "locked": {
              "type": "boolean"
             }
            },
            "required": [
             "id",
             "name",
             "lat",
             "lon",
             "bikes",
             "standard",
             "ebikes",
             "empty",
             "docks",
             "installed",
             "locked"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "country",
          "place",
          "about",
          "live",
          "attribution",
          "counts",
          "docks"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "tfl-bikepoint",
           "title": "London cycle hire docks (TfL Santander Cycles)",
           "read_at": "2026-11-21T09:20:34Z",
           "provenance": {
            "source": "https://api.tfl.gov.uk/",
            "page": "https://api-portal.tfl.gov.uk/",
            "read_at": "2026-11-21T09:20:34Z",
            "by": "sources/tfl-bikepoint/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "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 im...",
            "api": "https://api.tfl.gov.uk/BikePoint"
           },
           "country": "GB",
           "place": "london",
           "about": "Every Santander Cycles dock in London, with its bikes, e-bikes and empty docks as Transport for London published them at the read, and London's totals. Collected once a day as the archive; the page shows the live figures read in your browser from TfL.",
           "live": {
            "url": "https://api.tfl.gov.uk/BikePoint",
            "how": "the page asks TfL for this address when it opens; TfL allows browser reads (CORS *)"
           },
           "attribution": "Powered by TfL Open Data",
           "counts": {
            "docks_listed": 800,
            "in_service": 799,
            "bikes": 8823,
            "standard": 7970,
            "ebikes": 853,
            "empty_docks": 10687,
            "dock_spaces": 21002,
            "dropped": 0
           },
           "docks": [
            {
             "id": "BikePoints_1",
             "name": "River Street , Clerkenwell",
             "lat": 51.52916,
             "lon": -0.10997,
             "bikes": 2,
             "standard": 0,
             "ebikes": 2,
             "empty": 14,
             "docks": 19,
             "installed": true,
             "locked": false
            },
            {
             "id": "BikePoints_2",
             "name": "Phillimore Gardens, Kensington",
             "lat": 51.49961,
             "lon": -0.19757,
             "bikes": 15,
             "standard": 14,
             "ebikes": 1,
             "empty": 22,
             "docks": 37,
             "installed": true,
             "locked": false
            },
            {
             "id": "BikePoints_3",
             "name": "Christopher Street, Liverpool Street",
             "lat": 51.52128,
             "lon": -0.0846,
             "bikes": 4,
             "standard": 3,
             "ebikes": 1,
             "empty": 26,
             "docks": 32,
             "installed": true,
             "locked": false
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/tfl-bikepoint/reads.json": {
   "get": {
    "operationId": "get_tfl_bikepoint_reads",
    "tags": [
     "tfl-bikepoint"
    ],
    "summary": "London cycle hire docks (TfL Santander Cycles): every read, newest first",
    "description": "Every run of sources/tfl-bikepoint/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "runs": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string"
             },
             "finished": {
              "type": "string"
             },
             "ok": {
              "type": "integer"
             },
             "failed": {
              "type": "integer"
             },
             "reads": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "url": {
                 "type": "string"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": "string"
                }
               },
               "required": [
                "name",
                "url",
                "at",
                "status",
                "bytes",
                "sha256_prefix",
                "changed"
               ]
              }
             }
            },
            "required": [
             "at",
             "finished",
             "ok",
             "failed",
             "reads"
            ]
           }
          }
         },
         "required": [
          "about",
          "source",
          "runs"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "about": "Every run of sources/tfl-bikepoint/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
           "source": "tfl-bikepoint",
           "runs": [
            {
             "at": "2026-11-21T09:20:34Z",
             "finished": "2026-11-21T09:20:35Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "bikepoint",
               "url": "https://api.tfl.gov.uk/BikePoint",
               "at": "2026-11-21T09:20:34Z",
               "status": 200,
               "bytes": 2173228,
               "sha256_prefix": "94160d4a9548ae29",
               "changed": "first read"
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/tfl-bikepoint/card.json": {
   "get": {
    "operationId": "get_tfl_bikepoint_card",
    "tags": [
     "tfl-bikepoint"
    ],
    "summary": "London cycle hire docks (TfL Santander Cycles): the card",
    "description": "Who publishes the source, its reuse terms, the schedule, who owns it, what runs by code, by agents and by people, and the vault.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "what": {
           "type": "string"
          },
          "publisher": {
           "type": "string"
          },
          "owner": {
           "type": "string"
          },
          "region": {
           "type": "string"
          },
          "collector": {
           "type": "string"
          },
          "source_home": {
           "type": "string"
          },
          "reader_page": {
           "type": "string"
          },
          "schedule": {
           "type": "object",
           "properties": {
            "cadence": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "cadence",
            "how"
           ]
          },
          "terms": {
           "type": "object",
           "properties": {
            "summary": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "quote": {
             "type": "string"
            },
            "quote_lang": {
             "type": "string"
            },
            "republish": {
             "type": "string"
            },
            "commercial_use": {
             "type": "string"
            },
            "read_by": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "republish",
            "commercial_use",
            "read_by"
           ]
          },
          "api": {
           "type": "object",
           "properties": {
            "latest": {
             "type": "string"
            },
            "reads": {
             "type": "string"
            },
            "card": {
             "type": "string"
            },
            "openapi": {
             "type": "string"
            },
            "page": {
             "type": "string"
            }
           },
           "required": [
            "latest",
            "reads",
            "card",
            "openapi",
            "page"
           ]
          },
          "vault": {
           "type": "null"
          },
          "split": {
           "type": "object",
           "properties": {
            "code": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "agents": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "people": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "code",
            "agents",
            "people"
           ]
          },
          "cost": {
           "type": "object",
           "properties": {
            "per_run_tokens": {
             "type": "integer"
            },
            "per_run_model_cost_usd": {
             "type": "integer"
            },
            "runner": {
             "type": "string"
            },
            "build_tokens": {
             "type": "string"
            },
            "note": {
             "type": "string"
            }
           },
           "required": [
            "per_run_tokens",
            "per_run_model_cost_usd",
            "runner",
            "build_tokens",
            "note"
           ]
          },
          "since": {
           "type": "string"
          },
          "places": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "country": {
           "type": "string"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "region",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since",
          "places",
          "country"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "tfl-bikepoint",
           "title": "London cycle hire docks (TfL Santander Cycles)",
           "what": "Every Santander Cycles dock in London with its bikes, e-bikes and empty docks, and London's totals.",
           "publisher": "Transport for London (TfL), Unified API",
           "owner": "data.b@PrompTugal.dinis",
           "region": "london",
           "collector": "sources/tfl-bikepoint/collect.mjs",
           "source_home": "https://api.tfl.gov.uk/",
           "reader_page": "https://api-portal.tfl.gov.uk/",
           "schedule": {
            "cadence": "daily",
            "how": "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"
           },
           "terms": {
            "summary": "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 im...",
            "page": "https://tfl.gov.uk/corporate/terms-and-conditions/transport-data-service",
            "read_at": "2026-11-18",
            "quote": "You are free to: Copy, publish, distribute and transmit the Information; Adapt the Information and Exploit the Information commercially and non-commercially",
            "quote_lang": "en",
            "republish": "yes, with the credit \"Powered by TfL Open Data\"; commercial use allowed",
            "commercial_use": "allowed",
            "read_by": "Dinis Cruz (pasted into data.b@'s session; board/team/data/briefs/2026-11-18-dinis-commercial-line-ine-tfl.md)"
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/tfl-bikepoint/latest.json",
            "reads": "https://data.promptugal.news/api/v1/tfl-bikepoint/reads.json",
            "card": "https://data.promptugal.news/api/v1/tfl-bikepoint/card.json",
            "openapi": "https://data.promptugal.news/api/v1/tfl-bikepoint/openapi.json",
            "page": "https://data.promptugal.news/sources/tfl-bikepoint/"
           },
           "vault": null,
           "split": {
            "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": {
            "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."
           },
           "since": "2026-11-21",
           "places": [
            "london"
           ],
           "country": "GB"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/tfl-bikepoint/openapi.json": {
   "get": {
    "operationId": "get_tfl_bikepoint_openapi",
    "tags": [
     "tfl-bikepoint"
    ],
    "summary": "London cycle hire docks (TfL Santander Cycles): this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "tfl-bikepoint",
   "description": "Every Santander Cycles dock in London with its bikes, e-bikes and empty docks, and London's totals."
  }
 ],
 "x-source": {
  "id": "tfl-bikepoint",
  "card": "https://data.promptugal.news/api/v1/tfl-bikepoint/card.json",
  "page": "https://data.promptugal.news/sources/tfl-bikepoint/"
 }
}
