The Ask the Earth API

The data behind the globe, as JSON, CSV or GeoJSON. There are 25 datasets: hazards, UK energy, air and water, and the sea and weather. The API comes with Pro, and each key gets 10,000 calls a day. You don't need an account to read this page.

Every answer carries its credit line and licence, in the headers and in the body, so a saved file keeps them. If you show the data anywhere, show the credit with it. The API terms say what else you agree to.

The data comes from public sources and can be late or wrong. Never use it as the only source for a safety decision. For floods, use the official flood warnings.

Your first call

  1. On Pro, open your account panel and make a key under API keys. Give it a name. The key is shown once, so copy it then.
  2. Call a dataset, with the key in the Authorization header:
    curl -H "Authorization: Bearer le_live_YOUR_KEY" \
      "https://api.askthe.earth/v1/quakes?format=geojson"
  3. Read the credit: it's in X-LE-Credit and in the body. X-LE-Calls-Left says how many calls the key has left today.
  4. Show the credit wherever the data appears.

A key in the URL is refused, so keys don't end up in logs or browser history. Lost one, or put it somewhere public by mistake? Delete it in the panel and make another. The old one stops at once.

Requests

GET /v1/datasets                          every dataset, with its fields, licence and credit
GET /v1/<dataset>?format=json|csv|geojson the latest data (json if format is left out)
    &bbox=w,s,e,n                         an area, west, south, east, north
    &near=lat,lon&km=N                    or a circle, 1 to 500 km
    &since=ISO&until=ISO                  a range from the archive
    &at=lat,lon                           grids only: the series at one point
GET /v1/health                            no key needed: how old each source is

GeoJSON is offered only where the rows have a position. A grid answer is capped at 250,000 cells, and an event answer at 50,000 rows, with a next cursor past that. Answers over 1 KB are gzipped when you accept it, and If-None-Match gets a 304 (which still counts as a call).

For code generators and API tools there's an OpenAPI 3.1 description of the same requests, answers and errors.

Calls a day

Each key gets 10,000 calls a day, and the count starts again at midnight UK time. A call that gets an answer counts once. A refusal doesn't count against the key. A grid range read counts one call for every 24 time steps it reads, and X-LE-Calls-Used says how many. The service also has its own daily ceiling across every key, so API traffic can never take the globe down. Past it, calls get 503 busy until midnight.

The archive

Quakes, US volcano notices, fires, flood warnings and power cuts are kept for as long as the service runs. Lightning is kept flash by flash for 31 days, and as counts per hour per 0.25° cell after that. Carbon intensity, the generation mix and the UK air quality forecast are kept for a year. The grids are kept for a year, and after 31 days they're thinned to every 6 hours. A thinned answer says thinned, and a range that starts before the archive did says archiveStart, the first day it holds. Each dataset below says how far back it goes.

Errors

Every refusal is JSON, { "error": code, "message": plain words }.

Status error When
400 bad_query A parameter is malformed or out of range. The message names it.
400 key_in_query The key was put in the URL. Send it in the Authorization header instead.
400 no_location GeoJSON was asked for on a dataset whose rows have no position.
401 bad_key The key is missing, malformed, wrong or deleted. All four get the same answer.
403 not_pro The key is real but its account isn’t on Pro now. Going back to Pro brings it back.
404 no_dataset There is no dataset by that name.
410 withdrawn The dataset was withdrawn. The answer says since when, and why.
429 daily_limit The key has used its 10,000 calls today. resetsAt says when they come back.
429 slow_down Too many bad keys from one address. Wait, then try again.
503 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.
503 data_stale The source hasn’t updated for over twice its usual time. dataTime says how old it is.

Datasets

Gaps worth knowing about before you build on them:

DOIs to cite

Copernicus Marine asks for its product DOIs wherever the data is used. They're in the credit lines too.

Hazards

quakes

