Hub'Eau
App · 19 actions
Read France's public water data from Hub'Eau: live river levels and flows, groundwater levels, the official tap water test results for any commune, river and groundwater chemistry, water temperature, fish surveys and river biology scores, drought observations of small streams, and the water drawn by wells and intakes. Find the stations by department, commune or river. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Find a commune's tap water networks | Find the networks that supply a commune's tap water, by the commune's INSEE code or by its name (which also finds the commune's code for the other actions). |
| Find fish survey stations | Find the river stations where fish are surveyed by electrofishing, by department, commune, river or name, with the code 'Get fish survey results' takes. |
| Find groundwater level stations | Find the wells and boreholes where France measures its water table, by department or commune. |
| Find river gauging stations | Find the stations that measure river levels and flows in France, by department, commune, river or name. |
| Find river quality stations | Find the stations where rivers and lakes are sampled for their chemistry, by department, commune, river or name, with the code 'Get river water analyses' takes. |
| Find water abstraction works | Find the wells, river intakes and pumping stations that draw water, by department, commune, name or source (surface, ground or coastal water), with the code 'Get annual water abstraction volumes' takes. |
| Find water temperature stations | Find the sensors that record the temperature of rivers and lakes, by department, commune, river or name, with the code 'Get water temperature readings' takes. |
| Get annual water abstraction volumes | Get how much water was drawn each year, in cubic metres, by one work or every work in a department or commune, and what it was for (drinking water, irrigation, industry, energy...), with the total of the volumes returned. |
| Get daily groundwater levels | Get a groundwater station's daily water table levels: the height above sea level and the depth below the measuring point, with how far each was checked. |
| Get daily or monthly river flows | Get a river station's checked daily or monthly values back to its opening: mean, highest or lowest flow, or highest water level, with the lowest, highest and average of the period. |
| Get fish survey results | Get fish survey results for a station, department or commune: the fish index (IPR) score and class that rate the river's health, how many fish were caught, and each species with its count. |
| Get groundwater quality analyses | Get laboratory results on groundwater, such as nitrates or pesticides, for a station, department or commune. |
| Get hourly groundwater levels | Get a groundwater station's raw hourly water table levels, sent by its sensor before anyone has checked them. |
| Get live river levels and flows | Get a river station's latest water levels (in metres) and flows (in cubic metres a second), measured every 5 to 60 minutes and published within the hour, for up to the last month. |
| Get river biology scores | Get the biology indices that rate a river's ecological health from what lives in it (invertebrates, diatoms, aquatic plants, fish), for a station, department or commune. |
| Get river water analyses | Get a river or lake station's laboratory and field results, such as nitrates, phosphates, oxygen, pH or pesticides, with each result's unit and whether it was above the laboratory's limits. |
| Get stream flow observations | Get what the national drought watch (Onde) saw when it visited small streams, usually monthly from May to September: water flowing, standing water with no visible flow, or a dry bed, with a count of each. |
| Get tap water test results | Get the official health checks on a commune's tap water: each result (nitrates, bacteria, lead, pesticides...) with its legal limit, and each sample's verdict on the bacteria and chemical limits. |
| Get water temperature readings | Get a river or lake station's water temperature readings, usually hourly, with the newest, lowest, highest and average temperature of those returned. |
Find a commune's tap water networks
Find the networks that supply a commune's tap water, by the commune's INSEE code or by its name (which also finds the commune's code for the other actions). Without a year, the newest year published.
Inputs
- Commune
communetextRequired - The commune's 5-character INSEE code, such as 75056, or a word of its name, such as Lyon (every commune whose name has that word).
- Year
yearnumber - The year to list. Leave empty for the newest.From 2016 to 2100.
- How many to return
limitnumber - How many networks to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
networkslist- Each commune (or part of one) and the network supplying it.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
yearnumber- The year the networks are listed for.
Example output
{
"count": 2,
"networks": [
{
"area": "du 1\u00b0 au 13\u00b0, 15\u00b0 et 16\u00b0 arrondissement",
"commune": "PARIS",
"commune_code": "75056",
"network_code": "075000221",
"network_name": "CENTRE",
"supplied_since": "2010-09-02",
"year": 2026
},
{
"area": "8\u00b0 \u00e0 10\u00b0, 16\u00b0 \u00e0 18\u00b0 arrondissement",
"commune": "PARIS",
"commune_code": "75056",
"network_code": "075000222",
"network_name": "NORD OUEST",
"supplied_since": "2010-09-02",
"year": 2026
}
],
"total": 4,
"year": 2026
}Find fish survey stations
Find the river stations where fish are surveyed by electrofishing, by department, commune, river or name, with the code 'Get fish survey results' takes.
Inputs
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- River
rivertext - Only stations on this river: a word of its name, such as Loire.
- Station name
station_nametext - Words in the station's name, such as Arnoult.
- Station code
station_codetext - The station's 8-character code, such as 05001800. Leave empty to search by place.
- How many to return
limitnumber - How many stations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
stationslist- The stations.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 1,
"stations": [
{
"active": true,
"altitude_m": 9.0,
"catchment_area_km2": 197.0,
"commune": "PONT-L'ABBE-D'ARNOULT",
"commune_code": "17284",
"department": "Charente-Maritime",
"department_code": "17",
"latitude": 45.82187573299611,
"longitude": -0.8684281233255536,
"reference_url": "http://id.eaufrance.fr/StationMesureEauxSurface/05001800",
"region": "NOUVELLE-AQUITAINE",
"river": "L'Arnoult",
"station_code": "05001800",
"station_name": "L'Arnoult en amont de Pont l'Abb\u00e9 d'Arnoult"
}
],
"total": 1
}Find groundwater level stations
Find the wells and boreholes where France measures its water table, by department or commune. Each comes with its codes, depth, the aquifer it reaches, when it was measured and a link to its ADES page.
Inputs
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Station code
station_codetext - The groundwater station's BSS code, such as 07548X0009/F, or its BSS ID, such as BSS001VZGZ, as 'Find groundwater level stations' gives them. Leave empty to search by place.
- Measuring on
active_ondate - Only stations that were measuring on this day.
- How many to return
limitnumber - How many stations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
stationslist- The stations.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 1,
"stations": [
{
"altitude_m": 5.33,
"bss_id": "BSS001VZGZ",
"commune": "Saint-Est\u00e8phe",
"commune_code": "33395",
"department": "Gironde",
"department_code": "33",
"first_measured_on": "1966-03-25",
"last_measured_on": "2026-10-15",
"latitude": 45.229727388,
"longitude": -0.749057576,
"measurement_count": 5850,
"name": "CCMP-1 (SAINT ESTEPHE-33)",
"station_code": "07548X0009/F",
"station_url": "https://ades.eaufrance.fr/Fiche/PtEau?Code=07548X0009/F",
"water_bodies": [
"Calcaires du C\u00e9nomanien majoritairement captif du Nord du Bassin aquitain"
],
"well_depth_m": 1000.0
}
],
"total": 1
}Find river gauging stations
Find the stations that measure river levels and flows in France, by department, commune, river or name. Each comes with the code the level and flow actions take, its river, place, coordinates and a link to its HydroPortail page.
Inputs
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- River
rivertext - Only stations on this river: a word of its name, such as Seine.
- Station name
station_nametext - Words in the station's name, such as Austerlitz.
- Station code
station_codetext - Look up one station by its code (10 characters, such as F700000103), or every station of a site by the site's code (8 characters, such as F7000001).
- Only stations in service
in_service_onlytrue/false - Only stations measuring today. Turn off to include closed ones, whose history 'Get daily or monthly river flows' still reads.Default:
true. - How many to return
limitnumber - How many stations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
stationslist- The stations, by code.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"stations": [
{
"altitude_m": 25.92,
"closed_on": null,
"commune": "PARIS",
"commune_code": "75056",
"department": "PARIS",
"department_code": "75",
"in_service": true,
"latitude": 48.84468962,
"longitude": 2.365510635,
"opened_on": "1990-01-01",
"region": "ILE-DE-FRANCE",
"river": "La Seine",
"site_code": "F7000001",
"site_name": "La Seine \u00e0 Paris",
"station_code": "F700000102",
"station_name": "La Seine \u00e0 Paris - Austerlitz - station limni - secours CT",
"station_url": "https://www.hydro.eaufrance.fr/stationhydro/F700000102/fiche"
},
{
"altitude_m": 25.92,
"closed_on": null,
"commune": "PARIS",
"commune_code": "75056",
"department": "PARIS",
"department_code": "75",
"in_service": true,
"latitude": 48.84468962,
"longitude": 2.365510635,
"opened_on": "2006-01-26",
"region": "ILE-DE-FRANCE",
"river": "La Seine",
"site_code": "F7000001",
"site_name": "La Seine \u00e0 Paris",
"station_code": "F700000103",
"station_name": "La Seine \u00e0 Paris - Austerlitz [>2006] - Station d\u00e9bitm\u00e9trique",
"station_url": "https://www.hydro.eaufrance.fr/stationhydro/F700000103/fiche"
}
],
"total": 2
}Find river quality stations
Find the stations where rivers and lakes are sampled for their chemistry, by department, commune, river or name, with the code 'Get river water analyses' takes.
Inputs
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- River
rivertext - Only stations on this river: a word of its name, such as Seine.
- Station name
station_nametext - Words in the station's name, such as Paris.
- Station code
station_codetext - The station's 8-character code, such as 03081000. Leave empty to search by place.
- How many to return
limitnumber - How many stations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
stationslist- The stations.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"stations": [
{
"basin": "La Seine et les cours d'eau c\u00f4tiers normands",
"closed_on": null,
"commune": "Paris",
"commune_code": "75056",
"created_on": "1971-01-01",
"department": "Paris",
"department_code": "75",
"latitude": 48.832587164,
"longitude": 2.381542365,
"reference_url": "https://id.eaufrance.fr/StationMesureEauxSurface/03081000",
"region": "\u00cele-de-France",
"river": "La Seine",
"station_code": "03081000",
"station_name": "LA SEINE A PARIS-12E--ARRONDISSEMENT 1",
"water_body": "la Seine du confluent de la Marne exclu au confluent du Ru d Enghien inclus"
},
{
"basin": null,
"closed_on": null,
"commune": "Paris",
"commune_code": "75056",
"created_on": "1971-01-01",
"department": "Paris",
"department_code": "75",
"latitude": 48.861674085,
"longitude": 2.325270569,
"reference_url": "https://id.eaufrance.fr/StationMesureEauxSurface/03081270",
"region": "\u00cele-de-France",
"river": null,
"station_code": "03081270",
"station_name": "LA SEINE A PARIS--7E--ARRONDISSEMENT 1",
"water_body": null
}
],
"total": 5
}Find water abstraction works
Find the wells, river intakes and pumping stations that draw water, by department, commune, name or source (surface, ground or coastal water), with the code 'Get annual water abstraction volumes' takes.
Inputs
- Department
departmenttext - Only works in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only works in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Name
nametext - Words in the work's name, often its owner's, such as Pompey.
- Work code
work_codetext - Look up one work by its code, such as OPR0000000076.
- Water source
water_sourcetext - Only works drawing from this source. Leave empty for all.One of:
CONT(Surface water (rivers and lakes)),SOUT(Groundwater),LIT(Coastal water). - How many to return
limitnumber - How many works to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
workslist- The abstraction works (wells, intakes, pumping stations).
Example output
{
"count": 1,
"total": 1,
"works": [
{
"commune": "Custines",
"commune_code": "54150",
"department": "Meurthe-et-Moselle",
"department_code": "54",
"latitude": 48.78955870199617,
"longitude": 6.142146401015092,
"name": "CC DU BASSIN DE POMPEY",
"operating_since": "1900-01-01",
"operating_until": null,
"reference_url": "https://id.eaufrance.fr/OuvragePrel/OPR0000000076",
"water_source": "Groundwater",
"work_code": "OPR0000000076"
}
]
}Find water temperature stations
Find the sensors that record the temperature of rivers and lakes, by department, commune, river or name, with the code 'Get water temperature readings' takes.
Inputs
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- River
rivertext - Only stations on this river: a word of its name, such as Loire.
- Station name
station_nametext - Words in the station's name, such as Orléans.
- Station code
station_codetext - The station's 8-character code, such as 04051650. Leave empty to search by place.
- Measuring since
measured_sincedate - Only stations with readings on or after this day.
- How many to return
limitnumber - How many stations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
stationslist- The stations.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"stations": [
{
"altitude_m": 94.0,
"commune": "Cl\u00e9ry-Saint-Andr\u00e9",
"commune_code": "45098",
"department": "Loiret",
"department_code": "45",
"in_service_since": "2001-02-28",
"latitude": 47.816779591,
"longitude": 1.783722053,
"out_of_service_since": null,
"reference_url": "https://id.eaufrance.fr/StationMesureEauxSurface/04051650",
"region": "Centre-Val de Loire",
"river": "l'Ardoux",
"station_code": "04051650",
"station_name": "ARDOUX \u00e0 CLERY-SAINT-ANDRE"
},
{
"altitude_m": 116.0,
"commune": "Sully-sur-Loire",
"commune_code": "45315",
"department": "Loiret",
"department_code": "45",
"in_service_since": "2007-01-17",
"latitude": 47.761051944,
"longitude": 2.322399252,
"out_of_service_since": null,
"reference_url": "https://id.eaufrance.fr/StationMesureEauxSurface/04049625",
"region": "Centre-Val de Loire",
"river": "le Bec d'Able",
"station_code": "04049625",
"station_name": "BEC D'ABLE \u00e0 SULLY-SUR-LOIRE"
}
],
"total": 4
}Get annual water abstraction volumes
Get how much water was drawn each year, in cubic metres, by one work or every work in a department or commune, and what it was for (drinking water, irrigation, industry, energy...), with the total of the volumes returned. Volumes under 10,000 m3 a year are mostly not declared.
Inputs
- Work code
work_codetext - One work's code, such as OPR0000000076, from 'Find water abstraction works'. Give this, a department or a commune.
- Department
departmenttext - Only works in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only works in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Use
usagetext - Only water drawn for this use. Leave empty for all.One of:
AEP(Drinking water),IRR(Irrigation),IND(Industry and business),ENE(Energy (cooling)),BAR(Hydropower dams),CAN(Canals). - From year
year_fromnumber - The first year. Up to 20 years can be read at a time; leave both years empty for every year.From 2008 to 2100.
- To year
year_tonumber - The last year.From 2008 to 2100.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many yearly volumes to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
total_volume_m3number- The sum of the volumes returned, in cubic metres.
volumeslist- One row per work and year.
Example output
{
"count": 2,
"total": 13,
"total_volume_m3": 327483.0,
"volumes": [
{
"commune": "Custines",
"commune_code": "54150",
"department": "Meurthe-et-Moselle",
"department_code": "54",
"latitude": 48.78955870199617,
"longitude": 6.142146401015092,
"obtained_by": "direct measurement",
"qualification": "correct",
"returned_at_once": false,
"status": "checked (level 1)",
"use": "Drinking water",
"use_code": "AEP",
"volume_m3": 160439.0,
"work_code": "OPR0000000076",
"work_name": "CC DU BASSIN DE POMPEY",
"year": 2024
},
{
"commune": "Custines",
"commune_code": "54150",
"department": "Meurthe-et-Moselle",
"department_code": "54",
"latitude": 48.78955870199617,
"longitude": 6.142146401015092,
"obtained_by": "direct measurement",
"qualification": "correct",
"returned_at_once": false,
"status": "checked (level 1)",
"use": "Drinking water",
"use_code": "AEP",
"volume_m3": 167044.0,
"work_code": "OPR0000000076",
"work_name": "CC DU BASSIN DE POMPEY",
"year": 2023
}
]
}Get daily groundwater levels
Get a groundwater station's daily water table levels: the height above sea level and the depth below the measuring point, with how far each was checked. The newest level is also given on its own.
Inputs
- Station code
station_codetextRequired - The groundwater station's BSS code, such as 07548X0009/F, or its BSS ID, such as BSS001VZGZ, as 'Find groundwater level stations' gives them.
- Start date
start_datedate - Only levels on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only levels on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many levels to return, up to 1,000.From 1 to 1000. Default:
30.
Outputs
bss_idtext- The station's BSS ID.
countnumber- How many rows this step returned.
latest_datetext- The newest day among the levels (YYYY-MM-DD).
latest_depth_mnumber- The water table's depth below the measuring point, in metres. A negative depth means the water stands above it (an artesian well).
latest_level_mnumber- The water table's level in metres above sea level (NGF, France's height datum).
levelslist- One level a day.
station_codetext- The station's BSS code.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"bss_id": "BSS001VZGZ",
"count": 2,
"latest_date": "2026-10-22",
"latest_depth_m": -15.8,
"latest_level_m": 21.78,
"levels": [
{
"date": "2026-10-22",
"depth_m": -15.8,
"level_m": 21.78,
"method": "measured",
"producer": "Service G\u00e9ologique R\u00e9gional d'Aquitaine (327)",
"qualification": "not qualified",
"status": "raw"
},
{
"date": "2026-10-21",
"depth_m": -15.84,
"level_m": 21.82,
"method": "measured",
"producer": "Service G\u00e9ologique R\u00e9gional d'Aquitaine (327)",
"qualification": "not qualified",
"status": "raw"
}
],
"station_code": "07548X0009/F",
"total": 5857
}Get daily or monthly river flows
Get a river station's checked daily or monthly values back to its opening: mean, highest or lowest flow, or highest water level, with the lowest, highest and average of the period. Without dates, the last 30 days (daily) or 12 months (monthly).
Inputs
- Station code
station_codetextRequired - The gauging station's code (10 characters, such as F700000103 for the Seine in Paris) or its site's code (8 characters), as 'Find river gauging stations' gives them.
- Value
statistictext - Which value to get: the daily mean flow by default.One of:
QmnJ(Daily mean flow),QIXnJ(Daily highest flow),QINnJ(Daily lowest flow),HIXnJ(Daily highest water level),QmM(Monthly mean flow),QIXM(Monthly highest flow),QINM(Monthly lowest flow),HIXM(Monthly highest water level). Default:QmnJ. - Start date
start_datedate - Only values on this day or later. Leave empty for the last 30 days (daily values) or 12 months (monthly values).
- End date
end_datedate - Only values on this day or earlier. Leave empty for up to today.
- How many to return
limitnumber - How many values to return, up to 1,000.From 1 to 1000. Default:
31.
Outputs
averagenumber- The mean of the values returned.
countnumber- How many rows this step returned.
end_datetext- The last day searched (YYYY-MM-DD), or empty for today.
maximumnumber- The highest value returned.
minimumnumber- The lowest value returned.
start_datetext- The first day searched (YYYY-MM-DD).
station_codetext- The station or site asked for.
statistictext- Hub'Eau's code for the value asked for, such as 'QmnJ'.
statistic_nametext- What it is, such as 'Daily mean flow'.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
unittext- 'm3/s' for flows, 'm' for water levels.
valueslist- The values, oldest first.
Example output
{
"average": 90.178,
"count": 2,
"end_date": null,
"maximum": 90.559,
"minimum": 89.797,
"start_date": "2026-09-23",
"station_code": "F700000103",
"statistic": "QmnJ",
"statistic_name": "Daily mean flow",
"total": 30,
"unit": "m3/s",
"values": [
{
"date": "2026-09-23",
"method": "expert reviewed",
"qualification": "good",
"site_code": "F7000001",
"station_code": "F700000103",
"status": "pre-validated",
"value": 90.559
},
{
"date": "2026-09-24",
"method": "expert reviewed",
"qualification": "good",
"site_code": "F7000001",
"station_code": "F700000103",
"status": "pre-validated",
"value": 89.797
}
]
}Get fish survey results
Get fish survey results for a station, department or commune: the fish index (IPR) score and class that rate the river's health, how many fish were caught, and each species with its count.
Inputs
- Station code
station_codetext - The fish survey station's 8-character code, such as 05001800. Leave empty to search by place.
- Department
departmenttext - Only surveys in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only surveys in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Start date
start_datedate - Only surveys on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only surveys on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many surveys to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
surveyslist- One row per survey (an electrofishing operation).
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 1,
"surveys": [
{
"commune": "PONT-L'ABBE-D'ARNOULT",
"commune_code": "17284",
"department": "Charente-Maritime",
"department_code": "17",
"fish_counted": 137,
"ipr_class": "average",
"ipr_plus_class": null,
"ipr_plus_score": null,
"ipr_score": 18.18,
"method": "P\u00eache compl\u00e8te \u00e0 un ou plusieurs passages",
"river": "L'Arnoult",
"species": [
{
"count": 34,
"latin_name": "Alburnus alburnus",
"name": "Ablette"
},
{
"count": 31,
"latin_name": "Lepomis gibbosus",
"name": "Perche soleil"
},
{
"count": 16,
"latin_name": "Ameiurus melas",
"name": "Poisson-chat"
},
{
"count": 14,
"latin_name": "Gobio sp.",
"name": "Goujon ind\u00e9termin\u00e9 (Gobio)"
},
{
"count": 11,
"latin_name": "Leuciscus cephalus",
"name": "Chevaine"
},
{
"count": 11,
"latin_name": "Tinca tinca",
"name": "Tanche"
},
{
"count": 7,
"latin_name": "Rutilus rutilus",
"name": "Gardon"
},
{
"count": 5,
"latin_name": "Anguilla anguilla",
"name": "Anguille europ\u00e9enne"
},
{
"count": 5,
"latin_name": "Phoxinus sp.",
"name": "Vairon ind\u00e9termin\u00e9 (Phoxinus)"
},
{
"count": 3,
"latin_name": "Perca fluviatilis",
"name": "Perche"
}
],
"species_count": 10,
"station_code": "05001800",
"station_name": "L'Arnoult en amont de Pont l'Abb\u00e9 d'Arnoult",
"survey_id": "90765",
"surveyed_on": "2023-09-18"
}
],
"total": 9
}Get groundwater quality analyses
Get laboratory results on groundwater, such as nitrates or pesticides, for a station, department or commune. Results from several stations come station by station.
Inputs
- Station code
station_codetext - The groundwater station's BSS code, such as 07548X0009/F, or its BSS ID, such as BSS001VZGZ, as 'Find groundwater level stations' gives them. Leave empty to search by place.
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Parameter
parametertext - What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date
start_datedate - Only samples on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only samples on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many results to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
analyseslist- One row per result. Several stations come station by station, each in the order asked.
countnumber- How many rows this step returned.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"analyses": [
{
"bss_id": "BSS001ABFA",
"commune": "Saint-Ly\u00e9-la-For\u00eat",
"commune_code": "45289",
"department": "Loiret",
"department_code": "45",
"parameter": "Nitrates",
"parameter_code": "1340",
"producer": "ARS du Loiret (45)",
"qualification": "correct",
"quantification_limit": null,
"quantified": false,
"remark": "below the detection limit",
"result": 0.5,
"sampled_at": "2025-07-03T11:52:00Z",
"station_code": "03632X0131/FAEP",
"unit": "mg(NO3)/L"
},
{
"bss_id": "BSS001ABFA",
"commune": "Saint-Ly\u00e9-la-For\u00eat",
"commune_code": "45289",
"department": "Loiret",
"department_code": "45",
"parameter": "Nitrates",
"parameter_code": "1340",
"producer": "ARS du Loiret (45)",
"qualification": "correct",
"quantification_limit": null,
"quantified": false,
"remark": "below the detection limit",
"result": 0.5,
"sampled_at": "2023-02-23T10:38:00Z",
"station_code": "03632X0131/FAEP",
"unit": "mg(NO3)/L"
}
],
"count": 2,
"total": 10
}Get hourly groundwater levels
Get a groundwater station's raw hourly water table levels, sent by its sensor before anyone has checked them. Only stations with a live sensor have them.
Inputs
- Station code
station_codetextRequired - The groundwater station's BSS code, such as 07548X0009/F, or its BSS ID, such as BSS001VZGZ, as 'Find groundwater level stations' gives them.
- Start date
start_datedate - Only readings on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only readings on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many readings to return, up to 1,000.From 1 to 1000. Default:
48.
Outputs
bss_idtext- The station's BSS ID.
countnumber- How many rows this step returned.
latest_depth_mnumber- The water table's depth below the measuring point, in metres. A negative depth means the water stands above it (an artesian well).
latest_level_mnumber- The water table's level in metres above sea level (NGF, France's height datum).
latest_measured_attext- When the newest reading was taken, in UTC.
readingslist- Raw hourly readings, not yet checked.
station_codetext- The station's BSS code.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"bss_id": "BSS001VZGZ",
"count": 2,
"latest_depth_m": -15.32,
"latest_level_m": 21.3,
"latest_measured_at": "2026-10-17T04:00:00Z",
"readings": [
{
"depth_m": -15.32,
"level_m": 21.3,
"measured_at": "2026-10-17T04:00:00Z"
},
{
"depth_m": -15.35,
"level_m": 21.33,
"measured_at": "2026-10-17T03:00:00Z"
}
],
"station_code": "07548X0009/F",
"total": 2188
}Get live river levels and flows
Get a river station's latest water levels (in metres) and flows (in cubic metres a second), measured every 5 to 60 minutes and published within the hour, for up to the last month. The newest level and flow are also given on their own, ready for a condition such as a flood or low water alert.
Inputs
- Station code
station_codetextRequired - The gauging station's code (10 characters, such as F700000103 for the Seine in Paris) or its site's code (8 characters), as 'Find river gauging stations' gives them.
- Measure
measuretext - Water level, flow, or both (the default).One of:
both(Water level and flow),level(Water level only),flow(Flow only). Default:both. - Since
sincedate and time - Only readings from this moment, at most one month ago. Leave empty for the newest.
- Until
untildate and time - Only readings up to this moment.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many readings to return, up to 1,000.From 1 to 1000. Default:
48.
Outputs
countnumber- How many rows this step returned.
latest_flow_attext- When that flow was measured, in UTC.
latest_flow_m3snumber- The newest flow among the readings, in cubic metres a second; empty when there is none.
latest_level_attext- When that level was measured, in UTC.
latest_level_mnumber- The newest water level among the readings, in metres; empty when there is none.
readingslist- The readings, every 5 to 60 minutes depending on the station.
station_codetext- The station or site asked for.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"latest_flow_at": "2026-10-23T19:40:00Z",
"latest_flow_m3s": 97.9,
"latest_level_at": "2026-10-23T19:40:00Z",
"latest_level_m": 0.999,
"readings": [
{
"measure": "level",
"measured_at": "2026-10-23T19:40:00Z",
"method": "measured",
"qualification": "not qualified",
"site_code": "F7000001",
"station_code": "F700000103",
"status": "raw",
"unit": "m",
"value": 0.999
},
{
"measure": "flow",
"measured_at": "2026-10-23T19:40:00Z",
"method": "measured",
"qualification": "not qualified",
"site_code": "F7000001",
"station_code": "F700000103",
"status": "raw",
"unit": "m3/s",
"value": 97.9
}
],
"station_code": "F700000103",
"total": 15164
}Get river biology scores
Get the biology indices that rate a river's ecological health from what lives in it (invertebrates, diatoms, aquatic plants, fish), for a station, department or commune.
Inputs
- Station code
station_codetext - The biology station's 8-character code, such as 03081000. Leave empty to search by place.
- Department
departmenttext - Only stations in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only stations in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Indices
indiceslist - Only these indices. Leave empty for every index and its sub-scores.One or more of:
7613(I2M2 (invertebrates)),5910(IBG equivalent (invertebrates)),6951(Large river invertebrate index),1000(IBGN (invertebrates, before 2016)),5856(IBD (diatoms)),1022(IPS (diatoms)),2928(IBMR (aquatic plants)),7036(IPR (fish)). - Start date
start_datedate - Only samples on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only samples on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many scores to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
scoreslist- One row per index worked out from a sample.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"scores": [
{
"commune": "Paris",
"commune_code": "75056",
"department": "Paris",
"department_code": "75",
"index_code": "6951",
"index_name": "Indice macroinvert\u00e9br\u00e9s grands cours d'eau - 12 pr\u00e9l\u00e8vements",
"organisms": "aquatic invertebrates",
"qualification": "correct",
"river": "La Seine",
"sampled_on": "2022-08-24",
"score": 11.0,
"station_code": "03081000",
"station_name": "LA SEINE A PARIS-12E--ARRONDISSEMENT 1"
},
{
"commune": "Paris",
"commune_code": "75056",
"department": "Paris",
"department_code": "75",
"index_code": "5856",
"index_name": "Indice Biologique Diatom\u00e9es (IBD)",
"organisms": "benthic diatoms",
"qualification": "correct",
"river": "La Seine",
"sampled_on": "2022-08-24",
"score": 12.9,
"station_code": "03081000",
"station_name": "LA SEINE A PARIS-12E--ARRONDISSEMENT 1"
}
],
"total": 9
}Get river water analyses
Get a river or lake station's laboratory and field results, such as nitrates, phosphates, oxygen, pH or pesticides, with each result's unit and whether it was above the laboratory's limits.
Inputs
- Station code
station_codetextRequired - The river quality station's 8-character code, such as 03081000.
- Parameter
parametertext - What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date
start_datedate - Only samples on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only samples on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many results to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
analyseslist- One row per laboratory or field result.
countnumber- How many rows this step returned.
station_codetext- The station's 8-character code, such as '03081000'.
station_nametext- The station's name.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"analyses": [
{
"detection_limit": 0.03,
"parameter": "Nitrates",
"parameter_code": "1340",
"qualification": "correct",
"quantification_limit": 0.1,
"quantified": true,
"remark": "quantified",
"result": 22.1,
"sampled_on": "2026-06-17",
"sampled_time": "10:26:00",
"unit": "mg(NO3)/L"
},
{
"detection_limit": 0.03,
"parameter": "Nitrates",
"parameter_code": "1340",
"qualification": "correct",
"quantification_limit": 0.1,
"quantified": true,
"remark": "quantified",
"result": 28.0,
"sampled_on": "2026-04-14",
"sampled_time": "10:03:00",
"unit": "mg(NO3)/L"
}
],
"count": 2,
"station_code": "03081000",
"station_name": "LA SEINE A PARIS-12E--ARRONDISSEMENT 1",
"total": 684
}Get stream flow observations
Get what the national drought watch (Onde) saw when it visited small streams, usually monthly from May to September: water flowing, standing water with no visible flow, or a dry bed, with a count of each. Without a start date, the last 12 months.
Inputs
- Department
departmenttext - Only streams in this department. Leave empty for all of France.One of:
01(01 Ain),02(02 Aisne),03(03 Allier),04(04 Alpes-de-Haute-Provence),05(05 Hautes-Alpes),06(06 Alpes-Maritimes),07(07 Ardèche),08(08 Ardennes),09(09 Ariège),10(10 Aube), and 91 more. - Commune code
commune_codetext - Only streams in this commune, by its 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds a code from a commune's name.
- Station code
station_codetext - Only this Onde station, by the code this step's results give, such as A6020001.
- Flow states
flow_stateslist - Only visits that saw one of these. Leave empty for all.One or more of:
1(Visible flow),1a(Visible flow, acceptable),1f(Visible flow, weak),2(No visible flow),3(Dry),4(Could not be observed). - Start date
start_datedate - Only visits on this day or later. Leave empty for the last 12 months.
- End date
end_datedate - Only visits on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many observations to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
dry_countnumber- How many found the stream dry.
no_visible_flow_countnumber- How many saw water but no visible flow.
not_observable_countnumber- How many could not be made.
observationslist- One row per station visit.
start_datetext- The first day searched (YYYY-MM-DD).
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
visible_flow_countnumber- How many of the observations returned saw water flowing.
Example output
{
"count": 2,
"dry_count": 0,
"no_visible_flow_count": 0,
"not_observable_count": 0,
"observations": [
{
"campaign_id": "111301",
"commune": "SAULCY-SUR-MEURTHE",
"commune_code": "88445",
"department": "Vosges",
"department_code": "88",
"flow_code": "1a",
"flow_state": "Visible flow, acceptable",
"latitude": 48.247439424,
"longitude": 6.959627447,
"observed_on": "2026-10-09",
"river": null,
"station_code": "A6020001",
"station_name": "Le Moulin \u00e0 Saulcy sur Meurthe"
},
{
"campaign_id": "111301",
"commune": "SAINT-MICHEL-SUR-MEURTHE",
"commune_code": "88428",
"department": "Vosges",
"department_code": "88",
"flow_code": "1a",
"flow_state": "Visible flow, acceptable",
"latitude": 48.314793437,
"longitude": 6.906042441,
"observed_on": "2026-10-09",
"river": "Ruisseau de Herbaville",
"station_code": "A6070001",
"station_name": "L'Herbaville \u00e0 Saint Michel sur Meurthe"
}
],
"start_date": "2025-10-23",
"total": 279,
"visible_flow_count": 2
}Get tap water test results
Get the official health checks on a commune's tap water: each result (nitrates, bacteria, lead, pesticides...) with its legal limit, and each sample's verdict on the bacteria and chemical limits. Newest first; only samples that failed a limit if you ask.
Inputs
- Commune code
commune_codetextRequired - The commune's 5-character INSEE code (not its postcode), such as 75056 for Paris. 'Find a commune's tap water networks' finds it from a name.
- Network code
network_codetext - Only results from this network, by its 9-digit code from 'Find a commune's tap water networks'. Leave empty for all of the commune's networks.
- Parameter
parametertext - What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date
start_datedate - Only samples on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only samples on this day or earlier. Leave empty for up to today.
- Samples
compliancetext - Every sample, or only those that failed a legal bacteria or chemical limit.One of:
any(Every sample),bacteria_failed(Samples that failed a bacteria limit),chemistry_failed(Samples that failed a chemical limit). Default:any. - Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many results to return, up to 500.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1. Hub'Eau pages through the first 20,000 results only.From 1 to 20000. Default:
1.
Outputs
countnumber- How many rows this step returned.
resultslist- One row per thing measured in a sample.
sampleslist- The samples these results come from.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"count": 2,
"results": [
{
"bacteria_compliance": "compliant",
"below_detection": true,
"chemistry_compliance": "compliant",
"commune": "PARIS",
"commune_code": "75056",
"conclusion": "Eau d'alimentation conforme aux exigences de qualit\u00e9 en vigueur pour l'ensemble des param\u00e8tres mesur\u00e9s.",
"distributor": "EAU DE PARIS",
"limit": "<=0,5 mg/L",
"networks": [
{
"code": "075000225",
"name": "SUD OUEST"
}
],
"parameter": "Nitrites (en NO2)",
"parameter_code": "1339",
"reference": null,
"result": 0.0,
"result_text": "<0,01",
"sample_id": "07500217007",
"sampled_at": "2026-06-30T16:14:00Z",
"unit": "mg/L"
},
{
"bacteria_compliance": "compliant",
"below_detection": false,
"chemistry_compliance": "compliant",
"commune": "PARIS",
"commune_code": "75056",
"conclusion": "Eau d'alimentation conforme aux exigences de qualit\u00e9 en vigueur pour l'ensemble des param\u00e8tres mesur\u00e9s.",
"distributor": "EAU DE PARIS",
"limit": null,
"networks": [
{
"code": "075000225",
"name": "SUD OUEST"
}
],
"parameter": "Conductivit\u00e9 \u00e0 25\u00b0C",
"parameter_code": "1303",
"reference": ">=200 et <=1100 \u00b5S/cm",
"result": 525.0,
"result_text": "525",
"sample_id": "07500217007",
"sampled_at": "2026-06-30T16:14:00Z",
"unit": "\u00b5S/cm"
}
],
"samples": [
{
"bacteria_compliance": "compliant",
"chemistry_compliance": "compliant",
"conclusion": "Eau d'alimentation conforme aux exigences de qualit\u00e9 en vigueur pour l'ensemble des param\u00e8tres mesur\u00e9s.",
"sample_id": "07500217007",
"sampled_at": "2026-06-30T16:14:00Z"
}
],
"total": 653863
}Get water temperature readings
Get a river or lake station's water temperature readings, usually hourly, with the newest, lowest, highest and average temperature of those returned. Readings reach Hub'Eau some weeks after they are taken.
Inputs
- Station code
station_codetextRequired - The temperature station's 8-character code, such as 04051650.
- Start date
start_datedate - Only readings on this day or later. Leave empty to start from the earliest.
- End date
end_datedate - Only readings on this day or earlier. Leave empty for up to today.
- Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first). Default:newest. - How many to return
limitnumber - How many readings to return, up to 1,000.From 1 to 1000. Default:
48.
Outputs
average_cnumber- The mean of the readings returned.
countnumber- How many rows this step returned.
latest_datetext- The newest reading's day (YYYY-MM-DD).
latest_temperature_cnumber- The newest reading, in degrees Celsius.
latest_timetext- The newest reading's time (hh:mm:ss).
maximum_cnumber- The warmest reading returned, in degrees Celsius.
minimum_cnumber- The coldest reading returned, in degrees Celsius.
readingslist- The readings, usually hourly.
rivertext- The river or lake.
station_codetext- The station's 8-character code, such as '03081000'.
station_nametext- The station's name.
totalnumber- How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
Example output
{
"average_c": 18.82,
"count": 2,
"latest_date": "2026-09-26",
"latest_temperature_c": 18.82,
"latest_time": "17:00:00",
"maximum_c": 18.82,
"minimum_c": 18.82,
"readings": [
{
"date": "2026-09-26",
"qualification": "not qualified",
"temperature_c": 18.82,
"time": "17:00:00"
},
{
"date": "2026-09-26",
"qualification": "not qualified",
"temperature_c": 18.82,
"time": "16:00:00"
}
],
"river": "l'Ardoux",
"station_code": "04051650",
"station_name": "ARDOUX \u00e0 CLERY-SAINT-ANDRE",
"total": 86728
}