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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
stationtextRequired - The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement
timeseriestext - 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
startdate and time - Read from this moment instead of a period back from now. It must be within the last 31 days.
- To
enddate and time - Read up to this moment. Defaults to now.
- Period
periodtext - 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
- Gauge
stationtextRequired - The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement
timeseriestext - 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
- Gauge
stationtextRequired - 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
- Gauge
stationtextRequired - 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
- Gauge
stationtextRequired - The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Period
periodtext - 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
- Water
watertextRequired - The river, canal or sea.
- Measurement
timeseriestext - 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
- Section
sectiontextRequired - The stretch of water, as the list names it.
- Period
periodtext - 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
- Gauge
stationtextRequired - The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement
timeseriestext - 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
startdate and time - Read from this moment instead of a period back from now. It must be within the last 31 days.
- To
enddate and time - Read up to this moment. Defaults to now.
- Period
periodtext - 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
limitnumber - 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
- Gauge
stationtextRequired - The gauge, picked from the list or typed as its name (KÖLN), its official number (2730010) or its ID.
- Measurement
timeseriestext - 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
- Waters
waterslist - Only gauges on these rivers, canals or seas.
- Name contains
name_containstext - Only gauges whose name contains this text.
- Measures
measurestext - Only gauges that measure this, such as discharge or water temperature.
- Near latitude
latitudenumber - With a longitude, find gauges around this point.From -90 to 90.
- Near longitude
longitudenumber - 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 kilometre
river_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 return
limitnumber - 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 contains
name_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
}
]
}