Updates every minute
Coverage world
History Kept for as long as the service runs. Ask with since and until.
Formats json, csv, geojson
Licence US-public-domain
Credit Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.

Fields

Field Type Unit What it is
id string USGS event id
time time When the quake began
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
magnitude number Magnitude as USGS gives it, to 0.01
depthKm number km Depth below the surface, to the metre
place string USGS's description of where it was

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/quakes?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/quakes?format=csv
# credit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.
# licence: US-public-domain
# data time: 2026-11-11T09:00:00.000Z
id,time,lat,lon,magnitude,depthKm,place
text,2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,text

GEOJSON

GET https://api.askthe.earth/v1/quakes?format=geojson
{
  "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"
      }
    }
  ]
}

volcanoes-us

Updates every 3 hours
Coverage US volcanoes only
History Kept for as long as the service runs. Ask with since and until.
Formats json, csv, geojson
Licence US-public-domain
Credit Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.

Fields

Field Type Unit What it is
vn integer Smithsonian volcano number
name string Volcano name
lat number degrees Latitude, WGS84, or null when HANS gives no position
lon number degrees Longitude, WGS84, or null when HANS gives no position
colour string Aviation colour code: GREEN, YELLOW, ORANGE, RED or UNASSIGNED
alert string Volcano alert level: NORMAL, ADVISORY, WATCH, WARNING or UNASSIGNED
sent time When the notice was sent
noticeUrl string Link to the USGS notice

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/volcanoes-us?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/volcanoes-us?format=csv
# credit: Earthquake data: U.S. Geological Survey (earthquake.usgs.gov). Volcano alert levels: U.S. Geological Survey Volcano Hazards Program.
# licence: US-public-domain
# data time: 2026-11-11T09:00:00.000Z
vn,name,lat,lon,colour,alert,sent,noticeUrl
3,text,50.42,-5.08,text,text,2026-11-11T09:00:00.000Z,text

GEOJSON

GET https://api.askthe.earth/v1/volcanoes-us?format=geojson
{
  "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"
      }
    }
  ]
}

fires

Updates every 2 hours
Coverage world
History Kept for as long as the service runs. Ask with since and until.
Formats json, csv, geojson
Licence NASA Earthdata open data
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).

Fields

Field Type Unit What it is
id string The detection's id, the same as the map's
time time When the satellite saw the fire
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
frp number MW Fire radiative power, to 0.1 (stored up to 6,553.5)
confidence string Detection confidence: low, nominal or high, or null when FIRMS gave none

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/fires?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/fires?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
id,time,lat,lon,frp,confidence
text,2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,text

GEOJSON

GET https://api.askthe.earth/v1/fires?format=geojson
{
  "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"
      }
    }
  ]
}

lightning

Updates every minute
Coverage the Americas, Europe and Africa (GOES and Meteosat views)
History 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.
Formats json, csv, geojson
Licence NOAA open data, CC-BY-4.0
Credit Lightning: NOAA GOES-East and GOES-West Geostationary Lightning Mapper (GLM) Contains modified EUMETSAT Meteosat data 2026

Fields

Field Type Unit What it is
time time Time of the flash's first optical event
lat number degrees Latitude, WGS84, to 0.01
lon number degrees Longitude, WGS84, to 0.01
durationMs integer ms First to last optical event (stored up to 65,535)
areaKm2 integer km² Area the flash lit (stored up to 65,535)
intensity integer Relative optical energy, 0 to 255, 32 steps per tenfold above the sensor's floor. Compare within one source only
source string glm-east (GOES-East), glm-west (GOES-West) or li (Meteosat MTG Lightning Imager)

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/lightning?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/lightning?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
time,lat,lon,durationMs,areaKm2,intensity,source
2026-11-11T09:00:00.000Z,50.42,-5.08,3,3,3,text

GEOJSON

GET https://api.askthe.earth/v1/lightning?format=geojson
{
  "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"
      }
    }
  ]
}

flood-warnings

