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

ActionWhat it does
Find a commune's tap water networksFind 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 stationsFind 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 stationsFind the wells and boreholes where France measures its water table, by department or commune.
Find river gauging stationsFind the stations that measure river levels and flows in France, by department, commune, river or name.
Find river quality stationsFind 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 worksFind 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 stationsFind 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 volumesGet 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 levelsGet 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 flowsGet 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 resultsGet 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 analysesGet laboratory results on groundwater, such as nitrates or pesticides, for a station, department or commune.
Get hourly groundwater levelsGet a groundwater station's raw hourly water table levels, sent by its sensor before anyone has checked them.
Get live river levels and flowsGet 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 scoresGet 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 analysesGet 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 observationsGet 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 resultsGet 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 readingsGet 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

CommunecommunetextRequired
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).
Yearyearnumber
The year to list. Leave empty for the newest.From 2016 to 2100.
How many to returnlimitnumber
How many networks to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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.
Riverrivertext
Only stations on this river: a word of its name, such as Loire.
Station namestation_nametext
Words in the station's name, such as Arnoult.
Station codestation_codetext
The station's 8-character code, such as 05001800. Leave empty to search by place.
How many to returnlimitnumber
How many stations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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 codestation_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 onactive_ondate
Only stations that were measuring on this day.
How many to returnlimitnumber
How many stations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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.
Riverrivertext
Only stations on this river: a word of its name, such as Seine.
Station namestation_nametext
Words in the station's name, such as Austerlitz.
Station codestation_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 servicein_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 returnlimitnumber
How many stations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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.
Riverrivertext
Only stations on this river: a word of its name, such as Seine.
Station namestation_nametext
Words in the station's name, such as Paris.
Station codestation_codetext
The station's 8-character code, such as 03081000. Leave empty to search by place.
How many to returnlimitnumber
How many stations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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.
Namenametext
Words in the work's name, often its owner's, such as Pompey.
Work codework_codetext
Look up one work by its code, such as OPR0000000076.
Water sourcewater_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 returnlimitnumber
How many works to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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.
Riverrivertext
Only stations on this river: a word of its name, such as Loire.
Station namestation_nametext
Words in the station's name, such as Orléans.
Station codestation_codetext
The station's 8-character code, such as 04051650. Leave empty to search by place.
Measuring sincemeasured_sincedate
Only stations with readings on or after this day.
How many to returnlimitnumber
How many stations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codework_codetext
One work's code, such as OPR0000000076, from 'Find water abstraction works'. Give this, a department or a commune.
Departmentdepartmenttext
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 codecommune_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.
Useusagetext
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 yearyear_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 yearyear_tonumber
The last year.From 2008 to 2100.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many yearly volumes to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codestation_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 datestart_datedate
Only levels on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only levels on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
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 codestation_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.
Valuestatistictext
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 datestart_datedate
Only values on this day or later. Leave empty for the last 30 days (daily values) or 12 months (monthly values).
End dateend_datedate
Only values on this day or earlier. Leave empty for up to today.
How many to returnlimitnumber
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 codestation_codetext
The fish survey station's 8-character code, such as 05001800. Leave empty to search by place.
Departmentdepartmenttext
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 codecommune_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 datestart_datedate
Only surveys on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only surveys on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many surveys to return, up to 100.From 1 to 100. Default: 10.
Pagepagenumber
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 codestation_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.
Departmentdepartmenttext
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 codecommune_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.
Parameterparametertext
What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
Start datestart_datedate
Only samples on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only samples on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many results to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codestation_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 datestart_datedate
Only readings on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only readings on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
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 codestation_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.
Measuremeasuretext
Water level, flow, or both (the default).One of: both (Water level and flow), level (Water level only), flow (Flow only). Default: both.
Sincesincedate and time
Only readings from this moment, at most one month ago. Leave empty for the newest.
Untiluntildate and time
Only readings up to this moment.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
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 codestation_codetext
The biology station's 8-character code, such as 03081000. Leave empty to search by place.
Departmentdepartmenttext
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 codecommune_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.
Indicesindiceslist
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 datestart_datedate
Only samples on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only samples on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many scores to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codestation_codetextRequired
The river quality station's 8-character code, such as 03081000.
Parameterparametertext
What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
Start datestart_datedate
Only samples on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only samples on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many results to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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

Departmentdepartmenttext
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 codecommune_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 codestation_codetext
Only this Onde station, by the code this step's results give, such as A6020001.
Flow statesflow_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 datestart_datedate
Only visits on this day or later. Leave empty for the last 12 months.
End dateend_datedate
Only visits on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many observations to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codecommune_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 codenetwork_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.
Parameterparametertext
What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
Start datestart_datedate
Only samples on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only samples on this day or earlier. Leave empty for up to today.
Samplescompliancetext
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.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
How many results to return, up to 500.From 1 to 500. Default: 50.
Pagepagenumber
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 codestation_codetextRequired
The temperature station's 8-character code, such as 04051650.
Start datestart_datedate
Only readings on this day or later. Leave empty to start from the earliest.
End dateend_datedate
Only readings on this day or earlier. Leave empty for up to today.
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first). Default: newest.
How many to returnlimitnumber
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
}

On this page