# Hub'Eau

> 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.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/hubeau

## Actions

### 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 (`commune`, text, required): 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 (`year`, number): The year to list. Leave empty for the newest. From 2016 to 2100.
- How many to return (`limit`, number): How many networks to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `networks` (list): Each commune (or part of one) and the network supplying it.
- `total` (number): How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
- `year` (number): The year the networks are listed for.

**Example output**

```json
{
  "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 (`department`, text): 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_code`, text): 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 (`river`, text): Only stations on this river: a word of its name, such as Loire.
- Station name (`station_name`, text): Words in the station's name, such as Arnoult.
- Station code (`station_code`, text): The station's 8-character code, such as 05001800. Leave empty to search by place.
- How many to return (`limit`, number): How many stations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `stations` (list): The stations.
- `total` (number): 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**

```json
{
  "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 (`department`, text): 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_code`, text): 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_code`, text): 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_on`, date): Only stations that were measuring on this day.
- How many to return (`limit`, number): How many stations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `stations` (list): The stations.
- `total` (number): 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**

```json
{
  "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 (`department`, text): 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_code`, text): 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 (`river`, text): Only stations on this river: a word of its name, such as Seine.
- Station name (`station_name`, text): Words in the station's name, such as Austerlitz.
- Station code (`station_code`, text): 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_only`, true/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 (`limit`, number): How many stations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `stations` (list): The stations, by code.
- `total` (number): 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**

```json
{
  "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 (`department`, text): 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_code`, text): 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 (`river`, text): Only stations on this river: a word of its name, such as Seine.
- Station name (`station_name`, text): Words in the station's name, such as Paris.
- Station code (`station_code`, text): The station's 8-character code, such as 03081000. Leave empty to search by place.
- How many to return (`limit`, number): How many stations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `stations` (list): The stations.
- `total` (number): 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**

```json
{
  "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 (`department`, text): 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_code`, text): 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 (`name`, text): Words in the work's name, often its owner's, such as Pompey.
- Work code (`work_code`, text): Look up one work by its code, such as OPR0000000076.
- Water source (`water_source`, text): 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 (`limit`, number): How many works to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `total` (number): How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
- `works` (list): The abstraction works (wells, intakes, pumping stations).

**Example output**

```json
{
  "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 (`department`, text): 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_code`, text): 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 (`river`, text): Only stations on this river: a word of its name, such as Loire.
- Station name (`station_name`, text): Words in the station's name, such as Orléans.
- Station code (`station_code`, text): The station's 8-character code, such as 04051650. Leave empty to search by place.
- Measuring since (`measured_since`, date): Only stations with readings on or after this day.
- How many to return (`limit`, number): How many stations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `stations` (list): The stations.
- `total` (number): 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**

```json
{
  "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_code`, text): One work's code, such as OPR0000000076, from 'Find water abstraction works'. Give this, a department or a commune.
- Department (`department`, text): 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_code`, text): 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 (`usage`, text): 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_from`, number): 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_to`, number): The last year. From 2008 to 2100.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many yearly volumes to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `total` (number): 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_m3` (number): The sum of the volumes returned, in cubic metres.
- `volumes` (list): One row per work and year.

**Example output**

```json
{
  "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_code`, text, required): 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_date`, date): Only levels on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only levels on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many levels to return, up to 1,000. From 1 to 1000. Default: `30`.

**Outputs**

- `bss_id` (text): The station's BSS ID.
- `count` (number): How many rows this step returned.
- `latest_date` (text): The newest day among the levels (YYYY-MM-DD).
- `latest_depth_m` (number): 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_m` (number): The water table's level in metres above sea level (NGF, France's height datum).
- `levels` (list): One level a day.
- `station_code` (text): The station's BSS code.
- `total` (number): 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**

```json
{
  "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_code`, text, required): 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 (`statistic`, text): 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_date`, date): Only values on this day or later. Leave empty for the last 30 days (daily values) or 12 months (monthly values).
- End date (`end_date`, date): Only values on this day or earlier. Leave empty for up to today.
- How many to return (`limit`, number): How many values to return, up to 1,000. From 1 to 1000. Default: `31`.

**Outputs**

- `average` (number): The mean of the values returned.
- `count` (number): How many rows this step returned.
- `end_date` (text): The last day searched (YYYY-MM-DD), or empty for today.
- `maximum` (number): The highest value returned.
- `minimum` (number): The lowest value returned.
- `start_date` (text): The first day searched (YYYY-MM-DD).
- `station_code` (text): The station or site asked for.
- `statistic` (text): Hub'Eau's code for the value asked for, such as 'QmnJ'.
- `statistic_name` (text): What it is, such as 'Daily mean flow'.
- `total` (number): How many match in all. More than 'count' means there are more pages: raise 'How many to return' or ask for the next 'Page'.
- `unit` (text): 'm3/s' for flows, 'm' for water levels.
- `values` (list): The values, oldest first.

**Example output**

```json
{
  "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_code`, text): The fish survey station's 8-character code, such as 05001800. Leave empty to search by place.
- Department (`department`, text): 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_code`, text): 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_date`, date): Only surveys on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only surveys on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many surveys to return, up to 100. From 1 to 100. Default: `10`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `surveys` (list): One row per survey (an electrofishing operation).
- `total` (number): 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**