Updates every 15 minutes
Coverage England
History Kept for as long as the service runs. Ask with since and until.
Formats json, csv, geojson
Licence OGL-UK-3.0
Credit Contains Environment Agency data licensed under the Open Government Licence v3.0.

Fields

Field Type Unit What it is
id string Environment Agency flood area id
area string Flood area name
severity string Severe flood warning, Flood warning, Flood alert or Warning no longer in force
severityLevel integer The Environment Agency's severity level, 1 (severe) to 4 (no longer in force)
message string The Environment Agency's message
raised time When the warning was raised
changed time When it last changed
outline geometry The area, simplified, as a GeoJSON MultiPolygon, or null when the EA gives none

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/flood-warnings?format=json
{
  "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
              ]
            ]
          ]
        ]
      }
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/flood-warnings?format=csv
# credit: Contains Environment Agency data licensed under the Open Government Licence v3.0.
# licence: OGL-UK-3.0
# data time: 2026-11-11T09:00:00.000Z
id,area,severity,severityLevel,message,raised,changed,outline
text,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]]]]}"

GEOJSON

GET https://api.askthe.earth/v1/flood-warnings?format=geojson
{
  "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
                ]
              ]
            ]
          ]
        }
      }
    }
  ]
}

UK energy

generation-mix

Updates every 5 minutes
Coverage GB
History Kept for a year, half hour by half hour, from NESO’s figures (embedded wind, solar and imports left out). Ask with since and until.
Formats json, csv
Licence BMRS data licence
Credit Contains BMRS data © Elexon Limited copyright and database right 2026.

Fields

Field Type Unit What it is
time time Start of the five minutes
fuel string Fuel: coal, gas, oil, nuclear, hydro, wind, biomass or other (pumped storage is other). Imports are the interconnectors dataset
mw number MW Transmission-metered generation (embedded solar and wind are not in it)

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/generation-mix?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/generation-mix?format=csv
# credit: Contains BMRS data © Elexon Limited copyright and database right 2026.
# licence: BMRS data licence
# data time: 2026-11-11T09:00:00.000Z
time,fuel,mw
2026-11-11T09:00:00.000Z,text,12.5

carbon-national

Updates every half hour
Coverage GB
History Kept for a year, half hour by half hour. Ask with since and until.
Formats json, csv
Licence NESO Open Data Licence
Credit Carbon intensity and generation mix, Great Britain: Supported by National Energy SO Open Data.

Fields

Field Type Unit What it is
time time Start of the half hour
intensity number gCO2/kWh Carbon intensity of generation
gas number MW Gas, or null when NESO gives none
coal number MW Coal, or null when NESO gives none
nuclear number MW Nuclear, or null when NESO gives none
wind number MW Wind, as NESO gives it, or null
windEmbedded number MW Embedded wind, as NESO gives it beside wind, or null
hydro number MW Hydro, or null when NESO gives none
imports number MW Imports, or null when NESO gives none
biomass number MW Biomass, or null when NESO gives none
other number MW Other, or null when NESO gives none
solar number MW Solar, or null when NESO gives none
storage number MW Storage, or null when NESO gives none
generation number MW NESO's total generation, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/carbon-national?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/carbon-national?format=csv
# credit: Carbon intensity and generation mix, Great Britain: Supported by National Energy SO Open Data.
# licence: NESO Open Data Licence
# data time: 2026-11-11T09:00:00.000Z
time,intensity,gas,coal,nuclear,wind,windEmbedded,hydro,imports,biomass,other,solar,storage,generation
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,12.5,12.5

interconnectors

Updates every 5 minutes
Coverage GB
History Latest only. No history is kept.
Formats json, csv
Licence BMRS data licence
Credit Contains BMRS data © Elexon Limited copyright and database right 2026.

Fields

