{
  "openapi": "3.1.0",
  "info": {
    "title": "Ask the Earth API",
    "version": "v1",
    "summary": "The data behind the Ask the Earth globe, as JSON, CSV or GeoJSON.",
    "description": "25 live datasets: hazards, UK energy, air and water, and the sea and weather. The API comes with Pro.\n\nEvery answer carries its credit line and licence, in the headers and in the body. Show the credit wherever the data appears.\n\nThe data comes from public sources and can be late or wrong. Never use it as the only source for a safety decision.\n\nThe full guide, with the archive, limits and a first call: https://askthe.earth/api/",
    "termsOfService": "https://askthe.earth/api-terms.html"
  },
  "externalDocs": { "description": "The full API guide", "url": "https://askthe.earth/api/" },
  "servers": [{ "url": "https://api.askthe.earth" }],
  "security": [{ "bearerKey": [] }],
  "tags": [
    { "name": "Service", "description": "The dataset list and the health check. No key needed." },
    { "name": "Hazards" },
    { "name": "UK energy" },
    { "name": "Air and water" },
    { "name": "Sea and weather" }
  ],
  "x-tagGroups": [
    { "name": "Service", "tags": ["Service"] },
    { "name": "Datasets", "tags": ["Hazards", "UK energy", "Air and water", "Sea and weather"] }
  ],
  "paths": {
    "/v1/health": {
      "get": {
        "operationId": "getHealth",
        "tags": ["Service"],
        "summary": "How old each source is",
        "description": "No key needed. For status pages.",
        "security": [],
        "responses": {
          "200": {
            "description": "Seconds since each source last updated, or null when it has no data yet.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Health" },
                "example": { "ok": true, "data": { "quakes": 42 } }
              }
            }
          }
        }
      }
    },
    "/v1/datasets": {
      "get": {
        "operationId": "listDatasets",
        "tags": ["Service"],
        "summary": "Every dataset, with its fields, licence and credit",
        "description": "No key needed.",
        "security": [],
        "responses": {
          "200": {
            "description": "The dataset table.",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatasetList" } } }
          }
        }
      }
    },
    "/v1/quakes": {
      "get": {
        "operationId": "getQuakes",
        "tags": ["Hazards"],
        "summary": "quakes",
        "description": "Updates every minute. Coverage: world.\n\nHistory: Kept for as long as the service runs. Ask with since and until.\n\nLicence: US-public-domain.\n\nCredit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/QuakesAnswer" },
                "example": {
                  "dataset": "quakes",
                  "credit": "Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.",
                  "licence": "US-public-domain",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "magnitude": 12.5,
                      "depthKm": 12.5,
                      "place": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.\n# licence: US-public-domain\n# data time: 2026-11-11T09:00:00.000Z\nid,time,lat,lon,magnitude,depthKm,place\ntext,2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/QuakesFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "quakes",
                    "credit": "Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.",
                    "licence": "US-public-domain",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "time": "2026-11-11T09:00:00.000Z",
                        "lat": 50.42,
                        "lon": -5.08,
                        "magnitude": 12.5,
                        "depthKm": 12.5,
                        "place": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/volcanoes-us": {
      "get": {
        "operationId": "getVolcanoesUs",
        "tags": ["Hazards"],
        "summary": "volcanoes-us",
        "description": "Updates every 3 hours. Coverage: US volcanoes only.\n\nHistory: Kept for as long as the service runs. Ask with since and until.\n\nLicence: US-public-domain.\n\nCredit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/VolcanoesUsAnswer" },
                "example": {
                  "dataset": "volcanoes-us",
                  "credit": "Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.",
                  "licence": "US-public-domain",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "vn": 3,
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "colour": "text",
                      "alert": "text",
                      "sent": "2026-11-11T09:00:00.000Z",
                      "noticeUrl": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.\n# licence: US-public-domain\n# data time: 2026-11-11T09:00:00.000Z\nvn,name,lat,lon,colour,alert,sent,noticeUrl\n3,text,50.42,-5.08,text,text,2026-11-11T09:00:00.000Z,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/VolcanoesUsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "volcanoes-us",
                    "credit": "Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.",
                    "licence": "US-public-domain",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "vn": 3,
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "colour": "text",
                        "alert": "text",
                        "sent": "2026-11-11T09:00:00.000Z",
                        "noticeUrl": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/fires": {
      "get": {
        "operationId": "getFires",
        "tags": ["Hazards"],
        "summary": "fires",
        "description": "Updates every 2 hours. Coverage: world.\n\nHistory: Kept for as long as the service runs. Ask with since and until.\n\nLicence: NASA Earthdata open data.\n\nCredit: We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS) (https://earthdata.nasa.gov/firms), part of NASA's Land, Atmosphere Near real-time Capability for Earth observations (LANCE) (https://earthdata.nasa.gov/lance) and NASA's Earth Science Data and Information System (ESDIS).\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/FiresAnswer" },
                "example": {
                  "dataset": "fires",
                  "credit": "We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS) (https://earthdata.nasa.gov/firms), part of NASA's Land, Atmosphere Near real-time Capability for Earth observations (LANCE) (https://earthdata.nasa.gov/lance) and NASA's Earth Science Data and Information System (ESDIS).",
                  "licence": "NASA Earthdata open data",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "frp": 12.5,
                      "confidence": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS) (https://earthdata.nasa.gov/firms), part of NASA's Land, Atmosphere Near real-time Capability for Earth observations (LANCE) (https://earthdata.nasa.gov/lance) and NASA's Earth Science Data and Information System (ESDIS).\n# licence: NASA Earthdata open data\n# data time: 2026-11-11T09:00:00.000Z\nid,time,lat,lon,frp,confidence\ntext,2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/FiresFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "fires",
                    "credit": "We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS) (https://earthdata.nasa.gov/firms), part of NASA's Land, Atmosphere Near real-time Capability for Earth observations (LANCE) (https://earthdata.nasa.gov/lance) and NASA's Earth Science Data and Information System (ESDIS).",
                    "licence": "NASA Earthdata open data",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "time": "2026-11-11T09:00:00.000Z",
                        "lat": 50.42,
                        "lon": -5.08,
                        "frp": 12.5,
                        "confidence": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/lightning": {
      "get": {
        "operationId": "getLightning",
        "tags": ["Hazards"],
        "summary": "lightning",
        "description": "Updates every minute. Coverage: the Americas, Europe and Africa (GOES and Meteosat views).\n\nHistory: Flash by flash for 31 days, then counts per hour per 0.25° cell. A range that starts more than 31 days back comes as counts: time, lat and lon (the cell’s centre) and count.\n\nLicence: NOAA open data, CC-BY-4.0.\n\nCredit: Lightning: NOAA GOES-East and GOES-West Geostationary Lightning Mapper (GLM) Contains modified EUMETSAT Meteosat data 2026\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/LightningAnswer" },
                "example": {
                  "dataset": "lightning",
                  "credit": "Lightning: NOAA GOES-East and GOES-West Geostationary Lightning Mapper (GLM) Contains modified EUMETSAT Meteosat data 2026",
                  "licence": "NOAA open data, CC-BY-4.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "durationMs": 3,
                      "areaKm2": 3,
                      "intensity": 3,
                      "source": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Lightning: NOAA GOES-East and GOES-West Geostationary Lightning Mapper (GLM) Contains modified EUMETSAT Meteosat data 2026\n# licence: NOAA open data, CC-BY-4.0\n# data time: 2026-11-11T09:00:00.000Z\ntime,lat,lon,durationMs,areaKm2,intensity,source\n2026-11-11T09:00:00.000Z,50.42,-5.08,3,3,3,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/LightningFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "lightning",
                    "credit": "Lightning: NOAA GOES-East and GOES-West Geostationary Lightning Mapper (GLM) Contains modified EUMETSAT Meteosat data 2026",
                    "licence": "NOAA open data, CC-BY-4.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "time": "2026-11-11T09:00:00.000Z",
                        "lat": 50.42,
                        "lon": -5.08,
                        "durationMs": 3,
                        "areaKm2": 3,
                        "intensity": 3,
                        "source": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/flood-warnings": {
      "get": {
        "operationId": "getFloodWarnings",
        "tags": ["Hazards"],
        "summary": "flood-warnings",
        "description": "Updates every 15 minutes. Coverage: England.\n\nHistory: Kept for as long as the service runs. Ask with since and until.\n\nLicence: OGL-UK-3.0.\n\nCredit: Contains Environment Agency data licensed under the Open Government Licence v3.0.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/FloodWarningsAnswer" },
                "example": {
                  "dataset": "flood-warnings",
                  "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "area": "text",
                      "severity": "text",
                      "severityLevel": 3,
                      "message": "text",
                      "raised": "2026-11-11T09:00:00.000Z",
                      "changed": "2026-11-11T09:00:00.000Z",
                      "outline": {
                        "type": "MultiPolygon",
                        "coordinates": [
                          [
                            [
                              [-5.1, 50.4],
                              [-5, 50.4],
                              [-5, 50.5],
                              [-5.1, 50.4]
                            ]
                          ]
                        ]
                      }
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains Environment Agency data licensed under the Open Government Licence v3.0.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nid,area,severity,severityLevel,message,raised,changed,outline\ntext,text,text,3,text,2026-11-11T09:00:00.000Z,2026-11-11T09:00:00.000Z,\"{\"\"type\"\":\"\"MultiPolygon\"\",\"\"coordinates\"\":[[[[-5.1,50.4],[-5,50.4],[-5,50.5],[-5.1,50.4]]]]}\""
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/FloodWarningsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "flood-warnings",
                    "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0.",
                    "licence": "OGL-UK-3.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": null,
                      "properties": {
                        "id": "text",
                        "area": "text",
                        "severity": "text",
                        "severityLevel": 3,
                        "message": "text",
                        "raised": "2026-11-11T09:00:00.000Z",
                        "changed": "2026-11-11T09:00:00.000Z",
                        "outline": {
                          "type": "MultiPolygon",
                          "coordinates": [
                            [
                              [
                                [-5.1, 50.4],
                                [-5, 50.4],
                                [-5, 50.5],
                                [-5.1, 50.4]
                              ]
                            ]
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/generation-mix": {
      "get": {
        "operationId": "getGenerationMix",
        "tags": ["UK energy"],
        "summary": "generation-mix",
        "description": "Updates every 5 minutes. Coverage: GB.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: BMRS data licence.\n\nCredit: Contains BMRS data © Elexon Limited copyright and database right 2026.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/GenerationMixAnswer" },
                "example": {
                  "dataset": "generation-mix",
                  "credit": "Contains BMRS data © Elexon Limited copyright and database right 2026.",
                  "licence": "BMRS data licence",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [{ "time": "2026-11-11T09:00:00.000Z", "fuel": "text", "mw": 12.5 }]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains BMRS data © Elexon Limited copyright and database right 2026.\n# licence: BMRS data licence\n# data time: 2026-11-11T09:00:00.000Z\ntime,fuel,mw\n2026-11-11T09:00:00.000Z,text,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/carbon-national": {
      "get": {
        "operationId": "getCarbonNational",
        "tags": ["UK energy"],
        "summary": "carbon-national",
        "description": "Updates every half hour. Coverage: GB.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: NESO Open Data Licence.\n\nCredit: Carbon intensity and generation mix, Great Britain: Supported by National Energy SO Open Data.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CarbonNationalAnswer" },
                "example": {
                  "dataset": "carbon-national",
                  "credit": "Carbon intensity and generation mix, Great Britain: Supported by National Energy SO Open Data.",
                  "licence": "NESO Open Data Licence",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "intensity": 12.5,
                      "gas": 12.5,
                      "coal": 12.5,
                      "nuclear": 12.5,
                      "wind": 12.5,
                      "windEmbedded": 12.5,
                      "hydro": 12.5,
                      "imports": 12.5,
                      "biomass": 12.5,
                      "other": 12.5,
                      "solar": 12.5,
                      "storage": 12.5,
                      "generation": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Carbon intensity and generation mix, Great Britain: Supported by National Energy SO Open Data.\n# licence: NESO Open Data Licence\n# data time: 2026-11-11T09:00:00.000Z\ntime,intensity,gas,coal,nuclear,wind,windEmbedded,hydro,imports,biomass,other,solar,storage,generation\n2026-11-11T09:00:00.000Z,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/interconnectors": {
      "get": {
        "operationId": "getInterconnectors",
        "tags": ["UK energy"],
        "summary": "interconnectors",
        "description": "Updates every 5 minutes. Coverage: GB.\n\nHistory: Latest only. No history is kept.\n\nLicence: BMRS data licence.\n\nCredit: Contains BMRS data © Elexon Limited copyright and database right 2026.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/InterconnectorsAnswer" },
                "example": {
                  "dataset": "interconnectors",
                  "credit": "Contains BMRS data © Elexon Limited copyright and database right 2026.",
                  "licence": "BMRS data licence",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [{ "time": "2026-11-11T09:00:00.000Z", "link": "text", "mw": 12.5 }]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains BMRS data © Elexon Limited copyright and database right 2026.\n# licence: BMRS data licence\n# data time: 2026-11-11T09:00:00.000Z\ntime,link,mw\n2026-11-11T09:00:00.000Z,text,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/power-cuts": {
      "get": {
        "operationId": "getPowerCuts",
        "tags": ["UK energy"],
        "summary": "power-cuts",
        "description": "Updates every 5 minutes. Coverage: the UK Power Networks, SSEN and Electricity North West areas. Not covered: Northern Powergrid, National Grid Electricity Distribution and SP Energy Networks.\n\nHistory: Kept for as long as the service runs. Ask with since and until.\n\nLicence: CC-BY-4.0.\n\nCredit: Power cuts: UK Power Networks (CC BY 4.0). Power cuts: SSEN Distribution (CC BY 4.0). Power cuts: SP Electricity North West (CC BY 4.0).\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/PowerCutsAnswer" },
                "example": {
                  "dataset": "power-cuts",
                  "credit": "Power cuts: UK Power Networks (CC BY 4.0). Power cuts: SSEN Distribution (CC BY 4.0). Power cuts: SP Electricity North West (CC BY 4.0).",
                  "licence": "CC-BY-4.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "operator": "text",
                      "id": "text",
                      "districts": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "customers": 3,
                      "planned": false,
                      "start": "2026-11-11T09:00:00.000Z",
                      "restoreBy": "2026-11-11T09:00:00.000Z",
                      "text": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Power cuts: UK Power Networks (CC BY 4.0). Power cuts: SSEN Distribution (CC BY 4.0). Power cuts: SP Electricity North West (CC BY 4.0).\n# licence: CC-BY-4.0\n# data time: 2026-11-11T09:00:00.000Z\noperator,id,districts,lat,lon,customers,planned,start,restoreBy,text\ntext,text,text,50.42,-5.08,3,false,2026-11-11T09:00:00.000Z,2026-11-11T09:00:00.000Z,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/PowerCutsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "power-cuts",
                    "credit": "Power cuts: UK Power Networks (CC BY 4.0). Power cuts: SSEN Distribution (CC BY 4.0). Power cuts: SP Electricity North West (CC BY 4.0).",
                    "licence": "CC-BY-4.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "operator": "text",
                        "id": "text",
                        "districts": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "customers": 3,
                        "planned": false,
                        "start": "2026-11-11T09:00:00.000Z",
                        "restoreBy": "2026-11-11T09:00:00.000Z",
                        "text": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/wind-farms": {
      "get": {
        "operationId": "getWindFarms",
        "tags": ["UK energy"],
        "summary": "wind-farms",
        "description": "Updates every half hour. Coverage: GB.\n\nHistory: Latest only. No history is kept.\n\nLicence: OGL-UK-3.0, BMRS data licence, NESO Open Data Licence.\n\nCredit: Wind farm locations: Renewable Energy Planning Database, Department for Energy Security and Net Zero. Contains public sector information licensed under the Open Government Licence v3.0. Contains BMRS data © Elexon Limited copyright and database right 2026. Region boundaries: Supported by National Energy SO Open Data.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/WindFarmsAnswer" },
                "example": {
                  "dataset": "wind-farms",
                  "credit": "Wind farm locations: Renewable Energy Planning Database, Department for Energy Security and Net Zero. Contains public sector information licensed under the Open Government Licence v3.0. Contains BMRS data © Elexon Limited copyright and database right 2026. Region boundaries: Supported by National Energy SO Open Data.",
                  "licence": "OGL-UK-3.0, BMRS data licence, NESO Open Data Licence",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "unit": "text",
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "offshore": false,
                      "region": "text",
                      "mw": 12.5,
                      "curtailed": false,
                      "period": "2026-11-11T09:00:00.000Z"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Wind farm locations: Renewable Energy Planning Database, Department for Energy Security and Net Zero. Contains public sector information licensed under the Open Government Licence v3.0. Contains BMRS data © Elexon Limited copyright and database right 2026. Region boundaries: Supported by National Energy SO Open Data.\n# licence: OGL-UK-3.0, BMRS data licence, NESO Open Data Licence\n# data time: 2026-11-11T09:00:00.000Z\nunit,name,lat,lon,offshore,region,mw,curtailed,period\ntext,text,50.42,-5.08,false,text,12.5,false,2026-11-11T09:00:00.000Z"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/WindFarmsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "wind-farms",
                    "credit": "Wind farm locations: Renewable Energy Planning Database, Department for Energy Security and Net Zero. Contains public sector information licensed under the Open Government Licence v3.0. Contains BMRS data © Elexon Limited copyright and database right 2026. Region boundaries: Supported by National Energy SO Open Data.",
                    "licence": "OGL-UK-3.0, BMRS data licence, NESO Open Data Licence",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "unit": "text",
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "offshore": false,
                        "region": "text",
                        "mw": 12.5,
                        "curtailed": false,
                        "period": "2026-11-11T09:00:00.000Z"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/air-uk": {
      "get": {
        "operationId": "getAirUk",
        "tags": ["Air and water"],
        "summary": "air-uk",
        "description": "Updates every hour. Coverage: UK.\n\nHistory: Latest only. No history is kept.\n\nLicence: OGL-UK-3.0.\n\nCredit: © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirUkAnswer" },
                "example": {
                  "dataset": "air-uk",
                  "credit": "© Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "index": 3,
                      "pm25": 12.5,
                      "pm10": 12.5,
                      "no2": 12.5,
                      "o3": 12.5,
                      "so2": 12.5,
                      "time": "2026-11-11T09:00:00.000Z"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nid,name,lat,lon,index,pm25,pm10,no2,o3,so2,time\ntext,text,50.42,-5.08,3,12.5,12.5,12.5,12.5,12.5,2026-11-11T09:00:00.000Z"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/AirUkFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "air-uk",
                    "credit": "© Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.",
                    "licence": "OGL-UK-3.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "index": 3,
                        "pm25": 12.5,
                        "pm10": 12.5,
                        "no2": 12.5,
                        "o3": 12.5,
                        "so2": 12.5,
                        "time": "2026-11-11T09:00:00.000Z"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/air-world": {
      "get": {
        "operationId": "getAirWorld",
        "tags": ["Air and water"],
        "summary": "air-world",
        "description": "Updates every hour. Coverage: world.\n\nHistory: Latest only. No history is kept.\n\nLicence: per provider.\n\nCredit: Data: OpenAQ (openaq.org), with each provider's own credit.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirWorldAnswer" },
                "example": {
                  "dataset": "air-world",
                  "credit": "Data: OpenAQ (openaq.org), with each provider's own credit.",
                  "licence": "per provider",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": 3,
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "index": 3,
                      "pm25": 12.5,
                      "pm10": 12.5,
                      "no2": 12.5,
                      "o3": 12.5,
                      "so2": 12.5,
                      "time": "2026-11-11T09:00:00.000Z",
                      "provider": "text",
                      "providerLicence": "text",
                      "providerCredit": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Data: OpenAQ (openaq.org), with each provider's own credit.\n# licence: per provider\n# data time: 2026-11-11T09:00:00.000Z\nid,name,lat,lon,index,pm25,pm10,no2,o3,so2,time,provider,providerLicence,providerCredit\n3,text,50.42,-5.08,3,12.5,12.5,12.5,12.5,12.5,2026-11-11T09:00:00.000Z,text,text,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/AirWorldFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "air-world",
                    "credit": "Data: OpenAQ (openaq.org), with each provider's own credit.",
                    "licence": "per provider",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": 3,
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "index": 3,
                        "pm25": 12.5,
                        "pm10": 12.5,
                        "no2": 12.5,
                        "o3": 12.5,
                        "so2": 12.5,
                        "time": "2026-11-11T09:00:00.000Z",
                        "provider": "text",
                        "providerLicence": "text",
                        "providerCredit": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/air-forecast-uk": {
      "get": {
        "operationId": "getAirForecastUk",
        "tags": ["Air and water"],
        "summary": "air-forecast-uk",
        "description": "Updates every day. Coverage: UK.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: OGL-UK-3.0.\n\nCredit: © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Any span.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirForecastUkAnswer" },
                "example": {
                  "dataset": "air-forecast-uk",
                  "credit": "© Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [{ "place": "text", "lat": 50.42, "lon": -5.08, "day": "2026-11-11", "index": 3 }]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nplace,lat,lon,day,index\ntext,50.42,-5.08,2026-11-11,3"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/air-maps": {
      "get": {
        "operationId": "getAirMaps",
        "tags": ["Air and water"],
        "summary": "air-maps",
        "description": "Updates every day. Coverage: world.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: CC-BY-4.0.\n\nCredit: Contains modified Copernicus Atmosphere Monitoring Service information 2026. Neither the European Commission nor ECMWF is responsible for any use made of this information.\n\nEvent answers are capped at 50,000 rows. A grid answer is capped at 250,000 cells.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Up to 31 days a call, with at.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          {
            "name": "at",
            "in": "query",
            "description": "Grids only, with since: the series at one point, lat,lon in degrees.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,2}(\\.\\d{1,6})?,-?\\d{1,3}(\\.\\d{1,6})?$" },
            "example": "50.42,-5.08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirMapsAnswer" },
                "example": {
                  "dataset": "air-maps",
                  "credit": "Contains modified Copernicus Atmosphere Monitoring Service information 2026. Neither the European Commission nor ECMWF is responsible for any use made of this information.",
                  "licence": "CC-BY-4.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "pm25": 12.5,
                      "dustAod": 12.5,
                      "smokeAod": 12.5,
                      "uvIndex": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains modified Copernicus Atmosphere Monitoring Service information 2026. Neither the European Commission nor ECMWF is responsible for any use made of this information.\n# licence: CC-BY-4.0\n# data time: 2026-11-11T09:00:00.000Z\ntime,lat,lon,pm25,dustAod,smokeAod,uvIndex\n2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/rivers": {
      "get": {
        "operationId": "getRivers",
        "tags": ["Air and water"],
        "summary": "rivers",
        "description": "Updates every 15 minutes. Coverage: England.\n\nHistory: Latest only. No history is kept.\n\nLicence: OGL-UK-3.0.\n\nCredit: Contains Environment Agency data licensed under the Open Government Licence v3.0. Contains OS data © Crown Copyright and database rights 2026.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/RiversAnswer" },
                "example": {
                  "dataset": "rivers",
                  "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0. Contains OS data © Crown Copyright and database rights 2026.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "label": "text",
                      "river": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "level": 12.5,
                      "state": "text",
                      "time": "2026-11-11T09:00:00.000Z",
                      "typicalLow": 12.5,
                      "typicalHigh": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains Environment Agency data licensed under the Open Government Licence v3.0. Contains OS data © Crown Copyright and database rights 2026.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nid,label,river,lat,lon,level,state,time,typicalLow,typicalHigh\ntext,text,text,50.42,-5.08,12.5,text,2026-11-11T09:00:00.000Z,12.5,12.5"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/RiversFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "rivers",
                    "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0. Contains OS data © Crown Copyright and database rights 2026.",
                    "licence": "OGL-UK-3.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "label": "text",
                        "river": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "level": 12.5,
                        "state": "text",
                        "time": "2026-11-11T09:00:00.000Z",
                        "typicalLow": 12.5,
                        "typicalHigh": 12.5
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/bathing-water": {
      "get": {
        "operationId": "getBathingWater",
        "tags": ["Air and water"],
        "summary": "bathing-water",
        "description": "Updates every day. Coverage: England.\n\nHistory: Latest only. No history is kept.\n\nLicence: OGL-UK-3.0.\n\nCredit: Contains Environment Agency data licensed under the Open Government Licence v3.0.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/BathingWaterAnswer" },
                "example": {
                  "dataset": "bathing-water",
                  "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "grade": "text",
                      "gradeYear": 3,
                      "sampleTime": "2026-11-11T09:00:00.000Z",
                      "ecoli": 12.5,
                      "enterococci": 12.5,
                      "risk": "text",
                      "riskDate": "2026-11-11"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains Environment Agency data licensed under the Open Government Licence v3.0.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nid,name,lat,lon,grade,gradeYear,sampleTime,ecoli,enterococci,risk,riskDate\ntext,text,50.42,-5.08,text,3,2026-11-11T09:00:00.000Z,12.5,12.5,text,2026-11-11"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/BathingWaterFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "bathing-water",
                    "credit": "Contains Environment Agency data licensed under the Open Government Licence v3.0.",
                    "licence": "OGL-UK-3.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "grade": "text",
                        "gradeYear": 3,
                        "sampleTime": "2026-11-11T09:00:00.000Z",
                        "ecoli": 12.5,
                        "enterococci": 12.5,
                        "risk": "text",
                        "riskDate": "2026-11-11"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/sewage-overflows": {
      "get": {
        "operationId": "getSewageOverflows",
        "tags": ["Air and water"],
        "summary": "sewage-overflows",
        "description": "Updates every 15 minutes. Coverage: England, eight of the ten companies (not Southern Water or Welsh Water).\n\nHistory: Latest only. No history is kept.\n\nLicence: CC-BY-4.0.\n\nCredit: Storm overflow activity: Anglian Water Storm Overflow Activity, Anglian Water Services, licensed under CC BY 4.0. Storm overflow activity: Northumbrian Water Storm Overflow Activity, Northumbrian Water, licensed under CC BY 4.0. Storm overflow activity: Severn Trent Water Storm Overflow Activity, Severn Trent Water, licensed under CC BY 4.0. Storm overflow activity: South West Water - Storm Overflow Activity, South West Water, licensed under CC BY 4.0. Storm overflow activity: Thames Water Storm Overflow Activity, Thames Water, licensed under CC BY 4.0. Storm overflow activity: United Utilities Storm Overflow Activity, Data produced and managed by United Utilities, licensed under CC BY 4.0. Storm overflow activity: Wessex Water Storm Overflow Activity © 2024 by Wessex Water is licensed under CC BY 4.0. Storm overflow activity: Yorkshire Water Storm Overflow Activity, Yorkshire Water, licensed under CC BY 4.0. Via the Water UK National Storm Overflow Hub. Near-real-time monitor activations, not verified discharges.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SewageOverflowsAnswer" },
                "example": {
                  "dataset": "sewage-overflows",
                  "credit": "Storm overflow activity: Anglian Water Storm Overflow Activity, Anglian Water Services, licensed under CC BY 4.0. Storm overflow activity: Northumbrian Water Storm Overflow Activity, Northumbrian Water, licensed under CC BY 4.0. Storm overflow activity: Severn Trent Water Storm Overflow Activity, Severn Trent Water, licensed under CC BY 4.0. Storm overflow activity: South West Water - Storm Overflow Activity, South West Water, licensed under CC BY 4.0. Storm overflow activity: Thames Water Storm Overflow Activity, Thames Water, licensed under CC BY 4.0. Storm overflow activity: United Utilities Storm Overflow Activity, Data produced and managed by United Utilities, licensed under CC BY 4.0. Storm overflow activity: Wessex Water Storm Overflow Activity © 2024 by Wessex Water is licensed under CC BY 4.0. Storm overflow activity: Yorkshire Water Storm Overflow Activity, Yorkshire Water, licensed under CC BY 4.0. Via the Water UK National Storm Overflow Hub. Near-real-time monitor activations, not verified discharges.",
                  "licence": "CC-BY-4.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "company": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "status": "text",
                      "statusStart": "2026-11-11T09:00:00.000Z",
                      "latestEventStart": "2026-11-11T09:00:00.000Z",
                      "latestEventEnd": "2026-11-11T09:00:00.000Z",
                      "receivingWater": "text",
                      "lastUpdated": "2026-11-11T09:00:00.000Z",
                      "stale": false
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Storm overflow activity: Anglian Water Storm Overflow Activity, Anglian Water Services, licensed under CC BY 4.0. Storm overflow activity: Northumbrian Water Storm Overflow Activity, Northumbrian Water, licensed under CC BY 4.0. Storm overflow activity: Severn Trent Water Storm Overflow Activity, Severn Trent Water, licensed under CC BY 4.0. Storm overflow activity: South West Water - Storm Overflow Activity, South West Water, licensed under CC BY 4.0. Storm overflow activity: Thames Water Storm Overflow Activity, Thames Water, licensed under CC BY 4.0. Storm overflow activity: United Utilities Storm Overflow Activity, Data produced and managed by United Utilities, licensed under CC BY 4.0. Storm overflow activity: Wessex Water Storm Overflow Activity © 2024 by Wessex Water is licensed under CC BY 4.0. Storm overflow activity: Yorkshire Water Storm Overflow Activity, Yorkshire Water, licensed under CC BY 4.0. Via the Water UK National Storm Overflow Hub. Near-real-time monitor activations, not verified discharges.\n# licence: CC-BY-4.0\n# data time: 2026-11-11T09:00:00.000Z\nid,company,lat,lon,status,statusStart,latestEventStart,latestEventEnd,receivingWater,lastUpdated,stale\ntext,text,50.42,-5.08,text,2026-11-11T09:00:00.000Z,2026-11-11T09:00:00.000Z,2026-11-11T09:00:00.000Z,text,2026-11-11T09:00:00.000Z,false"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/SewageOverflowsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "sewage-overflows",
                    "credit": "Storm overflow activity: Anglian Water Storm Overflow Activity, Anglian Water Services, licensed under CC BY 4.0. Storm overflow activity: Northumbrian Water Storm Overflow Activity, Northumbrian Water, licensed under CC BY 4.0. Storm overflow activity: Severn Trent Water Storm Overflow Activity, Severn Trent Water, licensed under CC BY 4.0. Storm overflow activity: South West Water - Storm Overflow Activity, South West Water, licensed under CC BY 4.0. Storm overflow activity: Thames Water Storm Overflow Activity, Thames Water, licensed under CC BY 4.0. Storm overflow activity: United Utilities Storm Overflow Activity, Data produced and managed by United Utilities, licensed under CC BY 4.0. Storm overflow activity: Wessex Water Storm Overflow Activity © 2024 by Wessex Water is licensed under CC BY 4.0. Storm overflow activity: Yorkshire Water Storm Overflow Activity, Yorkshire Water, licensed under CC BY 4.0. Via the Water UK National Storm Overflow Hub. Near-real-time monitor activations, not verified discharges.",
                    "licence": "CC-BY-4.0",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "company": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "status": "text",
                        "statusStart": "2026-11-11T09:00:00.000Z",
                        "latestEventStart": "2026-11-11T09:00:00.000Z",
                        "latestEventEnd": "2026-11-11T09:00:00.000Z",
                        "receivingWater": "text",
                        "lastUpdated": "2026-11-11T09:00:00.000Z",
                        "stale": false
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/sewage-annual": {
      "get": {
        "operationId": "getSewageAnnual",
        "tags": ["Air and water"],
        "summary": "sewage-annual",
        "description": "Updates every year, in the autumn. Coverage: England.\n\nHistory: The dataset is itself a record over time, so every answer is the whole history.\n\nLicence: OGL-UK-3.0.\n\nCredit: Contains Environment Agency information © Environment Agency and database right, licensed under the Open Government Licence v3.0.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SewageAnnualAnswer" },
                "example": {
                  "dataset": "sewage-annual",
                  "credit": "Contains Environment Agency information © Environment Agency and database right, licensed under the Open Government Licence v3.0.",
                  "licence": "OGL-UK-3.0",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [{ "id": "text", "company": "text", "year": 3, "spills": 3, "hours": 12.5 }]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Contains Environment Agency information © Environment Agency and database right, licensed under the Open Government Licence v3.0.\n# licence: OGL-UK-3.0\n# data time: 2026-11-11T09:00:00.000Z\nid,company,year,spills,hours\ntext,text,3,3,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/waves": {
      "get": {
        "operationId": "getWaves",
        "tags": ["Sea and weather"],
        "summary": "waves",
        "description": "Updates every 6 hours. Coverage: world.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: NOAA open data.\n\nCredit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n\nEvent answers are capped at 50,000 rows. A grid answer is capped at 250,000 cells.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Up to 31 days a call, with at.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          {
            "name": "at",
            "in": "query",
            "description": "Grids only, with since: the series at one point, lat,lon in degrees.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,2}(\\.\\d{1,6})?,-?\\d{1,3}(\\.\\d{1,6})?$" },
            "example": "50.42,-5.08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/WavesAnswer" },
                "example": {
                  "dataset": "waves",
                  "credit": "Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth",
                  "licence": "NOAA open data",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "height": 12.5,
                      "period": 12.5,
                      "direction": 12.5,
                      "swell1Height": 12.5,
                      "swell1Period": 12.5,
                      "swell1Direction": 12.5,
                      "swell2Height": 12.5,
                      "swell2Period": 12.5,
                      "swell2Direction": 12.5,
                      "windSeaHeight": 12.5,
                      "windSeaPeriod": 12.5,
                      "windSeaDirection": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n# licence: NOAA open data\n# data time: 2026-11-11T09:00:00.000Z\ntime,lat,lon,height,period,direction,swell1Height,swell1Period,swell1Direction,swell2Height,swell2Period,swell2Direction,windSeaHeight,windSeaPeriod,windSeaDirection\n2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/sea-temperature": {
      "get": {
        "operationId": "getSeaTemperature",
        "tags": ["Sea and weather"],
        "summary": "sea-temperature",
        "description": "Updates every day. Coverage: world.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: US-public-domain.\n\nCredit: Sea surface temperature: NOAA 1/4° Daily Optimum Interpolation Sea Surface Temperature (OISST) v2.1, NOAA National Centers for Environmental Information (Huang et al., 2021). Anomalies against 1991–2020 and marine heatwave categories (Hobday et al., 2018) calculated by Ask the Earth.\n\nEvent answers are capped at 50,000 rows. A grid answer is capped at 250,000 cells.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Up to 31 days a call, with at.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          {
            "name": "at",
            "in": "query",
            "description": "Grids only, with since: the series at one point, lat,lon in degrees.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,2}(\\.\\d{1,6})?,-?\\d{1,3}(\\.\\d{1,6})?$" },
            "example": "50.42,-5.08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SeaTemperatureAnswer" },
                "example": {
                  "dataset": "sea-temperature",
                  "credit": "Sea surface temperature: NOAA 1/4° Daily Optimum Interpolation Sea Surface Temperature (OISST) v2.1, NOAA National Centers for Environmental Information (Huang et al., 2021). Anomalies against 1991–2020 and marine heatwave categories (Hobday et al., 2018) calculated by Ask the Earth.",
                  "licence": "US-public-domain",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "day": "2026-11-11",
                      "lat": 50.42,
                      "lon": -5.08,
                      "sst": 12.5,
                      "anomaly": 12.5,
                      "heatwave": 3
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Sea surface temperature: NOAA 1/4° Daily Optimum Interpolation Sea Surface Temperature (OISST) v2.1, NOAA National Centers for Environmental Information (Huang et al., 2021). Anomalies against 1991–2020 and marine heatwave categories (Hobday et al., 2018) calculated by Ask the Earth.\n# licence: US-public-domain\n# data time: 2026-11-11T09:00:00.000Z\nday,lat,lon,sst,anomaly,heatwave\n2026-11-11,50.42,-5.08,12.5,12.5,3"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/currents": {
      "get": {
        "operationId": "getCurrents",
        "tags": ["Sea and weather"],
        "summary": "currents",
        "description": "Updates every day. Coverage: world.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: NOAA open data.\n\nCredit: Ocean currents: NOAA Global Real-Time Ocean Forecast System (RTOFS), resampled to 0.25°\n\nEvent answers are capped at 50,000 rows. A grid answer is capped at 250,000 cells.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Up to 31 days a call, with at.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          {
            "name": "at",
            "in": "query",
            "description": "Grids only, with since: the series at one point, lat,lon in degrees.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,2}(\\.\\d{1,6})?,-?\\d{1,3}(\\.\\d{1,6})?$" },
            "example": "50.42,-5.08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CurrentsAnswer" },
                "example": {
                  "dataset": "currents",
                  "credit": "Ocean currents: NOAA Global Real-Time Ocean Forecast System (RTOFS), resampled to 0.25°",
                  "licence": "NOAA open data",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    { "time": "2026-11-11T09:00:00.000Z", "lat": 50.42, "lon": -5.08, "u": 12.5, "v": 12.5 }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Ocean currents: NOAA Global Real-Time Ocean Forecast System (RTOFS), resampled to 0.25°\n# licence: NOAA open data\n# data time: 2026-11-11T09:00:00.000Z\ntime,lat,lon,u,v\n2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/weather": {
      "get": {
        "operationId": "getWeather",
        "tags": ["Sea and weather"],
        "summary": "weather",
        "description": "Updates every 6 hours. Coverage: world.\n\nHistory: Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.\n\nLicence: NOAA open data.\n\nCredit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n\nEvent answers are capped at 50,000 rows. A grid answer is capped at 250,000 cells.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          {
            "name": "since",
            "in": "query",
            "description": "Start of a range from the archive: a UTC day or an ISO time ending in Z. Up to 31 days a call, with at.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-01"
          },
          {
            "name": "until",
            "in": "query",
            "description": "End of the range, as since. Left out, it is now.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
            },
            "example": "2026-11-08"
          },
          {
            "name": "at",
            "in": "query",
            "description": "Grids only, with since: the series at one point, lat,lon in degrees.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,2}(\\.\\d{1,6})?,-?\\d{1,3}(\\.\\d{1,6})?$" },
            "example": "50.42,-5.08"
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/WeatherAnswer" },
                "example": {
                  "dataset": "weather",
                  "credit": "Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth",
                  "licence": "NOAA open data",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "lat": 50.42,
                      "lon": -5.08,
                      "temperature": 12.5,
                      "windU": 12.5,
                      "windV": 12.5,
                      "precipitation": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n# licence: NOAA open data\n# data time: 2026-11-11T09:00:00.000Z\ntime,lat,lon,temperature,windU,windV,precipitation\n2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/point-forecast": {
      "get": {
        "operationId": "getPointForecast",
        "tags": ["Sea and weather"],
        "summary": "point-forecast",
        "description": "Updates every 6 hours. Coverage: world.\n\nHistory: Latest only. No history is kept.\n\nLicence: NOAA open data.\n\nCredit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          {
            "name": "near",
            "in": "query",
            "required": true,
            "description": "The place: lat,lon in degrees. Needed, with km.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": true,
            "description": "Needed with near, though the answer is for the point itself.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/PointForecastAnswer" },
                "example": {
                  "dataset": "point-forecast",
                  "credit": "Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth",
                  "licence": "NOAA open data",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "time": "2026-11-11T09:00:00.000Z",
                      "temperature": 12.5,
                      "windSpeed": 12.5,
                      "windDirection": 12.5,
                      "precipitation": 12.5
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Weather and surf: NOAA GFS and GFS-Wave forecasts; weather resampled to 0.5°, surf read at the nearest 1/6° sea cell and turned into surf estimates by Ask the Earth\n# licence: NOAA open data\n# data time: 2026-11-11T09:00:00.000Z\ntime,temperature,windSpeed,windDirection,precipitation\n2026-11-11T09:00:00.000Z,12.5,12.5,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/surf-spots": {
      "get": {
        "operationId": "getSurfSpots",
        "tags": ["Sea and weather"],
        "summary": "surf-spots",
        "description": "Updates every 6 hours. Coverage: Cornwall surf spots.\n\nHistory: Latest only. No history is kept.\n\nLicence: Copernicus Marine Service licence.\n\nCredit: Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00055. Surf heights and ratings are estimates made from it by Ask the Earth. Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00025. Surf heights and ratings are estimates made from it by Ask the Earth.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv", "geojson"], "default": "json" }
          },
          {
            "name": "bbox",
            "in": "query",
            "description": "An area: west,south,east,north in degrees. A west greater than east crosses the antimeridian. Not with near.",
            "schema": {
              "type": "string",
              "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?(,-?\\d{1,3}(\\.\\d{1,8})?){3}$"
            },
            "example": "-6,49.9,-4.2,51"
          },
          {
            "name": "near",
            "in": "query",
            "required": false,
            "description": "A circle round lat,lon in degrees, with km. Not with bbox.",
            "schema": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d{1,8})?,-?\\d{1,3}(\\.\\d{1,8})?$" },
            "example": "50.42,-5.08"
          },
          {
            "name": "km",
            "in": "query",
            "required": false,
            "description": "The circle’s radius.",
            "schema": { "type": "number", "minimum": 1, "maximum": 500 },
            "example": 25
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SurfSpotsAnswer" },
                "example": {
                  "dataset": "surf-spots",
                  "credit": "Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00055. Surf heights and ratings are estimates made from it by Ask the Earth. Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00025. Surf heights and ratings are estimates made from it by Ask the Earth.",
                  "licence": "Copernicus Marine Service licence",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    {
                      "id": "text",
                      "name": "text",
                      "lat": 50.42,
                      "lon": -5.08,
                      "time": "2026-11-11T09:00:00.000Z",
                      "surfLow": 12.5,
                      "surfHigh": 12.5,
                      "swell1Height": 12.5,
                      "swell1Period": 12.5,
                      "swell1Direction": 12.5,
                      "swell2Height": 12.5,
                      "swell2Period": 12.5,
                      "swell2Direction": 12.5,
                      "windSeaHeight": 12.5,
                      "windSeaPeriod": 12.5,
                      "windSeaDirection": 12.5,
                      "model": "text"
                    }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00055. Surf heights and ratings are estimates made from it by Ask the Earth. Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00025. Surf heights and ratings are estimates made from it by Ask the Earth.\n# licence: Copernicus Marine Service licence\n# data time: 2026-11-11T09:00:00.000Z\nid,name,lat,lon,time,surfLow,surfHigh,swell1Height,swell1Period,swell1Direction,swell2Height,swell2Period,swell2Direction,windSeaHeight,windSeaPeriod,windSeaDirection,model\ntext,text,50.42,-5.08,2026-11-11T09:00:00.000Z,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,12.5,text"
              },
              "application/geo+json": {
                "schema": { "$ref": "#/components/schemas/SurfSpotsFeatures" },
                "example": {
                  "type": "FeatureCollection",
                  "properties": {
                    "dataset": "surf-spots",
                    "credit": "Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00055. Surf heights and ratings are estimates made from it by Ask the Earth. Generated using E.U. Copernicus Marine Service Information; https://doi.org/10.48670/moi-00025. Surf heights and ratings are estimates made from it by Ask the Earth.",
                    "licence": "Copernicus Marine Service licence",
                    "dataTime": "2026-11-11T09:00:00.000Z"
                  },
                  "features": [
                    {
                      "type": "Feature",
                      "geometry": { "type": "Point", "coordinates": [-5.08, 50.42] },
                      "properties": {
                        "id": "text",
                        "name": "text",
                        "lat": 50.42,
                        "lon": -5.08,
                        "time": "2026-11-11T09:00:00.000Z",
                        "surfLow": 12.5,
                        "surfHigh": 12.5,
                        "swell1Height": 12.5,
                        "swell1Period": 12.5,
                        "swell1Direction": 12.5,
                        "swell2Height": 12.5,
                        "swell2Period": 12.5,
                        "swell2Direction": 12.5,
                        "windSeaHeight": 12.5,
                        "windSeaPeriod": 12.5,
                        "windSeaDirection": 12.5,
                        "model": "text"
                      }
                    }
                  ]
                }
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    },
    "/v1/el-nino": {
      "get": {
        "operationId": "getElNino",
        "tags": ["Sea and weather"],
        "summary": "el-nino",
        "description": "Updates every week. Coverage: tropical Pacific.\n\nHistory: The dataset is itself a record over time, so every answer is the whole history.\n\nLicence: US-public-domain.\n\nCredit: El Niño status and indices: NOAA Climate Prediction Center.\n\nEvent answers are capped at 50,000 rows.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "The answer’s format. GeoJSON is offered only where the rows have a position.",
            "schema": { "type": "string", "enum": ["json", "csv"], "default": "json" }
          },
          { "$ref": "#/components/parameters/IfNoneMatch" }
        ],
        "responses": {
          "200": {
            "description": "The data, with its credit in the headers and the body.",
            "headers": {
              "X-LE-Credit": { "$ref": "#/components/headers/X-LE-Credit" },
              "X-LE-Licence": { "$ref": "#/components/headers/X-LE-Licence" },
              "X-LE-Data-Time": { "$ref": "#/components/headers/X-LE-Data-Time" },
              "X-LE-Calls-Left": { "$ref": "#/components/headers/X-LE-Calls-Left" },
              "X-LE-Calls-Reset": { "$ref": "#/components/headers/X-LE-Calls-Reset" },
              "X-LE-Calls-Used": { "$ref": "#/components/headers/X-LE-Calls-Used" },
              "X-LE-Next": { "$ref": "#/components/headers/X-LE-Next" },
              "ETag": { "$ref": "#/components/headers/ETag" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ElNinoAnswer" },
                "example": {
                  "dataset": "el-nino",
                  "credit": "El Niño status and indices: NOAA Climate Prediction Center.",
                  "licence": "US-public-domain",
                  "dataTime": "2026-11-11T09:00:00.000Z",
                  "rows": [
                    { "date": "2026-11-11", "index": "text", "season": "text", "sst": 12.5, "anomaly": 12.5 }
                  ]
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "Comment lines first (# credit, # licence, # data time), then the header row and the rows."
                },
                "example": "# credit: El Niño status and indices: NOAA Climate Prediction Center.\n# licence: US-public-domain\n# data time: 2026-11-11T09:00:00.000Z\ndate,index,season,sst,anomaly\n2026-11-11,text,text,12.5,12.5"
              }
            }
          },
          "304": { "description": "Not changed since the ETag sent in If-None-Match. Counts as a call." },
          "400": { "$ref": "#/components/responses/E400" },
          "401": { "$ref": "#/components/responses/E401" },
          "403": { "$ref": "#/components/responses/E403" },
          "410": { "$ref": "#/components/responses/E410" },
          "429": { "$ref": "#/components/responses/E429" },
          "503": { "$ref": "#/components/responses/E503" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "le_live_…",
        "description": "A key made in your account panel at askthe.earth, sent as `Authorization: Bearer le_live_…`. A key in the URL is refused with `key_in_query`."
      }
    },
    "parameters": {
      "IfNoneMatch": {
        "name": "If-None-Match",
        "in": "header",
        "description": "An ETag from an earlier answer. A match gets 304, which still counts as a call.",
        "schema": { "type": "string" }
      }
    },
    "headers": {
      "X-LE-Credit": {
        "description": "The dataset’s credit line, ASCII-safe (RFC 8187 encoding where needed). Show it with the data.",
        "schema": { "type": "string" }
      },
      "X-LE-Licence": {
        "description": "The licence the data is served under.",
        "schema": { "type": "string" }
      },
      "X-LE-Data-Time": {
        "description": "When the data was taken, ISO 8601 UTC.",
        "schema": { "type": "string", "format": "date-time" }
      },
      "X-LE-Calls-Left": { "description": "Calls this key has left today.", "schema": { "type": "integer" } },
      "X-LE-Calls-Reset": {
        "description": "When the count starts again: UK midnight, ISO 8601.",
        "schema": { "type": "string", "format": "date-time" }
      },
      "X-LE-Calls-Used": {
        "description": "Range reads only: the calls this answer counted. A grid range counts one per 24 time steps read.",
        "schema": { "type": "integer" }
      },
      "X-LE-Next": {
        "description": "Event range reads past 50,000 rows only: the `since` to ask for next to carry on.",
        "schema": { "type": "string" }
      },
      "ETag": {
        "description": "Send it back as If-None-Match to get a 304.",
        "schema": { "type": "string" }
      },
      "Retry-After": {
        "description": "Seconds to wait before trying again.",
        "schema": { "type": "integer" }
      }
    },
    "responses": {
      "E400": {
        "description": "`bad_query`: A parameter is malformed or out of range. The message names it.\n\n`key_in_query`: The key was put in the URL. Send it in the Authorization header instead.\n\n`no_location`: GeoJSON was asked for on a dataset whose rows have no position.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "bad_query": {
                "summary": "bad_query",
                "value": {
                  "error": "bad_query",
                  "message": "A parameter is malformed or out of range. The message names it."
                }
              },
              "key_in_query": {
                "summary": "key_in_query",
                "value": {
                  "error": "key_in_query",
                  "message": "The key was put in the URL. Send it in the Authorization header instead."
                }
              },
              "no_location": {
                "summary": "no_location",
                "value": {
                  "error": "no_location",
                  "message": "GeoJSON was asked for on a dataset whose rows have no position."
                }
              }
            }
          }
        }
      },
      "E401": {
        "description": "`bad_key`: The key is missing, malformed, wrong or deleted. All four get the same answer.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "bad_key": {
                "summary": "bad_key",
                "value": {
                  "error": "bad_key",
                  "message": "The key is missing, malformed, wrong or deleted. All four get the same answer."
                }
              }
            }
          }
        }
      },
      "E403": {
        "description": "`not_pro`: The key is real but its account isn’t on Pro now. Going back to Pro brings it back.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "not_pro": {
                "summary": "not_pro",
                "value": {
                  "error": "not_pro",
                  "message": "The key is real but its account isn’t on Pro now. Going back to Pro brings it back."
                }
              }
            }
          }
        }
      },
      "E404": {
        "description": "`no_dataset`: There is no dataset by that name.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "no_dataset": {
                "summary": "no_dataset",
                "value": { "error": "no_dataset", "message": "There is no dataset by that name." }
              }
            }
          }
        }
      },
      "E410": {
        "description": "`withdrawn`: The dataset was withdrawn. The answer says since when, and why.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "withdrawn": {
                "summary": "withdrawn",
                "value": {
                  "error": "withdrawn",
                  "message": "The dataset was withdrawn. The answer says since when, and why."
                }
              }
            }
          }
        }
      },
      "E429": {
        "description": "`daily_limit`: The key has used its 10,000 calls today. resetsAt says when they come back.\n\n`slow_down`: Too many bad keys from one address. Wait, then try again.",
        "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" } },
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "daily_limit": {
                "summary": "daily_limit",
                "value": {
                  "error": "daily_limit",
                  "message": "The key has used its 10,000 calls today. resetsAt says when they come back."
                }
              },
              "slow_down": {
                "summary": "slow_down",
                "value": {
                  "error": "slow_down",
                  "message": "Too many bad keys from one address. Wait, then try again."
                }
              }
            }
          }
        }
      },
      "E503": {
        "description": "`busy`: The service has reached its own daily ceiling, or has too many calls in hand just now. Retry-After says when to try again.\n\n`data_stale`: The source hasn’t updated for over twice its usual time. dataTime says how old it is.",
        "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" } },
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "busy": {
                "summary": "busy",
                "value": {
                  "error": "busy",
                  "message": "The service has reached its own daily ceiling, or has too many calls in hand just now. Retry-After says when to try again."
                }
              },
              "data_stale": {
                "summary": "data_stale",
                "value": {
                  "error": "data_stale",
                  "message": "The source hasn’t updated for over twice its usual time. dataTime says how old it is."
                }
              }
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": ["error", "message"],
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "bad_query",
              "key_in_query",
              "no_location",
              "bad_key",
              "not_pro",
              "no_dataset",
              "withdrawn",
              "daily_limit",
              "slow_down",
              "busy",
              "data_stale"
            ]
          },
          "message": { "type": "string", "description": "Plain words." },
          "resetsAt": {
            "type": "string",
            "format": "date-time",
            "description": "daily_limit only: UK midnight, when the calls come back."
          },
          "since": {
            "type": ["string", "null"],
            "description": "withdrawn only: when the dataset was withdrawn."
          },
          "dataTime": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "data_stale only: when the data was last taken."
          }
        }
      },
      "Health": {
        "type": "object",
        "required": ["ok", "data"],
        "properties": {
          "ok": { "type": "boolean" },
          "data": { "type": "object", "additionalProperties": { "type": ["integer", "null"] } }
        }
      },
      "Field": {
        "type": "object",
        "required": ["name", "type", "about"],
        "properties": {
          "name": { "type": "string" },
          "type": {
            "type": "string",
            "enum": ["string", "number", "integer", "boolean", "time", "date", "geometry"]
          },
          "unit": { "type": "string" },
          "about": { "type": "string" }
        }
      },
      "DatasetList": {
        "type": "object",
        "required": ["datasets"],
        "properties": {
          "datasets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "group": { "type": "string", "enum": ["hazards", "energy", "air-water", "sea-weather"] },
                "kind": { "type": "string", "enum": ["events", "stations", "grid", "series"] },
                "state": { "type": "string", "enum": ["on-sale", "withdrawn"] },
                "formats": {
                  "type": "array",
                  "items": { "type": "string", "enum": ["json", "csv", "geojson"] }
                },
                "credit": { "type": "string" },
                "licence": { "type": "string" },
                "updates": { "type": "string" },
                "coverage": { "type": "string" },
                "archive": { "type": "string", "enum": ["forever", "year", "flash-31d", "none", "n/a"] },
                "fields": { "type": "array", "items": { "$ref": "#/components/schemas/Field" } }
              }
            }
          }
        }
      },
      "QuakesRow": {
        "type": "object",
        "title": "quakes row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "USGS event id" },
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the quake began"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "magnitude": { "type": ["number", "null"], "description": "Magnitude as USGS gives it, to 0.01" },
          "depthKm": {
            "type": ["number", "null"],
            "description": "Depth below the surface, to the metre (km)"
          },
          "place": { "type": ["string", "null"], "description": "USGS's description of where it was" },
          "firstSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive first saw it. Range reads only."
          },
          "lastSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive last saw it. Range reads only."
          }
        }
      },
      "QuakesAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "quakes" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/QuakesRow" } }
        }
      },
      "QuakesFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "quakes" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/QuakesRow" }
              }
            }
          }
        }
      },
      "VolcanoesUsRow": {
        "type": "object",
        "title": "volcanoes-us row",
        "properties": {
          "vn": { "type": ["integer", "null"], "description": "Smithsonian volcano number" },
          "name": { "type": ["string", "null"], "description": "Volcano name" },
          "lat": {
            "type": ["number", "null"],
            "description": "Latitude, WGS84, or null when HANS gives no position (degrees)"
          },
          "lon": {
            "type": ["number", "null"],
            "description": "Longitude, WGS84, or null when HANS gives no position (degrees)"
          },
          "colour": {
            "type": ["string", "null"],
            "description": "Aviation colour code: GREEN, YELLOW, ORANGE, RED or UNASSIGNED"
          },
          "alert": {
            "type": ["string", "null"],
            "description": "Volcano alert level: NORMAL, ADVISORY, WATCH, WARNING or UNASSIGNED"
          },
          "sent": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the notice was sent"
          },
          "noticeUrl": { "type": ["string", "null"], "description": "Link to the USGS notice" },
          "firstSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive first saw it. Range reads only."
          },
          "lastSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive last saw it. Range reads only."
          }
        }
      },
      "VolcanoesUsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "volcanoes-us" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/VolcanoesUsRow" } }
        }
      },
      "VolcanoesUsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "volcanoes-us" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/VolcanoesUsRow" }
              }
            }
          }
        }
      },
      "FiresRow": {
        "type": "object",
        "title": "fires row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "The detection's id, the same as the map's" },
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the satellite saw the fire"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "frp": {
            "type": ["number", "null"],
            "description": "Fire radiative power, to 0.1 (stored up to 6,553.5) (MW)"
          },
          "confidence": {
            "type": ["string", "null"],
            "description": "Detection confidence: low, nominal or high, or null when FIRMS gave none"
          },
          "firstSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive first saw it. Range reads only."
          },
          "lastSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive last saw it. Range reads only."
          }
        }
      },
      "FiresAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "fires" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/FiresRow" } }
        }
      },
      "FiresFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "fires" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/FiresRow" }
              }
            }
          }
        }
      },
      "LightningRow": {
        "type": "object",
        "title": "lightning row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Time of the flash's first optical event"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84, to 0.01 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84, to 0.01 (degrees)" },
          "durationMs": {
            "type": ["integer", "null"],
            "description": "First to last optical event (stored up to 65,535) (ms)"
          },
          "areaKm2": {
            "type": ["integer", "null"],
            "description": "Area the flash lit (stored up to 65,535) (km²)"
          },
          "intensity": {
            "type": ["integer", "null"],
            "description": "Relative optical energy, 0 to 255, 32 steps per tenfold above the sensor's floor. Compare within one source only"
          },
          "source": {
            "type": ["string", "null"],
            "description": "glm-east (GOES-East), glm-west (GOES-West) or li (Meteosat MTG Lightning Imager)"
          },
          "count": {
            "type": ["integer", "null"],
            "description": "Flashes in the cell that hour, held at 65,535. Range reads that start more than 31 days back, as hourly 0.25° cells, only."
          }
        }
      },
      "LightningAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "lightning" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/LightningRow" } }
        }
      },
      "LightningFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "lightning" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/LightningRow" }
              }
            }
          }
        }
      },
      "FloodWarningsRow": {
        "type": "object",
        "title": "flood-warnings row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Environment Agency flood area id" },
          "area": { "type": ["string", "null"], "description": "Flood area name" },
          "severity": {
            "type": ["string", "null"],
            "description": "Severe flood warning, Flood warning, Flood alert or Warning no longer in force"
          },
          "severityLevel": {
            "type": ["integer", "null"],
            "description": "The Environment Agency's severity level, 1 (severe) to 4 (no longer in force)"
          },
          "message": { "type": ["string", "null"], "description": "The Environment Agency's message" },
          "raised": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the warning was raised"
          },
          "changed": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When it last changed"
          },
          "outline": {
            "type": ["object", "null"],
            "description": "The area, simplified, as a GeoJSON MultiPolygon, or null when the EA gives none. A GeoJSON geometry."
          },
          "firstSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive first saw it. Range reads only."
          },
          "lastSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive last saw it. Range reads only."
          }
        }
      },
      "FloodWarningsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "flood-warnings" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/FloodWarningsRow" } }
        }
      },
      "FloodWarningsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "flood-warnings" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/FloodWarningsRow" }
              }
            }
          }
        }
      },
      "GenerationMixRow": {
        "type": "object",
        "title": "generation-mix row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Start of the five minutes"
          },
          "fuel": {
            "type": ["string", "null"],
            "description": "Fuel: coal, gas, oil, nuclear, hydro, wind, biomass or other (pumped storage is other). Imports are the interconnectors dataset"
          },
          "mw": {
            "type": ["number", "null"],
            "description": "Transmission-metered generation (embedded solar and wind are not in it) (MW)"
          }
        }
      },
      "GenerationMixAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "generation-mix" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/GenerationMixRow" } }
        }
      },
      "CarbonNationalRow": {
        "type": "object",
        "title": "carbon-national row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Start of the half hour"
          },
          "intensity": {
            "type": ["number", "null"],
            "description": "Carbon intensity of generation (gCO2/kWh)"
          },
          "gas": { "type": ["number", "null"], "description": "Gas, or null when NESO gives none (MW)" },
          "coal": { "type": ["number", "null"], "description": "Coal, or null when NESO gives none (MW)" },
          "nuclear": {
            "type": ["number", "null"],
            "description": "Nuclear, or null when NESO gives none (MW)"
          },
          "wind": { "type": ["number", "null"], "description": "Wind, as NESO gives it, or null (MW)" },
          "windEmbedded": {
            "type": ["number", "null"],
            "description": "Embedded wind, as NESO gives it beside wind, or null (MW)"
          },
          "hydro": { "type": ["number", "null"], "description": "Hydro, or null when NESO gives none (MW)" },
          "imports": {
            "type": ["number", "null"],
            "description": "Imports, or null when NESO gives none (MW)"
          },
          "biomass": {
            "type": ["number", "null"],
            "description": "Biomass, or null when NESO gives none (MW)"
          },
          "other": { "type": ["number", "null"], "description": "Other, or null when NESO gives none (MW)" },
          "solar": { "type": ["number", "null"], "description": "Solar, or null when NESO gives none (MW)" },
          "storage": {
            "type": ["number", "null"],
            "description": "Storage, or null when NESO gives none (MW)"
          },
          "generation": { "type": ["number", "null"], "description": "NESO's total generation, or null (MW)" }
        }
      },
      "CarbonNationalAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "carbon-national" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/CarbonNationalRow" } }
        }
      },
      "InterconnectorsRow": {
        "type": "object",
        "title": "interconnectors row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Start of the five minutes"
          },
          "link": {
            "type": ["string", "null"],
            "description": "Interconnector, as Elexon's FUELINST names it (INTFR, INTNSL and so on)"
          },
          "mw": { "type": ["number", "null"], "description": "Flow, positive into GB (MW)" }
        }
      },
      "InterconnectorsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "interconnectors" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/InterconnectorsRow" } }
        }
      },
      "PowerCutsRow": {
        "type": "object",
        "title": "power-cuts row",
        "properties": {
          "operator": { "type": ["string", "null"], "description": "Network operator: ukpn, ssen or enwl" },
          "id": { "type": ["string", "null"], "description": "The operator's incident reference" },
          "districts": {
            "type": ["string", "null"],
            "description": "Postcode districts affected, comma separated"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, rounded to 0.01° (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, rounded to 0.01° (degrees)" },
          "customers": { "type": ["integer", "null"], "description": "Customers off supply (5 or more)" },
          "planned": { "type": ["boolean", "null"], "description": "True for planned work" },
          "start": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When it began, or null"
          },
          "restoreBy": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "The operator's estimated restoration, or null"
          },
          "text": { "type": ["string", "null"], "description": "The operator's latest update" },
          "firstSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive first saw it. Range reads only."
          },
          "lastSeen": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the archive last saw it. Range reads only."
          }
        }
      },
      "PowerCutsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "power-cuts" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/PowerCutsRow" } }
        }
      },
      "PowerCutsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "power-cuts" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/PowerCutsRow" }
              }
            }
          }
        }
      },
      "WindFarmsRow": {
        "type": "object",
        "title": "wind-farms row",
        "properties": {
          "unit": { "type": ["string", "null"], "description": "Balancing Mechanism unit id" },
          "name": { "type": ["string", "null"], "description": "Wind farm name" },
          "lat": {
            "type": ["number", "null"],
            "description": "Site point from the REPD, which can be tens of km from the turbines (degrees)"
          },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "offshore": { "type": ["boolean", "null"], "description": "True for an offshore farm" },
          "region": {
            "type": ["string", "null"],
            "description": "Distribution region the farm connects in, or null"
          },
          "mw": {
            "type": ["number", "null"],
            "description": "Notified output (not metered), or the accepted level when curtailed (MW)"
          },
          "curtailed": {
            "type": ["boolean", "null"],
            "description": "True when mw is an accepted bid or offer level"
          },
          "period": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Start of the settlement period"
          }
        }
      },
      "WindFarmsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "wind-farms" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/WindFarmsRow" } }
        }
      },
      "WindFarmsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "wind-farms" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/WindFarmsRow" }
              }
            }
          }
        }
      },
      "AirUkRow": {
        "type": "object",
        "title": "air-uk row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Defra's site code" },
          "name": { "type": ["string", "null"], "description": "Site name" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "index": {
            "type": ["integer", "null"],
            "description": "Daily Air Quality Index, 1 to 10, or null"
          },
          "pm25": { "type": ["number", "null"], "description": "PM2.5, or null when not measured (µg/m³)" },
          "pm10": { "type": ["number", "null"], "description": "PM10, or null when not measured (µg/m³)" },
          "no2": {
            "type": ["number", "null"],
            "description": "Nitrogen dioxide, or null when not measured (µg/m³)"
          },
          "o3": { "type": ["number", "null"], "description": "Ozone, or null when not measured (µg/m³)" },
          "so2": {
            "type": ["number", "null"],
            "description": "Sulphur dioxide, or null when not measured (µg/m³)"
          },
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "The hour the readings are for"
          }
        }
      },
      "AirUkAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "air-uk" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AirUkRow" } }
        }
      },
      "AirUkFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "air-uk" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/AirUkRow" }
              }
            }
          }
        }
      },
      "AirWorldRow": {
        "type": "object",
        "title": "air-world row",
        "properties": {
          "id": { "type": ["integer", "null"], "description": "OpenAQ location id" },
          "name": { "type": ["string", "null"], "description": "Station name" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "index": {
            "type": ["integer", "null"],
            "description": "Indicative index on the UK DAQI scale, or null"
          },
          "pm25": { "type": ["number", "null"], "description": "PM2.5, or null when not measured (µg/m³)" },
          "pm10": { "type": ["number", "null"], "description": "PM10, or null when not measured (µg/m³)" },
          "no2": {
            "type": ["number", "null"],
            "description": "Nitrogen dioxide, or null when not measured (µg/m³)"
          },
          "o3": { "type": ["number", "null"], "description": "Ozone, or null when not measured (µg/m³)" },
          "so2": {
            "type": ["number", "null"],
            "description": "Sulphur dioxide, or null when not measured (µg/m³)"
          },
          "time": { "type": ["string", "null"], "format": "date-time", "description": "Newest reading" },
          "provider": { "type": ["string", "null"], "description": "Data provider" },
          "providerLicence": { "type": ["string", "null"], "description": "The provider's licence" },
          "providerCredit": { "type": ["string", "null"], "description": "The provider's credit, or null" }
        }
      },
      "AirWorldAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "air-world" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AirWorldRow" } }
        }
      },
      "AirWorldFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "air-world" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/AirWorldRow" }
              }
            }
          }
        }
      },
      "AirForecastUkRow": {
        "type": "object",
        "title": "air-forecast-uk row",
        "properties": {
          "place": { "type": ["string", "null"], "description": "Forecast place" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "day": { "type": ["string", "null"], "format": "date", "description": "UK day" },
          "index": {
            "type": ["integer", "null"],
            "description": "Forecast Daily Air Quality Index, 1 to 10"
          },
          "issued": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When Defra issued the forecast. Range reads only."
          }
        }
      },
      "AirForecastUkAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "air-forecast-uk" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AirForecastUkRow" } }
        }
      },
      "AirMapsRow": {
        "type": "object",
        "title": "air-maps row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "pm25": { "type": ["number", "null"], "description": "Surface PM2.5 (µg/m³)" },
          "dustAod": { "type": ["number", "null"], "description": "Dust aerosol optical depth at 550 nm" },
          "smokeAod": {
            "type": ["number", "null"],
            "description": "Smoke (organic matter plus black carbon) aerosol optical depth at 550 nm"
          },
          "uvIndex": { "type": ["number", "null"], "description": "UV index" }
        }
      },
      "AirMapsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "air-maps" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AirMapsRow" } }
        }
      },
      "RiversRow": {
        "type": "object",
        "title": "rivers row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Environment Agency station reference" },
          "label": { "type": ["string", "null"], "description": "Gauge name" },
          "river": { "type": ["string", "null"], "description": "River, or null" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "level": { "type": ["number", "null"], "description": "Latest level (m)" },
          "state": { "type": ["string", "null"], "description": "Level against the typical range" },
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the level was read"
          },
          "typicalLow": { "type": ["number", "null"], "description": "Typical range, low, or null (m)" },
          "typicalHigh": { "type": ["number", "null"], "description": "Typical range, high, or null (m)" }
        }
      },
      "RiversAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "rivers" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/RiversRow" } }
        }
      },
      "RiversFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "rivers" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/RiversRow" }
              }
            }
          }
        }
      },
      "BathingWaterRow": {
        "type": "object",
        "title": "bathing-water row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Bathing water id" },
          "name": { "type": ["string", "null"], "description": "Bathing water" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "grade": { "type": ["string", "null"], "description": "Latest yearly classification, or null" },
          "gradeYear": { "type": ["integer", "null"], "description": "Year of that classification, or null" },
          "sampleTime": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Latest sample, or null"
          },
          "ecoli": {
            "type": ["number", "null"],
            "description": "E. coli in that sample, or null (per 100 ml)"
          },
          "enterococci": {
            "type": ["number", "null"],
            "description": "Intestinal enterococci in that sample, or null (per 100 ml)"
          },
          "risk": {
            "type": ["string", "null"],
            "description": "Pollution risk forecast in season: normal, increased or null"
          },
          "riskDate": {
            "type": ["string", "null"],
            "format": "date",
            "description": "Day the forecast is for, or null"
          }
        }
      },
      "BathingWaterAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "bathing-water" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/BathingWaterRow" } }
        }
      },
      "BathingWaterFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "bathing-water" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/BathingWaterRow" }
              }
            }
          }
        }
      },
      "SewageOverflowsRow": {
        "type": "object",
        "title": "sewage-overflows row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "The company's overflow id" },
          "company": { "type": ["string", "null"], "description": "Water company" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "status": { "type": ["string", "null"], "description": "spilling, stopped or offline" },
          "statusStart": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the status began"
          },
          "latestEventStart": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "Start of the latest event, or null"
          },
          "latestEventEnd": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "End of the latest event, or null"
          },
          "receivingWater": { "type": ["string", "null"], "description": "Where it discharges, or null" },
          "lastUpdated": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the company last updated it"
          },
          "stale": {
            "type": ["boolean", "null"],
            "description": "True when the company's feed hasn't answered lately"
          }
        }
      },
      "SewageOverflowsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "sewage-overflows" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/SewageOverflowsRow" } }
        }
      },
      "SewageOverflowsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "sewage-overflows" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/SewageOverflowsRow" }
              }
            }
          }
        }
      },
      "SewageAnnualRow": {
        "type": "object",
        "title": "sewage-annual row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Overflow id in the return" },
          "company": { "type": ["string", "null"], "description": "Water company" },
          "year": { "type": ["integer", "null"], "description": "Calendar year" },
          "spills": { "type": ["integer", "null"], "description": "Spills counted that year" },
          "hours": { "type": ["number", "null"], "description": "Hours spilling that year (h)" }
        }
      },
      "SewageAnnualAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "sewage-annual" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/SewageAnnualRow" } }
        }
      },
      "WavesRow": {
        "type": "object",
        "title": "waves row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "height": {
            "type": ["number", "null"],
            "description": "Significant wave height, null on the model's land (m)"
          },
          "period": { "type": ["number", "null"], "description": "Period of the primary waves (s)" },
          "direction": {
            "type": ["number", "null"],
            "description": "Direction the primary waves come from (degrees)"
          },
          "swell1Height": {
            "type": ["number", "null"],
            "description": "First swell: significant height, or null (m)"
          },
          "swell1Period": { "type": ["number", "null"], "description": "First swell: period, or null (s)" },
          "swell1Direction": {
            "type": ["number", "null"],
            "description": "First swell: direction it comes from, or null (degrees)"
          },
          "swell2Height": {
            "type": ["number", "null"],
            "description": "Second swell: significant height, or null (m)"
          },
          "swell2Period": { "type": ["number", "null"], "description": "Second swell: period, or null (s)" },
          "swell2Direction": {
            "type": ["number", "null"],
            "description": "Second swell: direction it comes from, or null (degrees)"
          },
          "windSeaHeight": {
            "type": ["number", "null"],
            "description": "Wind sea: significant height, or null (m)"
          },
          "windSeaPeriod": { "type": ["number", "null"], "description": "Wind sea: period, or null (s)" },
          "windSeaDirection": {
            "type": ["number", "null"],
            "description": "Wind sea: direction it comes from, or null (degrees)"
          }
        }
      },
      "WavesAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "waves" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/WavesRow" } }
        }
      },
      "SeaTemperatureRow": {
        "type": "object",
        "title": "sea-temperature row",
        "properties": {
          "day": { "type": ["string", "null"], "format": "date", "description": "Day of the analysis" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "sst": {
            "type": ["number", "null"],
            "description": "Sea surface temperature, null on the analysis's land and sea ice (°C)"
          },
          "anomaly": {
            "type": ["number", "null"],
            "description": "Against our 1991 to 2020 climatology, or null (°C)"
          },
          "heatwave": {
            "type": ["integer", "null"],
            "description": "Marine heatwave category: 0 none, 1 moderate, 2 strong, 3 severe, 4 extreme"
          }
        }
      },
      "SeaTemperatureAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "sea-temperature" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/SeaTemperatureRow" } }
        }
      },
      "CurrentsRow": {
        "type": "object",
        "title": "currents row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "u": {
            "type": ["number", "null"],
            "description": "Eastward surface current, null on the model's land (m/s)"
          },
          "v": {
            "type": ["number", "null"],
            "description": "Northward surface current, null on the model's land (m/s)"
          }
        }
      },
      "CurrentsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "currents" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/CurrentsRow" } }
        }
      },
      "WeatherRow": {
        "type": "object",
        "title": "weather row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "temperature": { "type": ["number", "null"], "description": "Air temperature at 2 m (°C)" },
          "windU": { "type": ["number", "null"], "description": "Eastward wind at 10 m (m/s)" },
          "windV": { "type": ["number", "null"], "description": "Northward wind at 10 m (m/s)" },
          "precipitation": { "type": ["number", "null"], "description": "Precipitation rate, or null (mm/h)" }
        }
      },
      "WeatherAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "weather" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/WeatherRow" } }
        }
      },
      "PointForecastRow": {
        "type": "object",
        "title": "point-forecast row",
        "properties": {
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "temperature": { "type": ["number", "null"], "description": "Air temperature at 2 m (°C)" },
          "windSpeed": { "type": ["number", "null"], "description": "Wind at 10 m (m/s)" },
          "windDirection": {
            "type": ["number", "null"],
            "description": "Direction the wind comes from (degrees)"
          },
          "precipitation": { "type": ["number", "null"], "description": "Precipitation rate (mm/h)" }
        }
      },
      "PointForecastAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "point-forecast" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/PointForecastRow" } }
        }
      },
      "SurfSpotsRow": {
        "type": "object",
        "title": "surf-spots row",
        "properties": {
          "id": { "type": ["string", "null"], "description": "Spot id" },
          "name": { "type": ["string", "null"], "description": "Spot name" },
          "lat": { "type": ["number", "null"], "description": "Latitude, WGS84 (degrees)" },
          "lon": { "type": ["number", "null"], "description": "Longitude, WGS84 (degrees)" },
          "time": {
            "type": ["string", "null"],
            "format": "date-time",
            "description": "When the value is for"
          },
          "surfLow": {
            "type": ["number", "null"],
            "description": "Surf height at the spot, low end of the range (m)"
          },
          "surfHigh": {
            "type": ["number", "null"],
            "description": "Surf height at the spot, high end of the range (m)"
          },
          "swell1Height": {
            "type": ["number", "null"],
            "description": "First swell: significant height, or null (m)"
          },
          "swell1Period": { "type": ["number", "null"], "description": "First swell: period, or null (s)" },
          "swell1Direction": {
            "type": ["number", "null"],
            "description": "First swell: direction it comes from, or null (degrees)"
          },
          "swell2Height": {
            "type": ["number", "null"],
            "description": "Second swell: significant height, or null (m)"
          },
          "swell2Period": { "type": ["number", "null"], "description": "Second swell: period, or null (s)" },
          "swell2Direction": {
            "type": ["number", "null"],
            "description": "Second swell: direction it comes from, or null (degrees)"
          },
          "windSeaHeight": {
            "type": ["number", "null"],
            "description": "Wind sea: significant height, or null (m)"
          },
          "windSeaPeriod": { "type": ["number", "null"], "description": "Wind sea: period, or null (s)" },
          "windSeaDirection": {
            "type": ["number", "null"],
            "description": "Wind sea: direction it comes from, or null (degrees)"
          },
          "model": { "type": ["string", "null"], "description": "nws or ibi" }
        }
      },
      "SurfSpotsAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "surf-spots" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/SurfSpotsRow" } }
        }
      },
      "SurfSpotsFeatures": {
        "type": "object",
        "required": ["type", "properties", "features"],
        "properties": {
          "type": { "type": "string", "const": "FeatureCollection" },
          "properties": {
            "type": "object",
            "properties": {
              "dataset": { "type": "string", "const": "surf-spots" },
              "credit": { "type": "string" },
              "licence": { "type": "string" },
              "dataTime": { "type": "string", "format": "date-time" },
              "thinned": {
                "type": "boolean",
                "description": "Present and true when part of a range was thinned."
              },
              "archiveStart": {
                "type": "string",
                "format": "date",
                "description": "The first day the archive holds."
              }
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": { "type": "string", "const": "Feature" },
                "geometry": { "type": ["object", "null"] },
                "properties": { "$ref": "#/components/schemas/SurfSpotsRow" }
              }
            }
          }
        }
      },
      "ElNinoRow": {
        "type": "object",
        "title": "el-nino row",
        "properties": {
          "date": {
            "type": ["string", "null"],
            "format": "date",
            "description": "The week's centre, or the last day of the three-month season"
          },
          "index": { "type": ["string", "null"], "description": "nino12, nino3, nino34, nino4 or oni" },
          "season": {
            "type": ["string", "null"],
            "description": "Three-month season for oni rows, such as JAS, else null"
          },
          "sst": {
            "type": ["number", "null"],
            "description": "Weekly mean sea surface temperature in the box, null for oni (°C)"
          },
          "anomaly": { "type": ["number", "null"], "description": "Sea surface temperature anomaly (°C)" }
        }
      },
      "ElNinoAnswer": {
        "type": "object",
        "required": ["dataset", "credit", "licence", "dataTime", "rows"],
        "properties": {
          "dataset": { "type": "string", "const": "el-nino" },
          "credit": { "type": "string" },
          "licence": { "type": "string" },
          "dataTime": { "type": "string", "format": "date-time" },
          "thinned": {
            "type": "boolean",
            "description": "Present and true when part of a range was thinned."
          },
          "archiveStart": {
            "type": "string",
            "format": "date",
            "description": "The first day the archive holds."
          },
          "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ElNinoRow" } }
        }
      }
    }
  }
}
