# PEGELONLINE

> Watch the rivers, canals and coasts of Germany from a workflow, with the federal waterways' own gauges. Find gauges on the Rhine, Elbe, Danube and about 100 other waters, read the latest water level, discharge or temperature at one gauge or along a whole river, get up to 31 days of readings with a summary and a chart, compare a level with the gauge's mean and record levels, and read the water level forecasts, the daily readings for shipping and the fairway depths on the Elbe and Oder. Start a workflow when a reading rises above or falls below a mark. No account or API key required.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/pegel-online

## Actions

### Get a chart of readings

Get the address of PEGELONLINE's own chart of a gauge's readings over a period, as a PNG image to put in an email or a message. Coastal gauges also show the predicted tide.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement (`timeseries`, text): What to read: the list holds what this gauge measures. Water level (W) by default; others include discharge (Q) and water temperature (WT). Default: `W`.
- From (`start`, date and time): Read from this moment instead of a period back from now. It must be within the last 31 days.
- To (`end`, date and time): Read up to this moment. Defaults to now.
- Period (`period`, text): How far back to read, up to the 31 days PEGELONLINE keeps. Used when no start is given. One of: `PT6H` (Last 6 hours), `PT12H` (Last 12 hours), `P1D` (Last day), `P3D` (Last 3 days), `P7D` (Last 7 days), `P15D` (Last 15 days), `P31D` (Last 31 days). Default: `P7D`.
- Width (pixels) (`width`, number): The image's width. Defaults to 900. From 200 to 2000. Default: `900`.
- Height (pixels) (`height`, number): The image's height. Defaults to 400. From 100 to 1000. Default: `400`.

**Outputs**

- `end` (text): The end of the period charted, empty for now
- `height` (number): The image's height in pixels
- `size_bytes` (number): The image's size, checked by downloading it
- `start` (text): The start of the period charted
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `timeseries` (text): What is charted, as a code
- `url` (text): The address of the chart, a PNG image
- `width` (number): The image's width in pixels

**Example output**

```json
{
  "end": "",
  "height": 400,
  "size_bytes": 30923,
  "start": "2026-10-14T06:00:00Z",
  "station_name": "K\u00d6LN",
  "station_uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
  "timeseries": "W",
  "url": "https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/a6ee8177-107b-47dd-bcfd-30960ccc6e9c/W/measurements.png?start=2026-10-14T06:00:00Z&width=900&height=400",
  "width": 900
}
```

### Get a gauge's reference levels

Get the levels a gauge's readings are judged against: the lowest and highest on record, mean low, mean and mean high water, the highest level shipping may run at and the high water marks, each explained in English, with how far the current reading is above or below it.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement (`timeseries`, text): What to read: the list holds what this gauge measures. Water level (W) by default; others include discharge (Q) and water temperature (WT). Default: `W`.

**Outputs**

- `count` (number): How many reference levels the gauge has
- `current_time` (text): When it was taken
- `current_value` (number): The latest reading
- `levels` (list): The gauge's reference levels, lowest first
- `levels_exceeded` (list): The codes of the levels the current reading is above
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `timeseries` (text): What was read, as a code such as W
- `timeseries_name` (text): What was read, in words
- `unit` (text): The unit of the readings
- `water` (text): The water it is on

**Example output**

```json
{
  "count": 2,
  "current_time": "2026-10-21T08:00:00+02:00",
  "current_value": 64.0,
  "levels": [
    {
      "applies": "on 2018-10-23",
      "code": "NNW",
      "difference": -5.0,
      "german_name": "Niedrigster Niedrigwasserstand",
      "name": "Lowest water level on record",
      "unit": "cm",
      "value": 69.0
    },
    {
      "applies": "averaged 2010-11-01 to 2020-10-31",
      "code": "MHW",
      "difference": -661.0,
      "german_name": "Mittel der Hochwasserst\u00e4nde",
      "name": "Mean high water level",
      "unit": "cm",
      "value": 725.0
    }
  ],
  "levels_exceeded": [],
  "station_name": "K\u00d6LN",
  "station_uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
  "timeseries": "W",
  "timeseries_name": "Water level",
  "unit": "cm",
  "water": "RHEIN"
}
```