```json
{
  "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_code`, text): 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 (`department`, text): 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_code`, text): 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 (`parameter`, text): What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date (`start_date`, date): Only samples on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only samples on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many results to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `analyses` (list): One row per result. Several stations come station by station, each in the order asked.
- `count` (number): How many rows this step returned.
- `total` (number): 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**

```json
{
  "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_code`, text, required): 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_date`, date): Only readings on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only readings on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many readings to return, up to 1,000. From 1 to 1000. Default: `48`.

**Outputs**

- `bss_id` (text): The station's BSS ID.
- `count` (number): How many rows this step returned.
- `latest_depth_m` (number): 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_m` (number): The water table's level in metres above sea level (NGF, France's height datum).
- `latest_measured_at` (text): When the newest reading was taken, in UTC.
- `readings` (list): Raw hourly readings, not yet checked.
- `station_code` (text): The station's BSS code.
- `total` (number): 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**

```json
{
  "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_code`, text, required): 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 (`measure`, text): Water level, flow, or both (the default). One of: `both` (Water level and flow), `level` (Water level only), `flow` (Flow only). Default: `both`.
- Since (`since`, date and time): Only readings from this moment, at most one month ago. Leave empty for the newest.
- Until (`until`, date and time): Only readings up to this moment.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many readings to return, up to 1,000. From 1 to 1000. Default: `48`.

**Outputs**

- `count` (number): How many rows this step returned.
- `latest_flow_at` (text): When that flow was measured, in UTC.
- `latest_flow_m3s` (number): The newest flow among the readings, in cubic metres a second; empty when there is none.
- `latest_level_at` (text): When that level was measured, in UTC.
- `latest_level_m` (number): The newest water level among the readings, in metres; empty when there is none.
- `readings` (list): The readings, every 5 to 60 minutes depending on the station.
- `station_code` (text): The station or site asked for.
- `total` (number): 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**

```json
{
  "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_code`, text): The biology station's 8-character code, such as 03081000. Leave empty to search by place.
- Department (`department`, text): 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_code`, text): 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 (`indices`, list): 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_date`, date): Only samples on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only samples on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many scores to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `scores` (list): One row per index worked out from a sample.
- `total` (number): 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**

```json
{
  "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_code`, text, required): The river quality station's 8-character code, such as 03081000.
- Parameter (`parameter`, text): What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date (`start_date`, date): Only samples on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only samples on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many results to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `analyses` (list): One row per laboratory or field result.
- `count` (number): How many rows this step returned.
- `station_code` (text): The station's 8-character code, such as '03081000'.
- `station_name` (text): The station's name.
- `total` (number): 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**

```json
{
  "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 (`department`, text): 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_code`, text): 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_code`, text): Only this Onde station, by the code this step's results give, such as A6020001.
- Flow states (`flow_states`, list): 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_date`, date): Only visits on this day or later. Leave empty for the last 12 months.
- End date (`end_date`, date): Only visits on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many observations to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `dry_count` (number): How many found the stream dry.
- `no_visible_flow_count` (number): How many saw water but no visible flow.
- `not_observable_count` (number): How many could not be made.
- `observations` (list): One row per station visit.
- `start_date` (text): The first day searched (YYYY-MM-DD).
- `total` (number): 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_count` (number): How many of the observations returned saw water flowing.

**Example output**

```json
{
  "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_code`, text, required): 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_code`, text): 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 (`parameter`, text): What was measured: pick a common one, or type any Sandre parameter code. Leave empty for everything measured.
- Start date (`start_date`, date): Only samples on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only samples on this day or earlier. Leave empty for up to today.
- Samples (`compliance`, text): 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 (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many results to return, up to 500. From 1 to 500. Default: `50`.
- Page (`page`, number): 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**

- `count` (number): How many rows this step returned.
- `results` (list): One row per thing measured in a sample.
- `samples` (list): The samples these results come from.
- `total` (number): 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**

```json
{
  "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_code`, text, required): The temperature station's 8-character code, such as 04051650.
- Start date (`start_date`, date): Only readings on this day or later. Leave empty to start from the earliest.
- End date (`end_date`, date): Only readings on this day or earlier. Leave empty for up to today.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many to return (`limit`, number): How many readings to return, up to 1,000. From 1 to 1000. Default: `48`.

**Outputs**

- `average_c` (number): The mean of the readings returned.
- `count` (number): How many rows this step returned.
- `latest_date` (text): The newest reading's day (YYYY-MM-DD).
- `latest_temperature_c` (number): The newest reading, in degrees Celsius.
- `latest_time` (text): The newest reading's time (hh:mm:ss).
- `maximum_c` (number): The warmest reading returned, in degrees Celsius.
- `minimum_c` (number): The coldest reading returned, in degrees Celsius.
- `readings` (list): The readings, usually hourly.
- `river` (text): The river or lake.
- `station_code` (text): The station's 8-character code, such as '03081000'.
- `station_name` (text): The station's name.
- `total` (number): 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**

```json
{
  "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
}
```
