Basisregistratie Ondergrond (BRO)

Basisadres

https://publiek.broservices.nl

Endpoints 13

• POST/{domein}/{type}/{versie}/characteristics/searchesZoeken in een gebied (cirkel in km of rechthoek in WGS84) en periode; antwoord XML met numberOfDocuments en kengegevens per object. Voor gmw, cpt, bhrp, bhrg, bhrgt, sfr, guf, epc, epl (niet voor gld, gar, gmn, frd, gpd).
• GET/{domein}/{type}/{versie}/objects/{broId}Eén registratieobject volledig, als XML in het BRO-model (fullHistory=ja bij putten en vergunningen).
• GET/{domein}/{type}/{versie}/bro-ids?bronhouder={kvk}Alle bro-ids van één bronhouder (KvK-nummer verplicht); registered=ja|nee.
• GET/gm/v1/gmw-relations/{broId}Bij een put: de buizen en de grondwaterstand- (GLD), samenstellings- (GAR) en meetnetverwijzingen (GMN), als JSON.
• GET/gm/v1/gmn-relations/{broId}Bij een meetnet: de putten en buizen erin, als JSON.
• GET/gm/gld/v1/seriesAsCsv/{broId}Grondwaterstandreeks als CSV: tijdstip plus een waarde- en opmerkingkolom per soort (voorlopig, beoordeeld, controle, onbekend).
• GET/gm/gld/v1/objects/{broId}/observationsSummaryOverzicht van de observaties in een dossier (id, begin, eind, type, status), als JSON.
• GET/gm/gld/v1/objects/{broId}/observations/{observationId}Eén observatie als XML, met startTVPTime/endTVPTime of mostRecentTVP.
• GET/gm/gld/v1/objectsAsCsv/{broId}Heel het grondwaterstandendossier als CSV (rapportagetype, observatietype).
• GET/gm/gmw/v1/groundlevelposition-as-csv/{broId}Maaiveldhoogte van een put door de tijd, als CSV.
• GET/gm/gmn/v1/networksLijst van meetnetten, te filteren op bronhouder, monitoringdoel en meetpunten (zonder filter: 204 leeg).
• GET/gu/gpd/v1/seriesAsCsv/{broId}Onttrokken en ingebrachte volumes van een grondwaterproductiedossier als CSV.
• POST/gm/gar/v1/table/dispatchGrondwatersamenstelling als tabel bij een uitgifteresultaat.

De API's van deze bron 1 · uit de documentatie van de aanbieder uit de beschrijving

Filteren uit de beschrijving

Geen querytaal: een JSON-body (kenset) met gebied, periodes en een paar kenmerken. Daarna per bro-id verder.

Parameters 11

Velden in de antwoorden (selectie: zoekresultaat putten en reeks-CSV) 9

Limieten en valkuilen

• Een zoekvraag die meer dan 2.000 objecten zou opleveren wordt geweigerd: HTTP 400 met responseType 'rejection' en de reden 'Het aantal objecten is groter dan 2000'. Maak het gebied of de periode kleiner. getest
• Geen sleutel en geen gedocumenteerde rate limit. Een zoekvraag van 15 putten (31 kB XML) kwam in 0,3 s terug. getest
• Fouten zijn XML met responseType 'rejection' en een rejectionReason, ook voor een onbekend bro-id ('Registratieobject GMW999999999999 bestaat niet.', HTTP 400). getest
• Datums verschillen per endpoint: observationsSummary geeft 29-07-1971 (DD-MM-JJJJ), seriesAsCsv epoch-milliseconden (of ISO 8601 met asISO8601=true), XML ISO 8601. getest
• De OpenAPI-beschrijvingen zijn YAML (application/yaml), geen JSON; tools die alleen JSON lezen moeten eerst omzetten. Er zijn 15 diensten: /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. getest
• Putten met kwaliteitsregime IMBRO/A (72.798 van de 97.768) zijn overgezet uit oudere archieven en minder volledig. Verwijderde putten staan er nog in (deregistered/removal). ervaring
• robots.txt van publiek.broservices.nl gaf HTTP 503 (16 okt 2026): geen regels te lezen. Wij gebruiken alleen de gedocumenteerde API met kleine aanroepen. getest

Probeer het HTTP 200 · 362 ms · 16 okt

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
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.