Welcome to the IOC SLSMF API
This API provides access to sealevel monitoring data.
To request API keys needed for version 2 of this API, please visit the SLSMF api page.
You will need to register for an account.
If you already have an account, edit your account and request access to the "Access gauges API (gauges_API)" group.
More documentation on this API can be found on GitHub.
Available Versions:
Changelogs:
- 2024-02-21
Added parameter skip_gaps_until - 2021-12-15
Fix documentation for "showall" parameter. - 2013-08-08
Bugfix for displaying the same sensor more than once on the 'stationlist' page. Date format changed to ISOdate consistently. - 2012-11-08
Added documentation about the 'includesensors' parameter. - 2011-12-12
Added documentation about missing values and 'nofilter' option. - 2011-04-18
Put all date formats to YYYY-MM-DD HH:MM,
added formats xtab and html for data query, fixed chronology bug in bgraph output - 2011-03-22
Changed XML output to reduce size, fields are trimmed, dates sent as normal string with CDATA tag - 2011-03-14
Bug correction in XML output for query=station, first sensor was dropped - 2011-03-13
We simplified the ascii output of the stationlist query by removing the message examples, url's and graph_urls. And removed tabs from all strings.
We added the optional =contacts and =performance formats for all formats of the stationlist query.
Added sensorid to the sensorlist output.
- 2024-09-15
Beta release - 2025-03-24
Public release of API V2 together with research dataset and enpoint. - 2025-04-09
Removed duplicated code, lat and lon fields from /v2/stations and code field from /v2/stations/{code} - 2026-02-10
Breaking changes for /v2/research/stations- original_stime is replaced by fit_to_sample_rate, which aligns the data to the sample rate, by adding extra records with slevel is set to NA and qc flag missing. Timestamps are rounded down to the expected time of measurement based on the sample rate.
- level_data renamed to subtract_30d_average
- Filters no longer remove records, only set slevel to NA
- For DART buoys without includesensors[]=prt, prte is now added to prt
Other changes for /v2/research/stations- Maximum lowered for days_per_page from 3650 to 365
- flag_qc now shows new columns: missing, distinctness, completeness, shift
- New filters added: filter_completeness, filter_distinctness, filter_shift on day level. Previously this was applied by default.
Data changes- Clean up of research data by removing non-sealevel measuring sensor types: bat, prd, sw1, sw2, atm