Field Type Unit What it is
time time Start of the five minutes
link string Interconnector, as Elexon's FUELINST names it (INTFR, INTNSL and so on)
mw number MW Flow, positive into GB

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/interconnectors?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/interconnectors?format=csv
# credit: Contains BMRS data © Elexon Limited copyright and database right 2026.
# licence: BMRS data licence
# data time: 2026-11-11T09:00:00.000Z
time,link,mw
2026-11-11T09:00:00.000Z,text,12.5

power-cuts

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
History Kept for as long as the service runs. Ask with since and until.
Formats json, csv, geojson
Licence CC-BY-4.0
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).

Fields

Field Type Unit What it is
operator string Network operator: ukpn, ssen or enwl
id string The operator's incident reference
districts string Postcode districts affected, comma separated
lat number degrees Latitude, rounded to 0.01°
lon number degrees Longitude, rounded to 0.01°
customers integer Customers off supply (5 or more)
planned boolean True for planned work
start time When it began, or null
restoreBy time The operator's estimated restoration, or null
text string The operator's latest update

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/power-cuts?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/power-cuts?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
operator,id,districts,lat,lon,customers,planned,start,restoreBy,text
text,text,text,50.42,-5.08,3,false,2026-11-11T09:00:00.000Z,2026-11-11T09:00:00.000Z,text

GEOJSON

GET https://api.askthe.earth/v1/power-cuts?format=geojson
{
  "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"
      }
    }
  ]
}

wind-farms

Updates every half hour
Coverage GB
History Latest only. No history is kept.
Formats json, csv, geojson
Licence OGL-UK-3.0, BMRS data licence, NESO Open Data Licence
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.

Fields

Field Type Unit What it is
unit string Balancing Mechanism unit id
name string Wind farm name
lat number degrees Site point from the REPD, which can be tens of km from the turbines
lon number degrees Longitude, WGS84
offshore boolean True for an offshore farm
region string Distribution region the farm connects in, or null
mw number MW Notified output (not metered), or the accepted level when curtailed
curtailed boolean True when mw is an accepted bid or offer level
period time Start of the settlement period

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/wind-farms?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/wind-farms?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
unit,name,lat,lon,offshore,region,mw,curtailed,period
text,text,50.42,-5.08,false,text,12.5,false,2026-11-11T09:00:00.000Z

GEOJSON

GET https://api.askthe.earth/v1/wind-farms?format=geojson
{
  "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"
      }
    }
  ]
}

Air and water

air-uk

Updates every hour
Coverage UK
History Latest only. No history is kept.
Formats json, csv, geojson
Licence OGL-UK-3.0
Credit © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.

Fields

Field Type Unit What it is
id string Defra's site code
name string Site name
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
index integer Daily Air Quality Index, 1 to 10, or null
pm25 number µg/m³ PM2.5, or null when not measured
pm10 number µg/m³ PM10, or null when not measured
no2 number µg/m³ Nitrogen dioxide, or null when not measured
o3 number µg/m³ Ozone, or null when not measured
so2 number µg/m³ Sulphur dioxide, or null when not measured
time time The hour the readings are for

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/air-uk?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/air-uk?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
id,name,lat,lon,index,pm25,pm10,no2,o3,so2,time
text,text,50.42,-5.08,3,12.5,12.5,12.5,12.5,12.5,2026-11-11T09:00:00.000Z

GEOJSON

GET https://api.askthe.earth/v1/air-uk?format=geojson
{
  "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"
      }
    }
  ]
}

air-world

Updates every hour
Coverage world
History Latest only. No history is kept.
Formats json, csv, geojson
Licence per provider
Credit Data: OpenAQ (openaq.org), with each provider's own credit.

Fields

