Back to the globeAPI termsTermsPrivacy
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
-
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.
-
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"
-
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.
- 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
-
Hazards: quakes, volcanoes-us,
fires, lightning,
flood-warnings
-
UK energy: generation-mix,
carbon-national, interconnectors,
power-cuts, wind-farms
-
Air and water: air-uk, air-world,
air-forecast-uk, air-maps,
rivers, bathing-water,
sewage-overflows, sewage-annual
-
Sea and weather: waves, sea-temperature,
currents, weather,
point-forecast, surf-spots,
el-nino
Gaps worth knowing about before you build on them:
volcanoes-us: US volcanoes only.
-
power-cuts: the UK Power Networks, SSEN and Electricity North West areas. Not covered:
Northern Powergrid, National Grid Electricity Distribution and SP Energy Networks.
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