### Get a gauging station

Get one gauge: where it is, who runs it, everything it measures with the latest reading of each, the height of its zero, and any note about a fault.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.

**Outputs**

- `agency` (text): The waterways office that runs it
- `km` (number): Where it is along the water, in river kilometres
- `latitude` (number): The gauge's latitude
- `longitude` (number): The gauge's longitude
- `name` (text): The gauge's name, such as KÖLN
- `number` (text): The gauge's official number
- `phone` (text): The number to call for spoken readings, if any
- `timeseries` (list): Everything the gauge measures
- `url` (text): The gauge's page on pegelonline.wsv.de
- `uuid` (text): The gauge's permanent PEGELONLINE ID
- `water` (text): The code of the river, canal or sea it is on, such as RHEIN
- `water_name` (text): That water's full name

**Example output**

```json
{
  "agency": "STANDORT K\u00d6LN",
  "km": 688.0,
  "latitude": 50.936949,
  "longitude": 6.9633,
  "name": "K\u00d6LN",
  "number": "2730010",
  "phone": "+49 228 286527 567",
  "timeseries": [
    {
      "code": "W",
      "comment": "",
      "current_time": "2026-10-21T08:00:00+02:00",
      "current_value": 64.0,
      "gauge_zero_m": 35.038,
      "interval_minutes": 15,
      "name": "Water level",
      "state_mnw_mhw": "low",
      "state_nsw_hsw": "normal",
      "unit": "cm"
    },
    {
      "code": "Q",
      "comment": "Abflussermittlung unter W = 50cm aktuell nicht m\u00f6glich",
      "current_time": "2026-10-21T07:45:00+02:00",
      "current_value": 622.0,
      "gauge_zero_m": null,
      "interval_minutes": 15,
      "name": "Discharge",
      "state_mnw_mhw": "",
      "state_nsw_hsw": "",
      "unit": "m\u00b3/s"
    }
  ],
  "url": "https://www.pegelonline.wsv.de/gast/stammdaten?pegelnr=2730010",
  "uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
  "water": "RHEIN",
  "water_name": "RHEIN"
}
```

### Get a water level forecast

Get the water level forecast for the next few days at one of the 40 or so gauges that publish one on the Rhine, Elbe, Danube and Oder: a forecast for about two days and a less certain estimate beyond, with who made it and when.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.

**Outputs**

- `count` (number): How many points there are
- `issued_at` (text): When the forecast was made
- `issued_by` (text): Who made it, in their own words
- `last_time` (text): When that is
- `last_value` (number): The level forecast furthest ahead
- `maximum` (number): The highest level forecast
- `minimum` (number): The lowest level forecast
- `points` (list): The forecast, earliest first
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `water` (text): The water it is on

**Example output**

```json
{
  "count": 2,
  "issued_at": "2026-10-20T07:00:00+02:00",
  "issued_by": "Vorhersagen und Absch\u00e4tzungen vom: 20.10.2026 um 07:00 Uhr, Quelle: Bundesanstalt f\u00fcr Gew\u00e4sserkunde.",
  "last_time": "2026-10-24T07:00:00+02:00",
  "last_value": 37.0,
  "maximum": 37.0,
  "minimum": 20.0,
  "points": [
    {
      "high": null,
      "kind": "forecast",
      "low": null,
      "timestamp": "2026-10-20T09:00:00+02:00",
      "value": 20.0
    },
    {
      "high": 45.0,
      "kind": "estimate",
      "low": 30.0,
      "timestamp": "2026-10-24T07:00:00+02:00",
      "value": 37.0
    }
  ],
  "station_name": "KAUB",
  "station_uuid": "1d26e504-7f9e-480a-b52c-5932be6549ab",
  "water": "RHEIN"
}
```

### Get checked daily readings

