PEGELONLINE

App · 11 actions

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.

Actions

ActionWhat it does
Get a chart of readingsGet 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.
Get a gauge's reference levelsGet 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.
Get a gauging stationGet 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.
Get a water level forecastGet 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.
Get checked daily readingsGet the checked water levels a shipping gauge publishes at fixed times each day, with the change since the day before.
Get current levels along a riverGet 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.
Get fairway depths on the Elbe and OderGet 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.
Get readings over a periodGet 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.
Get the current readingGet 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.
List gauging stationsList 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.
List watersList the rivers, canals and seas PEGELONLINE has gauges on, with how many gauges each has and the code the other steps take.

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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
Measurementtimeseriestext
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.
Fromstartdate and time
Read from this moment instead of a period back from now. It must be within the last 31 days.
Toenddate and time
Read up to this moment. Defaults to now.
Periodperiodtext
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)widthnumber
The image's width. Defaults to 900.From 200 to 2000. Default: 900.
Height (pixels)heightnumber
The image's height. Defaults to 400.From 100 to 1000. Default: 400.

Outputs

endtext
The end of the period charted, empty for now
heightnumber
The image's height in pixels
size_bytesnumber
The image's size, checked by downloading it
starttext
The start of the period charted
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
timeseriestext
What is charted, as a code
urltext
The address of the chart, a PNG image
widthnumber
The image's width in pixels
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
Measurementtimeseriestext
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

countnumber
How many reference levels the gauge has
current_timetext
When it was taken
current_valuenumber
The latest reading
levelslist
The gauge's reference levels, lowest first
levels_exceededlist
The codes of the levels the current reading is above
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
timeseriestext
What was read, as a code such as W
timeseries_nametext
What was read, in words
unittext
The unit of the readings
watertext
The water it is on
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.

Outputs

agencytext
The waterways office that runs it
kmnumber
Where it is along the water, in river kilometres
latitudenumber
The gauge's latitude
longitudenumber
The gauge's longitude
nametext
The gauge's name, such as KÖLN
numbertext
The gauge's official number
phonetext
The number to call for spoken readings, if any
timeserieslist
Everything the gauge measures
urltext
The gauge's page on pegelonline.wsv.de
uuidtext
The gauge's permanent PEGELONLINE ID
watertext
The code of the river, canal or sea it is on, such as RHEIN
water_nametext
That water's full name
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.

Outputs

countnumber
How many points there are
issued_attext
When the forecast was made
issued_bytext
Who made it, in their own words
last_timetext
When that is
last_valuenumber
The level forecast furthest ahead
maximumnumber
The highest level forecast
minimumnumber
The lowest level forecast
pointslist
The forecast, earliest first
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
watertext
The water it is on
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
Periodperiodtext
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

countnumber
How many readings there are
latest_timetext
When that was
latest_valuenumber
The newest reading
readingslist
The readings, newest first
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
watertext
The water it is on
Example output
{
  "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

WaterwatertextRequired
The river, canal or sea.
Measurementtimeseriestext
What to read at each gauge. Water level by default.Default: W.

Outputs

countnumber
How many gauges reported
high_countnumber
How many are at or above mean high water
low_countnumber
How many are at or below mean low water
stationslist
Each gauge's latest reading, upstream first
timeseriestext
What was read, as a code
timeseries_nametext
What was read, in words
watertext
The water's code
water_nametext
The water's full name
Example output
{
  "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

SectionsectiontextRequired
The stretch of water, as the list names it.
Periodperiodtext
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

countnumber
How many days there are
kindtext
fairway_depth (water over the channel bed) or draught (deepest a ship may lie)
latest_depth_cmnumber
The newest depth given
latest_timetext
When that was
readingslist
The depths, newest first
sectiontext
The section's code, such as E2
section_nametext
The stretch of water the section covers
station_nametext
That gauge's name
station_uuidtext
The gauge the section is read at
watertext
The water the section is on
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
Measurementtimeseriestext
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.
Fromstartdate and time
Read from this moment instead of a period back from now. It must be within the last 31 days.
Toenddate and time
Read up to this moment. Defaults to now.
Periodperiodtext
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 returnlimitnumber
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

averagenumber
The average reading
changenumber
The latest minus the earliest
countnumber
How many readings are in this result
endtext
The end of the period read, in UTC
first_valuenumber
The earliest reading
last_valuenumber
The latest reading
maximumnumber
The highest reading in the period
maximum_timetext
When it was highest
minimumnumber
The lowest reading in the period
minimum_timetext
When it was lowest
readingslist
The readings, newest first
starttext
The start of the period read, in UTC
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
timeseriestext
What was read, as a code such as W
timeseries_nametext
What was read, in words
total_readingsnumber
How many readings the period holds
unittext
The unit of the readings
watertext
The water it is on
Example output
{
  "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

GaugestationtextRequired
The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
Measurementtimeseriestext
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_minutesnumber
How many minutes ago that was
commenttext
A note about a fault or outage, empty when none
level_above_sea_mnumber
For a water level in cm, the water's height above sea level (NHN) in metres
state_mnw_mhwtext
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_hswtext
How it compares with the highest navigable water level: normal, high, unknown, commented or out-dated
station_nametext
The gauge's name
station_uuidtext
The gauge's PEGELONLINE ID
timeseriestext
What was read, as a code such as W
timeseries_nametext
What was read, in words
timestamptext
When it was taken, in German local time
timestamp_utctext
When it was taken, in UTC
unittext
The unit of the readings
valuenumber
The latest reading
watertext
The water it is on
Example output
{
  "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

Waterswaterslist
Only gauges on these rivers, canals or seas.
Name containsname_containstext
Only gauges whose name contains this text.
Measuresmeasurestext
Only gauges that measure this, such as discharge or water temperature.
Near latitudelatitudenumber
With a longitude, find gauges around this point.From -90 to 90.
Near longitudelongitudenumber
With a latitude, find gauges around this point.From -180 to 180.
Within (km)radius_kmnumber
How far from the point or the river kilometre to look. Defaults to 25.From 1 to 1000.
Near river kilometreriver_kmnumber
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 returnlimitnumber
The most gauges to return. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
How many gauges are in this result
stationslist
The gauges that matched, by water and position
total_matchingnumber
How many matched before the limit
Example output
{
  "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 containsname_containstext
Only waters whose name or code contains this text.

Outputs

countnumber
How many are in this result
waterslist
The rivers, canals and seas, alphabetically
Example output
{
  "count": 2,
  "waters": [
    {
      "code": "ELBE",
      "name": "ELBE",
      "station_count": 73
    },
    {
      "code": "RHEIN",
      "name": "RHEIN",
      "station_count": 36
    }
  ]
}

On this page