Field Type Unit What it is
id integer OpenAQ location id
name string Station name
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
index integer Indicative index on the UK DAQI scale, or null
pm25 number µg/m³ PM2.5, or null when not measured
pm10 number µg/m³ PM10, or null when not measured
no2 number µg/m³ Nitrogen dioxide, or null when not measured
o3 number µg/m³ Ozone, or null when not measured
so2 number µg/m³ Sulphur dioxide, or null when not measured
time time Newest reading
provider string Data provider
providerLicence string The provider's licence
providerCredit string The provider's credit, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/air-world?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/air-world?format=csv
# credit: Data: OpenAQ (openaq.org), with each provider's own credit.
# licence: per provider
# data time: 2026-11-11T09:00:00.000Z
id,name,lat,lon,index,pm25,pm10,no2,o3,so2,time,provider,providerLicence,providerCredit
3,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

GEOJSON

GET https://api.askthe.earth/v1/air-world?format=geojson
{
  "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"
      }
    }
  ]
}

air-forecast-uk

Updates every day
Coverage UK
History Each day’s forecast is kept for a year as Defra issued it, with an issued column. Ask with since and until.
Formats json, csv
Licence OGL-UK-3.0
Credit © Crown copyright 2026 Defra via uk-air.defra.gov.uk, licensed under the Open Government Licence v3.0. Forecast by the Met Office.

Fields

Field Type Unit What it is
place string Forecast place
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
day date UK day
index integer Forecast Daily Air Quality Index, 1 to 10

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/air-forecast-uk?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/air-forecast-uk?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
place,lat,lon,day,index
text,50.42,-5.08,2026-11-11,3

air-maps

Updates every day
Coverage world
History Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.
Formats json, csv
Licence CC-BY-4.0
Credit Contains modified Copernicus Atmosphere Monitoring Service information 2026. Neither the European Commission nor ECMWF is responsible for any use made of this information.

Fields

Field Type Unit What it is
time time When the value is for
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
pm25 number µg/m³ Surface PM2.5
dustAod number Dust aerosol optical depth at 550 nm
smokeAod number Smoke (organic matter plus black carbon) aerosol optical depth at 550 nm
uvIndex number UV index

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/air-maps?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/air-maps?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
time,lat,lon,pm25,dustAod,smokeAod,uvIndex
2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,12.5,12.5

rivers

Updates every 15 minutes
Coverage England
History Latest only. No history is kept.
Formats json, csv, geojson
Licence OGL-UK-3.0
Credit Contains Environment Agency data licensed under the Open Government Licence v3.0. Contains OS data © Crown Copyright and database rights 2026.

Fields

Field Type Unit What it is
id string Environment Agency station reference
label string Gauge name
river string River, or null
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
level number m Latest level
state string Level against the typical range
time time When the level was read
typicalLow number m Typical range, low, or null
typicalHigh number m Typical range, high, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/rivers?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/rivers?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
id,label,river,lat,lon,level,state,time,typicalLow,typicalHigh
text,text,text,50.42,-5.08,12.5,text,2026-11-11T09:00:00.000Z,12.5,12.5

GEOJSON

GET https://api.askthe.earth/v1/rivers?format=geojson
{
  "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
      }
    }
  ]
}

bathing-water

Updates every day
Coverage England
History Latest only. No history is kept.
Formats json, csv, geojson
Licence OGL-UK-3.0
Credit Contains Environment Agency data licensed under the Open Government Licence v3.0.

Fields

Field Type Unit What it is
id string Bathing water id
name string Bathing water
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
grade string Latest yearly classification, or null
gradeYear integer Year of that classification, or null
sampleTime time Latest sample, or null
ecoli number per 100 ml E. coli in that sample, or null
enterococci number per 100 ml Intestinal enterococci in that sample, or null
risk string Pollution risk forecast in season: normal, increased or null
riskDate date Day the forecast is for, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/bathing-water?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/bathing-water?format=csv
# credit: Contains Environment Agency data licensed under the Open Government Licence v3.0.
# licence: OGL-UK-3.0
# data time: 2026-11-11T09:00:00.000Z
id,name,lat,lon,grade,gradeYear,sampleTime,ecoli,enterococci,risk,riskDate
text,text,50.42,-5.08,text,3,2026-11-11T09:00:00.000Z,12.5,12.5,text,2026-11-11