Get the checked water levels a shipping gauge publishes at fixed times each day, with the change since the day before. These are the figures the inland shipping notices use.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Period (`period`, text): How far back to read, up to the 31 days PEGELONLINE keeps. One of: `PT6H` (Last 6 hours), `PT12H` (Last 12 hours), `P1D` (Last day), `P3D` (Last 3 days), `P7D` (Last 7 days), `P15D` (Last 15 days), `P31D` (Last 31 days). Default: `P7D`.

**Outputs**

- `count` (number): How many readings there are
- `latest_time` (text): When that was
- `latest_value` (number): The newest reading
- `readings` (list): The readings, newest first
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `water` (text): The water it is on

**Example output**

```json
{
  "count": 2,
  "latest_time": "2026-10-12T05:00:00+02:00",
  "latest_value": 77.0,
  "readings": [
    {
      "difference": 4.0,
      "timestamp": "2026-10-12T05:00:00+02:00",
      "value": 77.0
    },
    {
      "difference": 4.0,
      "timestamp": "2026-10-11T21:00:00+02:00",
      "value": 76.0
    }
  ],
  "station_name": "BONN",
  "station_uuid": "593647aa-9fea-43ec-a7d6-6476a76ae868",
  "water": "RHEIN"
}
```

### Get current levels along a river

Get the latest reading at every gauge along one river or canal, upstream first, each marked low, normal or high against its own mean water levels. One step answers 'how is the Rhine doing today'.

**Inputs**

- Water (`water`, text, required): The river, canal or sea.
- Measurement (`timeseries`, text): What to read at each gauge. Water level by default. Default: `W`.

**Outputs**

- `count` (number): How many gauges reported
- `high_count` (number): How many are at or above mean high water
- `low_count` (number): How many are at or below mean low water
- `stations` (list): Each gauge's latest reading, upstream first
- `timeseries` (text): What was read, as a code
- `timeseries_name` (text): What was read, in words
- `water` (text): The water's code
- `water_name` (text): The water's full name

**Example output**

```json
{
  "count": 2,
  "high_count": 0,
  "low_count": 2,
  "stations": [
    {
      "km": 546.3,
      "name": "KAUB",
      "state_mnw_mhw": "low",
      "state_nsw_hsw": "normal",
      "timestamp": "2026-10-21T08:00:00+02:00",
      "unit": "cm",
      "uuid": "1d26e504-7f9e-480a-b52c-5932be6549ab",
      "value": 21.0
    },
    {
      "km": 688.0,
      "name": "K\u00d6LN",
      "state_mnw_mhw": "low",
      "state_nsw_hsw": "normal",
      "timestamp": "2026-10-21T08:00:00+02:00",
      "unit": "cm",
      "uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
      "value": 64.0
    }
  ],
  "timeseries": "W",
  "timeseries_name": "Water level",
  "water": "RHEIN",
  "water_name": "RHEIN"
}
```

### Get fairway depths on the Elbe and Oder

Get the daily fairway depth, or the deepest a ship may lie, on one section of the Elbe, the Oder or their waterways, as published for shipping. A day the section was closed or not reported says so.

**Inputs**

- Section (`section`, text, required): The stretch of water, as the list names it.
- Period (`period`, text): How far back to read, up to the 31 days PEGELONLINE keeps. One of: `PT6H` (Last 6 hours), `PT12H` (Last 12 hours), `P1D` (Last day), `P3D` (Last 3 days), `P7D` (Last 7 days), `P15D` (Last 15 days), `P31D` (Last 31 days). Default: `P7D`.

**Outputs**

- `count` (number): How many days there are
- `kind` (text): fairway_depth (water over the channel bed) or draught (deepest a ship may lie)
- `latest_depth_cm` (number): The newest depth given
- `latest_time` (text): When that was
- `readings` (list): The depths, newest first
- `section` (text): The section's code, such as E2
- `section_name` (text): The stretch of water the section covers
- `station_name` (text): That gauge's name
- `station_uuid` (text): The gauge the section is read at
- `water` (text): The water the section is on

**Example output**

