{
 "openapi": "3.1.0",
 "info": {
  "title": "London flood warnings and Thames levels (Environment Agency): data.promptugal.news",
  "version": "v0.1.151",
  "description": "Flood warnings and alerts in force around London, and the latest water or tidal level at the Thames stations in London, and the nearest ten rainfall gauges (latest 15-minute total and rain per UTC day, 14 days kept), from the Environment Agency's real-time flood-monitoring API. Each warning with its severity, area and times; each station with its latest readings. Not a warning service.\n\nPublisher: Environment Agency (England). Reuse terms: Open Government Licence v3.0, no registration; acknowledge with: \"this uses Environment Agency flood and river level data from the real-time data API (Beta)\". Not reviewed by a person. 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/ea-flood/latest.json": {
   "get": {
    "operationId": "get_ea_flood_latest",
    "tags": [
     "ea-flood"
    ],
    "summary": "London flood warnings and Thames levels (Environment Agency): the latest read",
    "description": "Flood warnings and alerts the Environment Agency has in force within 30 km of London, and the latest water or tidal level at each Thames station within 15 km, as read. Not a warning service: follow the Environment Agency (check-for-flooding.service.gov.uk).",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "country": {
           "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"
            },
            "attribution": {
             "type": "string"
            },
            "licence": {
             "type": "string"
            },
            "centre": {
             "type": "object",
             "properties": {
              "lat": {
               "type": "number"
              },
              "lon": {
               "type": "number"
              }
             },
             "required": [
              "lat",
              "lon"
             ]
            },
            "warnings_radius_km": {
             "type": "integer"
            },
            "stations_radius_km": {
             "type": "integer"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "attribution",
            "licence",
            "centre",
            "warnings_radius_km",
            "stations_radius_km"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "warnings": {
             "type": "integer"
            },
            "by_severity": {
             "type": "object",
             "properties": {}
            },
            "stations": {
             "type": "integer"
            },
            "readings": {
             "type": "integer"
            },
            "rain_gauges": {
             "type": "integer"
            },
            "rain_gauges_with_readings": {
             "type": "integer"
            },
            "rain_readings_counted": {
             "type": "integer"
            },
            "rain_gauges_failed": {
             "type": "integer"
            },
            "rain_days_kept": {
             "type": "integer"
            },
            "rain_requests": {
             "type": "integer"
            },
            "fields_dropped_em_dash": {
             "type": "integer"
            }
           },
           "required": [
            "warnings",
            "by_severity",
            "stations",
            "readings",
            "rain_gauges",
            "rain_gauges_with_readings",
            "rain_readings_counted",
            "rain_gauges_failed",
            "rain_days_kept",
            "rain_requests",
            "fields_dropped_em_dash"
           ]
          },
          "warnings": {
           "type": "array"
          },
          "stations": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "river": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "lat": {
              "type": "number"
             },
             "long": {
              "type": "number"
             },
             "readings": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "qualifier": {
                 "type": "string"
                },
                "unit": {
                 "type": [
                  "string",
                  "null"
                 ]
                },
                "value": {
                 "type": "number"
                },
                "time": {
                 "type": "string"
                }
               },
               "required": [
                "qualifier",
                "unit",
                "value",
                "time"
               ]
              }
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "api": {
              "type": "string",
              "format": "uri"
             }
            },
            "required": [
             "id",
             "label",
             "river",
             "town",
             "lat",
             "long",
             "readings",
             "url",
             "api"
            ]
           }
          },
          "rain_gauges": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "lat": {
              "type": "number"
             },
             "long": {
              "type": "number"
             },
             "rain_mm": {
              "type": [
               "integer",
               "null"
              ]
             },
             "period_s": {
              "type": "integer"
             },
             "time": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "id",
             "label",
             "lat",
             "long",
             "rain_mm",
             "period_s",
             "time"
            ]
           }
          },
          "daily_rain": {
           "type": "object",
           "properties": {
            "2026-11-17": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "245176TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "288092TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287946TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "380002TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "239374TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287864TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            },
            "2026-11-18": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "245176TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "288092TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287946TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "380002TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "239374TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287864TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            },
            "2026-11-19": {
             "type": "object",
             "properties": {
              "245176TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "288092TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287946TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "380002TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287864TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "246424TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "239374TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              }
             },
             "required": [
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "287864TP",
              "246424TP",
              "239374TP"
             ]
            },
            "2026-11-20": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "245176TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "288092TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287946TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "380002TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "number"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "239374TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287864TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            },
            "2026-11-21": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "245176TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "288092TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287946TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "380002TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "239374TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              },
              "287864TP": {
               "type": "object",
               "properties": {
                "rain_mm": {
                 "type": "integer"
                },
                "readings": {
                 "type": "integer"
                }
               },
               "required": [
                "rain_mm",
                "readings"
               ]
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            }
           },
           "required": [
            "2026-11-17",
            "2026-11-18",
            "2026-11-19",
            "2026-11-20",
            "2026-11-21"
           ]
          },
          "rain_seen": {
           "type": "object",
           "properties": {
            "2026-11-20": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "245176TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "288092TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "287946TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "380002TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "239374TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "287864TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            },
            "2026-11-21": {
             "type": "object",
             "properties": {
              "246424TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "245176TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "288092TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "287946TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "380002TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "239374TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "287864TP": {
               "type": "array",
               "items": {
                "type": "string"
               }
              }
             },
             "required": [
              "246424TP",
              "245176TP",
              "288092TP",
              "287946TP",
              "380002TP",
              "239374TP",
              "287864TP"
             ]
            }
           },
           "required": [
            "2026-11-20",
            "2026-11-21"
           ]
          },
          "rain_note": {
           "type": "string"
          }
         },
         "required": [
          "source",
          "title",
          "place",
          "country",
          "read_at",
          "provenance",
          "about",
          "counts",
          "warnings",
          "stations",
          "rain_gauges",
          "daily_rain",
          "rain_seen",
          "rain_note"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "ea-flood",
           "title": "London flood warnings and Thames levels (Environment Agency)",
           "place": "london",
           "country": "GB",
           "read_at": "2026-11-21T07:04:44Z",
           "provenance": {
            "source": "https://environment.data.gov.uk/flood-monitoring/doc/reference",
            "page": "https://check-for-flooding.service.gov.uk/",
            "read_at": "2026-11-21T07:04:44Z",
            "by": "sources/ea-flood/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "Open Government Licence v3.0, no registration; acknowledge with: \"this uses Environment Agency flood and river level data from the real-time data API (Beta)\". Not reviewed by a person.",
            "attribution": "this uses Environment Agency flood and river level data from the real-time data API (Beta)",
            "licence": "Open Government Licence v3.0 (http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/)",
            "centre": {
             "lat": 51.5074,
             "lon": -0.1278
            },
            "warnings_radius_km": 30,
            "stations_radius_km": 15
           },
           "about": "Flood warnings and alerts the Environment Agency has in force within 30 km of London, and the latest water or tidal level at each Thames station within 15 km, as read. Not a warning service: follow the Environment Agency (check-for-flooding.service.gov.uk).",
           "counts": {
            "warnings": 0,
            "by_severity": {},
            "stations": 10,
            "readings": 11,
            "rain_gauges": 10,
            "rain_gauges_with_readings": 7,
            "rain_readings_counted": 364,
            "rain_gauges_failed": 0,
            "rain_days_kept": 5,
            "rain_requests": 11,
            "fields_dropped_em_dash": 0
           },
           "warnings": [],
           "stations": [
            {
             "id": "0001",
             "label": "Silvertown",
             "river": "Thames Tideway",
             "town": "Silvertown",
             "lat": 51.4975,
             "long": 0.05262,
             "readings": [
              {
               "qualifier": "tidal_level",
               "unit": "mAOD",
               "value": 0.47,
               "time": "2026-11-21T06:30:00Z"
              }
             ],
             "url": "https://check-for-flooding.service.gov.uk/station/7388",
             "api": "https://environment.data.gov.uk/flood-monitoring/id/stations/0001"
            },
            {
             "id": "0003",
             "label": "Charlton",
             "river": "Thames Tideway",
             "town": "Charlton",
             "lat": 51.49695,
             "long": 0.02043,
             "readings": [
              {
               "qualifier": "tidal_level",
               "unit": "mAOD",
               "value": 0.766,
               "time": "2026-11-21T06:45:00Z"
              }
             ],
             "url": "https://check-for-flooding.service.gov.uk/station/7390",
             "api": "https://environment.data.gov.uk/flood-monitoring/id/stations/0003"
            },
            {
             "id": "0006",
             "label": "Westminster",
             "river": "Thames Tideway",
             "town": "Westminster",
             "lat": 51.50122,
             "long": -0.12385,
             "readings": [
              {
               "qualifier": "tidal_level",
               "unit": "mAOD",
               "value": 0.222,
               "time": "2026-11-21T06:45:00Z"
              }
             ],
             "url": "https://check-for-flooding.service.gov.uk/station/7389",
             "api": "https://environment.data.gov.uk/flood-monitoring/id/stations/0006"
            }
           ],
           "rain_gauges": [
            {
             "id": "246424TP",
             "label": "Rainfall station 246424TP",
             "lat": 51.50115,
             "long": -0.20555,
             "rain_mm": 0,
             "period_s": 900,
             "time": "2026-11-21T06:15:00Z"
            },
            {
             "id": "289102TP",
             "label": "Rainfall station 289102TP",
             "lat": 51.47654,
             "long": -0.01787,
             "rain_mm": null,
             "period_s": 900,
             "time": null
            },
            {
             "id": "245176TP",
             "label": "Rainfall station 245176TP",
             "lat": 51.58871,
             "long": -0.1126,
             "rain_mm": 0,
             "period_s": 900,
             "time": "2026-11-21T06:45:00Z"
            }
           ],
           "daily_rain": {
            "2026-11-17": {
             "246424TP": {
              "rain_mm": 23.6,
              "readings": 95
             },
             "245176TP": {
              "rain_mm": 12.8,
              "readings": 95
             },
             "288092TP": {
              "rain_mm": 10.1,
              "readings": 95
             },
             "287946TP": {
              "rain_mm": 8.6,
              "readings": 95
             },
             "380002TP": {
              "rain_mm": 13.4,
              "readings": 95
             },
             "239374TP": {
              "rain_mm": 13.6,
              "readings": 95
             },
             "287864TP": {
              "rain_mm": 10,
              "readings": 95
             }
            },
            "2026-11-18": {
             "246424TP": {
              "rain_mm": 5.2,
              "readings": 96
             },
             "245176TP": {
              "rain_mm": 10.8,
              "readings": 96
             },
             "288092TP": {
              "rain_mm": 5.6,
              "readings": 96
             },
             "287946TP": {
              "rain_mm": 5.2,
              "readings": 96
             },
             "380002TP": {
              "rain_mm": 8.4,
              "readings": 96
             },
             "239374TP": {
              "rain_mm": 8.6,
              "readings": 96
             },
             "287864TP": {
              "rain_mm": 5.5,
              "readings": 96
             }
            },
            "2026-11-19": {
             "245176TP": {
              "rain_mm": 4,
              "readings": 95
             },
             "288092TP": {
              "rain_mm": 2.3,
              "readings": 95
             },
             "287946TP": {
              "rain_mm": 2.3,
              "readings": 95
             },
             "380002TP": {
              "rain_mm": 4.4,
              "readings": 94
             },
             "287864TP": {
              "rain_mm": 2,
              "readings": 95
             },
             "246424TP": {
              "rain_mm": 3,
              "readings": 94
             },
             "239374TP": {
              "rain_mm": 2.4,
              "readings": 94
             }
            },
            "2026-11-20": {
             "246424TP": {
              "rain_mm": 0,
              "readings": 96
             },
             "245176TP": {
              "rain_mm": 0,
              "readings": 96
             },
             "288092TP": {
              "rain_mm": 0,
              "readings": 96
             },
             "287946TP": {
              "rain_mm": 0,
              "readings": 96
             },
             "380002TP": {
              "rain_mm": 0.2,
              "readings": 96
             },
             "239374TP": {
              "rain_mm": 0,
              "readings": 96
             },
             "287864TP": {
              "rain_mm": 0,
              "readings": 96
             }
            },
            "2026-11-21": {
             "246424TP": {
              "rain_mm": 0,
              "readings": 26
             },
             "245176TP": {
              "rain_mm": 0,
              "readings": 28
             },
             "288092TP": {
              "rain_mm": 0,
              "readings": 28
             },
             "287946TP": {
              "rain_mm": 0,
              "readings": 28
             },
             "380002TP": {
              "rain_mm": 0,
              "readings": 27
             },
             "239374TP": {
              "rain_mm": 0,
              "readings": 26
             },
             "287864TP": {
              "rain_mm": 0,
              "readings": 28
             }
            }
           },
           "rain_seen": {
            "2026-11-20": {
             "246424TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "245176TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "288092TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "287946TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "380002TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "239374TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "287864TP": [
              "00:00",
              "00:15",
              "00:30"
             ]
            },
            "2026-11-21": {
             "246424TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "245176TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "288092TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "287946TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "380002TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "239374TP": [
              "00:00",
              "00:15",
              "00:30"
             ],
             "287864TP": [
              "00:00",
              "00:15",
              "00:30"
             ]
            }
           },
           "rain_note": "rain_mm is each gauge's latest 15-minute total (mm) as served; daily_rain sums those totals per UTC day for the readings we have seen, each counted once by its timestamp (readings: how many); rain_seen holds the timestamps (HH:MM UTC) of today and yesterday so a reading is never counted twice. A gau..."
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/ea-flood/reads.json": {
   "get": {
    "operationId": "get_ea_flood_reads",
    "tags": [
     "ea-flood"
    ],
    "summary": "London flood warnings and Thames levels (Environment Agency): every read, newest first",
    "description": "Every run of sources/ea-flood/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",
                 "format": "uri"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": "boolean"
                }
               },
               "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/ea-flood/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": "ea-flood",
           "runs": [
            {
             "at": "2026-11-21T07:04:44Z",
             "finished": "2026-11-21T07:06:19Z",
             "ok": 23,
             "failed": 0,
             "reads": [
              {
               "name": "floods",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/floods?lat=51.5074&long=-0.1278&dist=30",
               "at": "2026-11-21T07:04:46Z",
               "status": 200,
               "bytes": 835,
               "sha256_prefix": "4b57eeae23d652ec",
               "changed": false
              },
              {
               "name": "stations",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations?lat=51.5074&long=-0.1278&dist=15&parameter=level",
               "at": "2026-11-21T07:04:49Z",
               "status": 200,
               "bytes": 99473,
               "sha256_prefix": "ba307996b6eb224f",
               "changed": true
              },
              {
               "name": "readings-0001",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations/0001/readings?latest",
               "at": "2026-11-21T07:04:56Z",
               "status": 200,
               "bytes": 1118,
               "sha256_prefix": "bd87a8c6446706cb",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-20T18:04:54Z",
             "finished": "2026-11-20T18:06:42Z",
             "ok": 23,
             "failed": 0,
             "reads": [
              {
               "name": "floods",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/floods?lat=51.5074&long=-0.1278&dist=30",
               "at": "2026-11-20T18:04:56Z",
               "status": 200,
               "bytes": 835,
               "sha256_prefix": "4b57eeae23d652ec",
               "changed": true
              },
              {
               "name": "stations",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations?lat=51.5074&long=-0.1278&dist=15&parameter=level",
               "at": "2026-11-20T18:05:04Z",
               "status": 200,
               "bytes": 99748,
               "sha256_prefix": "5fce9b4bcac33fd5",
               "changed": false
              },
              {
               "name": "readings-0001",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations/0001/readings?latest",
               "at": "2026-11-20T18:05:12Z",
               "status": 200,
               "bytes": 1120,
               "sha256_prefix": "ed83cb265a077681",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-20T07:04:32Z",
             "finished": "2026-11-20T07:07:48Z",
             "ok": 23,
             "failed": 0,
             "reads": [
              {
               "name": "floods",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/floods?lat=51.5074&long=-0.1278&dist=30",
               "at": "2026-11-20T07:04:34Z",
               "status": 200,
               "bytes": 4039,
               "sha256_prefix": "d7ad0d958891ad3b",
               "changed": false
              },
              {
               "name": "stations",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations?lat=51.5074&long=-0.1278&dist=15&parameter=level",
               "at": "2026-11-20T07:04:37Z",
               "status": 200,
               "bytes": 99748,
               "sha256_prefix": "5fce9b4bcac33fd5",
               "changed": false
              },
              {
               "name": "readings-0001",
               "url": "https://environment.data.gov.uk/flood-monitoring/id/stations/0001/readings?latest",
               "at": "2026-11-20T07:04:39Z",
               "status": 200,
               "bytes": 1119,
               "sha256_prefix": "21ebdb1975c8e055",
               "changed": true
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/ea-flood/card.json": {
   "get": {
    "operationId": "get_ea_flood_card",
    "tags": [
     "ea-flood"
    ],
    "summary": "London flood warnings and Thames levels (Environment Agency): 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"
          },
          "country": {
           "type": "string"
          },
          "places": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "place": {
           "type": "object",
           "properties": {
            "id": {
             "type": "string"
            },
            "name": {
             "type": "string"
            },
            "lat": {
             "type": "number"
            },
            "lon": {
             "type": "number"
            },
            "dist_km_warnings": {
             "type": "integer"
            },
            "dist_km_stations": {
             "type": "integer"
            },
            "river_match": {
             "type": "string"
            },
            "max_stations": {
             "type": "integer"
            },
            "rain_dist_km": {
             "type": "integer"
            },
            "max_rain_gauges": {
             "type": "integer"
            }
           },
           "required": [
            "id",
            "name",
            "lat",
            "lon",
            "dist_km_warnings",
            "dist_km_stations",
            "river_match",
            "max_stations",
            "rain_dist_km",
            "max_rain_gauges"
           ]
          },
          "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"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "republish",
            "open_question"
           ]
          },
          "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"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "region",
          "collector",
          "country",
          "places",
          "place",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "ea-flood",
           "title": "London flood warnings and Thames levels (Environment Agency)",
           "what": "Flood warnings and alerts in force around London, and the latest water or tidal level at the Thames stations in London, and the nearest ten rainfall gauges (latest 15-minute total and rain per UTC day, 14 days kept), from the Environment Agency's real-time flood-monitoring API. Each warning with its...",
           "publisher": "Environment Agency (England)",
           "owner": "data.b@PrompTugal.dinis",
           "region": "london",
           "collector": "sources/ea-flood/collect.mjs",
           "country": "GB",
           "places": [
            "london"
           ],
           "place": {
            "id": "london",
            "name": "London",
            "lat": 51.5074,
            "lon": -0.1278,
            "dist_km_warnings": 30,
            "dist_km_stations": 15,
            "river_match": "Thames",
            "max_stations": 12,
            "rain_dist_km": 15,
            "max_rain_gauges": 10
           },
           "source_home": "https://environment.data.gov.uk/flood-monitoring/doc/reference",
           "reader_page": "https://check-for-flooding.service.gov.uk/",
           "schedule": {
            "cadence": "hourly",
            "how": "the Pages workflow (.github/workflows/pages.yml) every hour; two list requests, one request per Thames station, one list of rainfall gauges and one request per gauge (about twenty-two requests, 2.5 seconds apart, about a minute)"
           },
           "terms": {
            "summary": "Open Government Licence v3.0, no registration; acknowledge with: \"this uses Environment Agency flood and river level data from the real-time data API (Beta)\". Not reviewed by a person.",
            "page": "https://environment.data.gov.uk/flood-monitoring/doc/reference",
            "read_at": "2026-11-18",
            "quote": "These APIs are provided as open data under the Open Government Licence with no requirement for registration. If you make use of this data please acknowledge this with the following attribution statement: this uses Environment Agency flood and river level data from the real-time data API (Beta)",
            "quote_lang": "en",
            "republish": "yes, OGL v3.0 with the attribution above",
            "open_question": "The reference asks crawlers to take the latest values of all stations in one call every 15 minutes; this collector asks per station and per gauge, about twenty requests once an hour, which is lighter than a full copy every 15 minutes. security@PrompTugal.dinis to review."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/ea-flood/latest.json",
            "reads": "https://data.promptugal.news/api/v1/ea-flood/reads.json",
            "card": "https://data.promptugal.news/api/v1/ea-flood/card.json",
            "openapi": "https://data.promptugal.news/api/v1/ea-flood/openapi.json",
            "page": "https://data.promptugal.news/sources/ea-flood/"
           },
           "vault": null,
           "split": {
            "code": [
             "the collector reads the EA's warnings and stations near the point on the card, keeps the named fields and the latest readings",
             "GitHub Actions runs it and deploys the site"
            ],
            "agents": [
             "data.b.dev@PrompTugal.dinis wrote the collector and card on 18 November 2026 for data.b@ (WS-177)"
            ],
            "people": [
             "Dinis Cruz decided London as the first place beyond Portugal on 18 November 2026 (board/guidance/2026-11-18-london.md); no person has checked the values (not reviewed)"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge; about twenty-two requests a run (under 300 KB)",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-18"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/ea-flood/openapi.json": {
   "get": {
    "operationId": "get_ea_flood_openapi",
    "tags": [
     "ea-flood"
    ],
    "summary": "London flood warnings and Thames levels (Environment Agency): this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "ea-flood",
   "description": "Flood warnings and alerts in force around London, and the latest water or tidal level at the Thames stations in London, and the nearest ten rainfall gauges (latest 15-minute total and rain per UTC day, 14 days kept), from the Environment Agency's real-time flood-monitoring API. Each warning with its severity, area and times; each station with its latest readings. Not a warning service."
  }
 ],
 "x-source": {
  "id": "ea-flood",
  "card": "https://data.promptugal.news/api/v1/ea-flood/card.json",
  "page": "https://data.promptugal.news/sources/ea-flood/"
 }
}