GEOJSON

GET https://api.askthe.earth/v1/bathing-water?format=geojson
{
  "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"
      }
    }
  ]
}

sewage-overflows

Updates every 15 minutes
Coverage England, eight of the ten companies (not Southern Water or Welsh Water)
History Latest only. No history is kept.
Formats json, csv, geojson
Licence CC-BY-4.0
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.

Fields

Field Type Unit What it is
id string The company's overflow id
company string Water company
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
status string spilling, stopped or offline
statusStart time When the status began
latestEventStart time Start of the latest event, or null
latestEventEnd time End of the latest event, or null
receivingWater string Where it discharges, or null
lastUpdated time When the company last updated it
stale boolean True when the company's feed hasn't answered lately

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/sewage-overflows?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/sewage-overflows?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
id,company,lat,lon,status,statusStart,latestEventStart,latestEventEnd,receivingWater,lastUpdated,stale
text,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

GEOJSON

GET https://api.askthe.earth/v1/sewage-overflows?format=geojson
{
  "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
      }
    }
  ]
}

sewage-annual

Updates every year, in the autumn
Coverage England
History The dataset is itself a record over time, so every answer is the whole history.
Formats json, csv
Licence OGL-UK-3.0
Credit Contains Environment Agency information © Environment Agency and database right, licensed under the Open Government Licence v3.0.

Fields

Field Type Unit What it is
id string Overflow id in the return
company string Water company
year integer Calendar year
spills integer Spills counted that year
hours number h Hours spilling that year

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/sewage-annual?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/sewage-annual?format=csv
# credit: Contains Environment Agency information © Environment Agency and database right, licensed under the Open Government Licence v3.0.
# licence: OGL-UK-3.0
# data time: 2026-11-11T09:00:00.000Z
id,company,year,spills,hours
text,text,3,3,12.5

Sea and weather

waves

Updates every 6 hours
Coverage world
History Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.
Formats json, csv
Licence NOAA open data
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

Fields

Field Type Unit What it is
time time When the value is for
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
height number m Significant wave height, null on the model's land
period number s Period of the primary waves
direction number degrees Direction the primary waves come from
swell1Height number m First swell: significant height, or null
swell1Period number s First swell: period, or null
swell1Direction number degrees First swell: direction it comes from, or null
swell2Height number m Second swell: significant height, or null
swell2Period number s Second swell: period, or null
swell2Direction number degrees Second swell: direction it comes from, or null
windSeaHeight number m Wind sea: significant height, or null
windSeaPeriod number s Wind sea: period, or null
windSeaDirection number degrees Wind sea: direction it comes from, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/waves?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/waves?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
time,lat,lon,height,period,direction,swell1Height,swell1Period,swell1Direction,swell2Height,swell2Period,swell2Direction,windSeaHeight,windSeaPeriod,windSeaDirection
2026-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

sea-temperature

Updates every day
Coverage world
History Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.
Formats json, csv
Licence US-public-domain
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.

Fields

Field Type Unit What it is
day date Day of the analysis
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
sst number °C Sea surface temperature, null on the analysis's land and sea ice
anomaly number °C Against our 1991 to 2020 climatology, or null
heatwave integer Marine heatwave category: 0 none, 1 moderate, 2 strong, 3 severe, 4 extreme

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/sea-temperature?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/sea-temperature?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
day,lat,lon,sst,anomaly,heatwave
2026-11-11,50.42,-5.08,12.5,12.5,3

currents

Updates every day
Coverage world
History Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.
Formats json, csv
Licence NOAA open data
Credit Ocean currents: NOAA Global Real-Time Ocean Forecast System (RTOFS), resampled to 0.25°

Fields