```json
{
  "count": 2,
  "kind": "fairway_depth",
  "latest_depth_cm": 95.0,
  "latest_time": "2026-10-21T06:00:00+02:00",
  "readings": [
    {
      "depth_cm": 95.0,
      "note": "",
      "timestamp": "2026-10-21T06:00:00+02:00"
    },
    {
      "depth_cm": 103.0,
      "note": "",
      "timestamp": "2026-10-20T06:00:00+02:00"
    }
  ],
  "section": "E2",
  "section_name": "Dresden bis Riesa",
  "station_name": "DRESDEN",
  "station_uuid": "70272185-b2b3-4178-96b8-43bea330dcae",
  "water": "ELBE"
}
```

### Get readings over a period

Get a gauge's readings over a period of up to 31 days, newest first, with the lowest, highest and average reading and how much it changed. Readings come every 15 minutes at most gauges and every minute on the coast.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement (`timeseries`, text): What to read: the list holds what this gauge measures. Water level (W) by default; others include discharge (Q) and water temperature (WT). Default: `W`.
- From (`start`, date and time): Read from this moment instead of a period back from now. It must be within the last 31 days.
- To (`end`, date and time): Read up to this moment. Defaults to now.
- Period (`period`, text): How far back to read, up to the 31 days PEGELONLINE keeps. Used when no start is given. One of: `PT6H` (Last 6 hours), `PT12H` (Last 12 hours), `P1D` (Last day), `P3D` (Last 3 days), `P7D` (Last 7 days), `P15D` (Last 15 days), `P31D` (Last 31 days). Default: `P1D`.
- Readings to return (`limit`, number): The most readings to return, newest first. The summary covers the whole period whatever this is. Defaults to 100. From 1 to 5000. Default: `100`.

**Outputs**

- `average` (number): The average reading
- `change` (number): The latest minus the earliest
- `count` (number): How many readings are in this result
- `end` (text): The end of the period read, in UTC
- `first_value` (number): The earliest reading
- `last_value` (number): The latest reading
- `maximum` (number): The highest reading in the period
- `maximum_time` (text): When it was highest
- `minimum` (number): The lowest reading in the period
- `minimum_time` (text): When it was lowest
- `readings` (list): The readings, newest first
- `start` (text): The start of the period read, in UTC
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `timeseries` (text): What was read, as a code such as W
- `timeseries_name` (text): What was read, in words
- `total_readings` (number): How many readings the period holds
- `unit` (text): The unit of the readings
- `water` (text): The water it is on

**Example output**

```json
{
  "average": 58.6,
  "change": 10.0,
  "count": 2,
  "end": "2026-10-21T06:00:00Z",
  "first_value": 54.0,
  "last_value": 64.0,
  "maximum": 64.0,
  "maximum_time": "2026-10-21T08:00:00+02:00",
  "minimum": 54.0,
  "minimum_time": "2026-10-20T08:15:00+02:00",
  "readings": [
    {
      "timestamp": "2026-10-21T08:00:00+02:00",
      "value": 64.0
    },
    {
      "timestamp": "2026-10-21T07:45:00+02:00",
      "value": 63.0
    }
  ],
  "start": "2026-10-20T06:00:00Z",
  "station_name": "K\u00d6LN",
  "station_uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
  "timeseries": "W",
  "timeseries_name": "Water level",
  "total_readings": 96,
  "unit": "cm",
  "water": "RHEIN"
}
```

### Get the current reading

Get a gauge's latest reading, such as the water level, with how old it is, whether it is low, normal or high against the gauge's own mean levels, and for a water level its height above sea level.

**Inputs**

- Gauge (`station`, text, required): The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement (`timeseries`, text): What to read: the list holds what this gauge measures. Water level (W) by default; others include discharge (Q) and water temperature (WT). Default: `W`.

**Outputs**

