Key Register of the Subsurface (BRO)

Base URL

https://publiek.broservices.nl

Endpoints 13

• POST/{domein}/{type}/{versie}/characteristics/searchesSearch an area (circle in km or box in WGS84) and period; XML response with numberOfDocuments and key data per object. For gmw, cpt, bhrp, bhrg, bhrgt, sfr, guf, epc, epl (not for gld, gar, gmn, frd, gpd).
• GET/{domein}/{type}/{versie}/objects/{broId}One full registration object, as XML in the BRO model (fullHistory=ja for wells and licences).
• GET/{domein}/{type}/{versie}/bro-ids?bronhouder={kvk}All bro-ids of one source holder (Chamber of Commerce number required); registered=ja|nee.
• GET/gm/v1/gmw-relations/{broId}For a well: the tubes and references to groundwater level (GLD), composition (GAR) and network (GMN) dossiers, as JSON.
• GET/gm/v1/gmn-relations/{broId}For a network: its wells and tubes, as JSON.
• GET/gm/gld/v1/seriesAsCsv/{broId}Groundwater level series as CSV: timestamp plus a value and remark column per kind (provisional, assessed, control, unknown).
• GET/gm/gld/v1/objects/{broId}/observationsSummaryOverview of the observations in a dossier (id, start, end, type, status), as JSON.
• GET/gm/gld/v1/objects/{broId}/observations/{observationId}One observation as XML, with startTVPTime/endTVPTime or mostRecentTVP.
• GET/gm/gld/v1/objectsAsCsv/{broId}The whole groundwater level dossier as CSV (rapportagetype, observatietype).
• GET/gm/gmw/v1/groundlevelposition-as-csv/{broId}Ground level of a well over time, as CSV.
• GET/gm/gmn/v1/networksList of monitoring networks, filterable by source holder, monitoring purpose and measuring points (without a filter: 204 empty).
• GET/gu/gpd/v1/seriesAsCsv/{broId}Extracted and injected volumes of a groundwater production dossier as CSV.
• POST/gm/gar/v1/table/dispatchGroundwater composition as a table for a dispatch result.

The APIs of this source 1 · from the provider's documentation from the description

Filtering from the description

No query language: a JSON body (criteria set) with area, periods and a few attributes. Then continue per bro-id.

Parameters 11

Fields in the responses (selection: well search result and series CSV) 9

Limits and pitfalls

• A search that would return more than 2,000 objects is rejected: HTTP 400 with responseType 'rejection' and the reason 'Het aantal objecten is groter dan 2000' (more than 2000 objects). Make the area or period smaller. tested
• No key and no documented rate limit. A search returning 15 wells (31 kB XML) came back in 0.3 s. tested
• Errors are XML with responseType 'rejection' and a rejectionReason, also for an unknown bro-id ('Registratieobject GMW999999999999 bestaat niet.', HTTP 400). tested
• Dates differ per endpoint: observationsSummary gives 29-07-1971 (DD-MM-YYYY), seriesAsCsv epoch milliseconds (or ISO 8601 with asISO8601=true), XML ISO 8601. tested
• The OpenAPI descriptions are YAML (application/yaml), not JSON; tools that read only JSON must convert first. There are 15 services: /gm/{frd,gar,gld,gmn,gmw}/v1, /gm/v1, /sr/bhrp/v2, /sr/bhrg/v3, /sr/bhrgt/v2, /sr/cpt/v1, /sr/sfr/v2, /gu/{gpd,guf}/v1, /ep/{epc,epl}/v1. tested
• Wells with quality regime IMBRO/A (72,798 of 97,768) were migrated from older archives and are less complete. Removed wells are still included (deregistered/removal). experience
• robots.txt of publiek.broservices.nl returned HTTP 503 (16 Oct 2026): no rules to read. We only use the documented API with small calls. tested

Try it HTTP 200 · 362 ms · 16 Oct

https://publiek.broservices.nl/gm/v1/gmw-relations/GMW000000004076

{
  "gmwBroId": "GMW000000004076",
  "monitoringTubeReferences": [
    {
      "tubeNumber": 1,
      "screenTopPosition": -10.05,
      "gmnReferences": [],
      "gldReferences": [
        {
          "broId": "GLD000000002796",
          "url": "https://publiek.broservices.nl/gm/gld/v1/objects/GLD000000002796",
          "accountableParty": "30277172"
        }
      ],
      "garReferences": []
    }
  ],
  "characteristics": null
}

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