Field Type Unit What it is
time time When the value is for
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
u number m/s Eastward surface current, null on the model's land
v number m/s Northward surface current, null on the model's land

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/currents?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/currents?format=csv
# credit: Ocean currents: NOAA Global Real-Time Ocean Forecast System (RTOFS), resampled to 0.25°
# licence: NOAA open data
# data time: 2026-11-11T09:00:00.000Z
time,lat,lon,u,v
2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5

weather

Updates every 6 hours
Coverage world
History Kept for a year: every 3 hours (or the source’s own step) for 31 days, then 6-hourly.
Formats json, csv
Licence NOAA open data
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

Fields

Field Type Unit What it is
time time When the value is for
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
temperature number °C Air temperature at 2 m
windU number m/s Eastward wind at 10 m
windV number m/s Northward wind at 10 m
precipitation number mm/h Precipitation rate, or null

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/weather?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/weather?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
time,lat,lon,temperature,windU,windV,precipitation
2026-11-11T09:00:00.000Z,50.42,-5.08,12.5,12.5,12.5,12.5

point-forecast

Updates every 6 hours
Coverage world
History Latest only. No history is kept.
Formats json, csv
Licence NOAA open data
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

Fields

Field Type Unit What it is
time time When the value is for
temperature number °C Air temperature at 2 m
windSpeed number m/s Wind at 10 m
windDirection number degrees Direction the wind comes from
precipitation number mm/h Precipitation rate

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/point-forecast?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/point-forecast?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
time,temperature,windSpeed,windDirection,precipitation
2026-11-11T09:00:00.000Z,12.5,12.5,12.5,12.5

surf-spots

Updates every 6 hours
Coverage Cornwall surf spots
History Latest only. No history is kept.
Formats json, csv, geojson
Licence Copernicus Marine Service licence
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.

Fields

Field Type Unit What it is
id string Spot id
name string Spot name
lat number degrees Latitude, WGS84
lon number degrees Longitude, WGS84
time time When the value is for
surfLow number m Surf height at the spot, low end of the range
surfHigh number m Surf height at the spot, high end of the range
swell1Height number m First swell: significant height, or null
swell1Period number s First swell: period, or null
swell1Direction number degrees First swell: direction it comes from, or null
swell2Height number m Second swell: significant height, or null
swell2Period number s Second swell: period, or null
swell2Direction number degrees Second swell: direction it comes from, or null
windSeaHeight number m Wind sea: significant height, or null
windSeaPeriod number s Wind sea: period, or null
windSeaDirection number degrees Wind sea: direction it comes from, or null
model string nws or ibi

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/surf-spots?format=json
{
  "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"
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/surf-spots?format=csv
# 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
# data time: 2026-11-11T09:00:00.000Z
id,name,lat,lon,time,surfLow,surfHigh,swell1Height,swell1Period,swell1Direction,swell2Height,swell2Period,swell2Direction,windSeaHeight,windSeaPeriod,windSeaDirection,model
text,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

GEOJSON

GET https://api.askthe.earth/v1/surf-spots?format=geojson
{
  "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"
      }
    }
  ]
}

el-nino

Updates every week
Coverage tropical Pacific
History The dataset is itself a record over time, so every answer is the whole history.
Formats json, csv
Licence US-public-domain
Credit El Niño status and indices: NOAA Climate Prediction Center.

Fields

Field Type Unit What it is
date date The week's centre, or the last day of the three-month season
index string nino12, nino3, nino34, nino4 or oni
season string Three-month season for oni rows, such as JAS, else null
sst number °C Weekly mean sea surface temperature in the box, null for oni
anomaly number °C Sea surface temperature anomaly

Example answers. The field names are real. The values are placeholders.

JSON

GET https://api.askthe.earth/v1/el-nino?format=json
{
  "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
    }
  ]
}

CSV

GET https://api.askthe.earth/v1/el-nino?format=csv
# credit: El Niño status and indices: NOAA Climate Prediction Center.
# licence: US-public-domain
# data time: 2026-11-11T09:00:00.000Z
date,index,season,sst,anomaly
2026-11-11,text,text,12.5,12.5