- `age_minutes` (number): How many minutes ago that was
- `comment` (text): A note about a fault or outage, empty when none
- `level_above_sea_m` (number): For a water level in cm, the water's height above sea level (NHN) in metres
- `state_mnw_mhw` (text): How the reading compares with the gauge's mean low and high water: low, normal, high, unknown, commented (a fault) or out-dated
- `state_nsw_hsw` (text): How it compares with the highest navigable water level: normal, high, unknown, commented or out-dated
- `station_name` (text): The gauge's name
- `station_uuid` (text): The gauge's PEGELONLINE ID
- `timeseries` (text): What was read, as a code such as W
- `timeseries_name` (text): What was read, in words
- `timestamp` (text): When it was taken, in German local time
- `timestamp_utc` (text): When it was taken, in UTC
- `unit` (text): The unit of the readings
- `value` (number): The latest reading
- `water` (text): The water it is on

**Example output**

```json
{
  "age_minutes": 12,
  "comment": "",
  "level_above_sea_m": 35.678,
  "state_mnw_mhw": "low",
  "state_nsw_hsw": "normal",
  "station_name": "K\u00d6LN",
  "station_uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
  "timeseries": "W",
  "timeseries_name": "Water level",
  "timestamp": "2026-10-21T08:00:00+02:00",
  "timestamp_utc": "2026-10-21T06:00:00Z",
  "unit": "cm",
  "value": 64.0,
  "water": "RHEIN"
}
```

### List gauging stations

List the gauges on Germany's federal waterways, narrowed by river or canal, by name, by what they measure, around a place, or along a stretch of river. Each comes with its ID for the other steps, its river kilometre and what it measures.

**Inputs**

- Waters (`waters`, list): Only gauges on these rivers, canals or seas.
- Name contains (`name_contains`, text): Only gauges whose name contains this text.
- Measures (`measures`, text): Only gauges that measure this, such as discharge or water temperature.
- Near latitude (`latitude`, number): With a longitude, find gauges around this point. From -90 to 90.
- Near longitude (`longitude`, number): With a latitude, find gauges around this point. From -180 to 180.
- Within (km) (`radius_km`, number): How far from the point or the river kilometre to look. Defaults to 25. From 1 to 1000.
- Near river kilometre (`river_km`, number): With exactly one water chosen, find gauges around this river kilometre, such as 688 for Köln on the Rhine. From -100 to 5000.
- How many to return (`limit`, number): The most gauges to return. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many gauges are in this result
- `stations` (list): The gauges that matched, by water and position
- `total_matching` (number): How many matched before the limit

**Example output**

```json
{
  "count": 2,
  "stations": [
    {
      "agency": "STANDORT K\u00d6LN",
      "km": 654.8,
      "latitude": 50.737,
      "longitude": 7.1063,
      "measures": [
        "W",
        "Q",
        "WT"
      ],
      "name": "BONN",
      "number": "2710080",
      "url": "https://www.pegelonline.wsv.de/gast/stammdaten?pegelnr=2710080",
      "uuid": "593647aa-9fea-43ec-a7d6-6476a76ae868",
      "water": "RHEIN",
      "water_name": "RHEIN"
    },
    {
      "agency": "STANDORT K\u00d6LN",
      "km": 688.0,
      "latitude": 50.936949,
      "longitude": 6.9633,
      "measures": [
        "Q",
        "W"
      ],
      "name": "K\u00d6LN",
      "number": "2730010",
      "url": "https://www.pegelonline.wsv.de/gast/stammdaten?pegelnr=2730010",
      "uuid": "a6ee8177-107b-47dd-bcfd-30960ccc6e9c",
      "water": "RHEIN",
      "water_name": "RHEIN"
    }
  ],
  "total_matching": 2
}
```

### List waters

List the rivers, canals and seas PEGELONLINE has gauges on, with how many gauges each has and the code the other steps take.

**Inputs**

- Name contains (`name_contains`, text): Only waters whose name or code contains this text.

**Outputs**

- `count` (number): How many are in this result
- `waters` (list): The rivers, canals and seas, alphabetically

**Example output**

```json
{
  "count": 2,
  "waters": [
    {
      "code": "ELBE",
      "name": "ELBE",
      "station_count": 73
    },
    {
      "code": "RHEIN",
      "name": "RHEIN",
      "station_count": 36
    }
  ]
}
```
