Samen Meten (RIVM)

Base URL

https://api-samenmeten.rivm.nl/v1.0

Endpoints 9

• GET/ThingsSensor boxes; properties with project, owner, municipality code and the nearest official stations per substance (no2closecode, pm25regiocode …).
• GET/DatastreamsOne series per box and quantity, named <box>-<no>-<quantity> (SMC_20058-21-pm25_kal), with unit.
• GET/Datastreams({id})/ObservationsHourly values of one series (phenomenonTime, result).
• GET/ObservationsAll observations; always filter, the whole set is too big to count.
• GET/ObservedPropertiesThe 9 quantities: pm10, pm25, pm10_kal, pm25_kal (calibrated), no2, nh3, temp, rh, pres.
• GET/SensorsThe 52 sensors by name (Sensirion SEN5x, AirVisual …); the number in description reappears in the datastream name.
• GET/LocationsBox locations (GeoJSON point); search nearby with geo.distance.
• GET/HistoricalLocationsEarlier locations of a box (moved).
• GET/FeaturesOfInterestWhat an observation is about (usually the location).

Filtering platform

OData-like expressions in $filter (SensorThings), also on properties/… and with geo.distance(location, geography'SRID=4326;POINT(lon lat)') le <degrees>.

Parameters 6

Fields in the response (selection) 8

Limits and pitfalls

• $top at most 200 per page; follow @iot.nextLink for the rest. tested
• Counting over all Observations or all active boxes timed out (HTTP 504). Count per series or per project. experience
• Particulate matter has two series per box: raw (pm25, pm10) and calibrated (pm25_kal, pm10_kal, 'fijnstof gekalibreerd' in ObservedProperties). Compare only the _kal series with official measurements. tested
• geo.distance only works with geography'SRID=4326;POINT(lon lat)', distance in degrees (0.005 ≈ 350 m east-west). experience
• A mistake in $filter returns 400 with the raw database error ('pq: column "bogus" does not exist'): handy to check field names. tested
• Each box lists in properties the nearest official Luchtmeetnet stations per substance: compare directly with the reference measurement. tested

Try it HTTP 200 · 387 ms · 16 Oct

https://api-samenmeten.rivm.nl/v1.0/Datastreams?$filter=name eq 'SMC_20058-21-pm25_kal'&$expand=Observations($top=3;$orderby=phenomenonTime desc)

{
  "value": [
    {
      "@iot.id": 56399,
      "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)",
      "name": "SMC_20058-21-pm25_kal",
      "description": "SMC_20058-21-pm25_kal",
      "unitOfMeasurement": {
        "definition": "https://qudt.org/vocab/unit/MicroGM-PER-M3",
        "symbol": "ug/m3"
      },
      "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
      "Thing@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/Thing",
      "Sensor@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/Sensor",
      "ObservedProperty@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/ObservedProperty",
      "Observations": [
        {
          "@iot.id": 733886641,
          "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)",
          "phenomenonTime": "2026-10-16T20:00:00.000Z",
          "result": 3.01,
          "Datastream@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)/Datastream",
          "FeatureOfInterest@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)/FeatureOfInterest",
          "resultTime": null
        },
        {
          "@iot.id": 733875902,
          "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)",
          "phenomenonTime": "2026-10-16T19:00:00.000Z",
          "result": 15.09,
          "Datastream@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)/Datastream",
          "FeatureOfInterest@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)/FeatureOfInterest",
          "resultTime": null
        }
      ]
    }
  ]
}

Shortened response, saved at harvest time. Click the URL for the real, current response.