v1 geen sleutel nodigCORS open

Documentatie

Eén envelop, één veldnamenstelsel, één foutformaat — voor elke bron-API, elke dataset en elke combi-API. Wie één endpoint kent, kent ze alle 20.311.

Kies een endpoint. Alles begint met https://Identix.org/v1/. Geen registratie, geen sleutel — CORS staat open, dus u kunt direct vanuit de browser ontwikkelen.

Doe de aanroep. Dezelfde aanroep staat klaar in curl, JavaScript en Python. Plak hem in uw terminal en u hebt binnen een seconde antwoord.

Lees de envelop. Uw data staat in data; waar het vandaan komt in bronnen[], met licentie, attributie en responstijd per instantie.

Of pak een SDK. Voor Python, .NET, PHP en Go zijn er officiële clients: envelop-parsing, paginering, batch en integriteitsverificatie als native code — zie SDK's.

Algemene conventies

Tien afspraken die overal gelden. Ze zijn er zodat u per bron niets nieuws hoeft te leren.

Conventie	Betekenis
Alles is een API	Directe bron-API's, élke dataset uit de landelijke catalogus (20.304 stuks) én combi-API's die bronnen combineren.
bron-api	Achter dit endpoint staat een onderliggende API van de instantie zelf (PDOK, CBS, RDW, …). Wij houden een adapter bij die de brontaal vertaalt naar de standaard.
dataset	Achter dit endpoint staat een dataset uit de landelijke catalogus. Identix.org haalt hem live op bij de publicerende instantie.
combi-api	Een afgeleid product van Identix.org: meerdere bronnen worden parallel geraadpleegd en in één antwoord gecombineerd.
`snake_case`	Alle veldnamen zijn snake_case, in elke API.
ISO-8601 (UTC)	Alle tijdstempels als `2026-08-20T19:00:00Z`.
WGS84 + RD	Coördinaten standaard in WGS84 (`lon`/`lat`), waar beschikbaar aangevuld met Rijksdriehoek.
`null`	Betekent "onbekend of afgeschermd bij de bron". Broncodes zoals `'.'` worden nooit doorgestuurd.
Authenticatie	Geen sleutel vereist. CORS staat open (`*`).
Actualiteit	Live bij de bron opgevraagd, maximaal 24 uur gecached (luchtkwaliteit 30 minuten).

De envelop

geldt voor elk endpoint

Elk antwoord heeft dezelfde buitenkant. U schrijft uw parser één keer.

Bij CC BY-bronnen (zoals CBS) bevat bronnen[] een verplicht attributie-veld dat u bij hergebruik dient mee te geven.

Foutafhandeling

RFC 7807

Alle fouten — ook wanneer een bron onbereikbaar is — volgen RFC 7807. Uw foutafhandeling is dus ook maar één keer werk.

Status	Betekenis
`400`	Ongeldige of ontbrekende parameter (zie `title`).
`404`	Onbekend endpoint — zie `GET /v1/bronnen`.
`429`	Limiet bereikt; `Retry-After` vertelt wanneer u weer mag.
`502`	De broninstantie is onbereikbaar of gaf een fout; details in `detail`.
`500`	Interne fout (zou niet moeten voorkomen).

Dataverificatie & integriteit

Elk antwoord is onafhankelijk verifieerbaar. Drie mechanismen, zodat u ons niet op ons woord hoeft te geloven.

1 · Hash over de genormaliseerde data

Elke response bevat integriteit.hash: een SHA-256 over de canonieke JSON van data. Herbereken hem en vergelijk.

2 · Exacte bron-URL per antwoord

Elke registratie in bronnen[] bevat bron_url: de exacte aanroep die wij bij de instantie deden, parameters incluis. Haal die zelf op en vergelijk de ruwe bron met onze weergave.

3 · Normalisatiebeleid

Wij veranderen nooit inhoud. Alleen formaat: coderingen naar snake_case, datums naar ISO-8601, CBS-"onbekend"-codes naar null, coördinaten naar WGS84 (+RD), getallen naar getallen.

Standaard	Toepassing
ISO 8601	Alle datums en tijdstempels (UTC, `Z`-suffix).
RFC 7807	Foutformaat voor alle endpoints.
SHA-256 (FIPS 180-4)	Integriteits-hash per antwoord.
DCAT-AP NL	Catalogus-ontsluiting sluit aan op de landelijke datasetmetadata.
W3C PROV-O	`bronnen[]` is een PROV-achtige herkomstregistratie: entiteit, tijdstip, activiteit.
GeoJSON (RFC 7946)	Geometrieën in `geometrie_wgs84`.

Op de roadmap: ondertekende responses (HMAC met klantsleutel), een publiek auditlog van bron-versies, en ISO/IEC 27001-certificering van de hosting.

Enterprise-functies

geldt voor élk endpoint

Filteren, sorteren, pagineren, conditionele requests en batch — op bron-API's én datasets, zonder uitzondering.

Filteren, sorteren en pagineren op alles

Parameter	Werking
`waar` herhaalbaar	`kolom=waarde` (exact), `kolom~deel`, `kolom!=`, `kolom>=`, `kolom<=`; meerdere = EN. Werkt op élke lijstrespons.
`velden`	Kolomselectie, komma-gescheiden.
`sorteer` + `richting`	Sortering, numeriek waar mogelijk.
`rijen` / `start`	Paging (max 500); bij expliciete paging stuurt de server een `Link`-header.

De integriteits-hash wordt na filtering herberekend — verificatie blijft kloppen.

Conditionele requests (ETag / 304)

Elke succesvolle response draagt een ETag, gelijk aan de integriteits-hash. Stuur If-None-Match mee: ongewijzigd → 304 Not Modified zonder body. Met Accept-Encoding: gzip worden antwoorden groter dan 1 KB gecomprimeerd.

Batch-uitvoering

Maximaal 25 aanvragen per batch, elk met eigen parameters en filters. Eén roundtrip voor portfolio- en dashboardgebruik.

Limieten en gebruiksinzicht

Anoniem geldt een royale limiet: 600 aanroepen per uur per IP, met X-RateLimit-*-headers en Retry-After bij een 429. Voor productiegebruik vraagt u een eigen quotum aan; verbruik ziet u in GET /v1/gebruik.

BAG · Adressen

Livebron-api

Zoeken in de Basisregistratie Adressen en Gebouwen. Drie aanroepen: vrij zoeken, autocomplete en volledige details op id.

GET/v1/bag/adressenvrij zoeken

GET/v1/bag/suggesttype-ahead, lichte respons

GET/v1/bag/lookupvolledig adres op id

Parameters

Parameter	Vereist	Beschrijving
`q`	verplicht	Zoekterm, minimaal 2 tekens. Bijvoorbeeld `Nieuwmarkt 1 Amsterdam`.
`rows`	optioneel	Resultaten per pagina, 1–50. Standaard 10.
`start`	optioneel	Startpositie voor paginering.

Responsvelden

Veld	Type	Beschrijving
`adres_id`	string	Stabiele BAG-identificatie van de nummeraanduiding.
`straat`, `huisnummer`, `postcode`, `woonplaats`	string / int	Adrescomponenten, los benaderbaar.
`gemeente`, `wijk`, `buurt`	object	Bestuurlijke indeling met officiële codes.
`coordinaten`	object	`lat`, `lon` in WGS84 en `rd_x`, `rd_y` in Rijksdriehoek.
`perceel`	object · nullable	Gekoppeld kadastraal perceel, of `null` als de bron het niet levert.

Bron: PDOK Locatieserver (BAG), beheerd door het Kadaster. Licentie CC0 1.0 — geen attributieplicht.

CBS · Kerncijfers

Livebron-api

Buurt-, wijk- en gemeentecijfers: bevolking, huishoudens, woningvoorraad, WOZ-waarde en inkomen.

GET/v1/cbs/kerncijferscijfers op regiocode

GET/v1/cbs/regiosregio's binnen een gebied

Parameters

Parameter	Vereist	Beschrijving
`regio`	verplicht	Regiocode, bijvoorbeeld `WK0363AE` (wijk) of `GM0363` (gemeente).
`jaar`	optioneel	Peiljaar; laat weg voor het meest recente. Meerdere jaren via `/trend`.
`binnen`	verplicht bij /regios	Bovenliggend gebied waarbinnen u zoekt.
`niveau`	verplicht bij /regios	Eén van `buurt`, `wijk`, `gemeente`.

Bron: CBS StatLine, tabel "Kerncijfers wijken en buurten". Licentie CC BY 4.0 — attributie "CBS, Den Haag" verplicht. Elk kerncijfer is { waarde, eenheid }; waarde is null waar het CBS afschermt.

Combi-API's

Livecombi-api

Meerdere bronnen, parallel geraadpleegd, in één antwoord. Alle veertien volgen hetzelfde patroon: één pad, geen sleutel, en bronnen[] vertelt precies welke instanties eraan hebben bijgedragen.

GET/v1/adres/{postcode}/{huisnummer}/contextBAG + CBS + Kadaster + RCE

GET/v1/pand/{postcode}/{huisnummer}/dossiergebouwdossier

GET/v1/regio/{code}/vergelijk?met={code}twee regio's naast elkaar

GET/v1/punt/{lon}/{lat}/contextreverse geocoding + context

Eén call, meerdere bronnen. Valt één bron uit, dan blijft het antwoord staan: die bron krijgt status: "fout" in bronnen[] en zijn velden worden null. Uw integratie breekt niet.

Datasets

Livedataset

Alle 20.304 datasets uit de landelijke catalogus zijn individueel bevraagbaar — met dezelfde filters, sortering en paginering als elke andere API.

GET/v1/catalogus/datasets?q=zoek in de catalogus

GET/v1/datasets/{id}/querybevraag de inhoud

Voor LLM's & agents

Live145 MCP-tools

Het Model Context Protocol stelt alle API's beschikbaar als aanroepbare tools. Twee transporten: JSON-RPC 2.0 over POST /mcp, of lokaal via stdio.

Toolantwoorden dragen dezelfde envelop als de HTTP-aanroepen, inclusief bronmetadata. Fouten komen terug als isError: true met een leesbare boodschap, zodat een agent zichzelf kan corrigeren.

Liever geen MCP? GET /llms.txt geeft een compact markdown-overzicht, en /openapi.yaml laat u tools genereren uit een machine-leesbaar contract.

Alle bron-API's hieronder volgen hetzelfde patroon: endpoints, parametertabel, responsvelden, broncallout en live voorbeeld. Machine-leesbaar register: GET /v1/bronnen.

Algemene conventies

Conventie	Betekenis
Alles is een API	Identix.org biedt alles als API aan: directe bron-API's, élke dataset uit de landelijke catalogus (20.304 stuks) én combi-API's die bronnen combineren. Het responsformaat is identiek; het label `bron_type` in de envelop vermeldt de herkomst.
bron-API	Achter dit endpoint staat een onderliggende API van de instantie zelf (PDOK, CBS, RDW, …). Wij houden een directe adapter bij die de brontaal vertaalt naar de standaard — volledige veldcuratie, paging, historie waar de bron die biedt.
dataset	Achter dit endpoint staat een onderliggende dataset uit de landelijke catalogus (data.overheid.nl). Identix.org haalt de dataset live op bij de publicerende instantie en ontsluit de inhoud universeel: CSV als tabel, ArcGIS als features, JSON direct. Zie `GET /v1/datasets/{id}/data`.
combi-api	Dit endpoint is een afgeleid product van Identix.org: meerdere bronnen worden parallel geraadpleegd en in één antwoord gecombineerd (adres-context, pand-dossier, regio-vergelijking, wet-artikel-relevantie). `bronnen[]` vermeldt álle geraadpleegde bronnen mét hun licentie — attributie geldt per bron.
`snake_case`	Alle veldnamen zijn `snake_case`, in elke API.
ISO-8601 (UTC)	Alle tijdstempels als `2026-08-20T19:00:00Z`.
WGS84 + RD	Coördinaten standaard in WGS84 (`lon`/`lat`), waar beschikbaar aangevuld met Rijksdriehoek.
`null`	Betekent "onbekend of afgeschermd bij de bron". Broncodes zoals `"."` worden nooit doorgestuurd.
Authenticatie	Geen sleutel vereist. CORS staat open (`*`), zodat u direct uit een browser kunt ontwikkelen.
Actualiteit	Antwoorden worden live bij de bron opgevraagd en maximaal 24 uur gecached (luchtkwaliteit 30 minuten).

De envelop

Elk succesvol antwoord heeft dezelfde buitenkant, ongeacht de API:

{
  "api": "api.identix.org",
  "versie": "v1",
  "onderdeel": "bag.adressen",          // welke API u aanriep
  "bron_type": "bron-api",              // 'bron-api', 'dataset' of 'combi-api'
  "gegenereerd_op": "2026-08-20T19:12:03Z",
  "duur_ms": 312,                        // totale responstijd
  "bronnen": [{                          // herkomst van dít antwoord
    "naam": "PDOK Locatieserver",
    "instantie": "Kadaster / PDOK",
    "licentie": "CC0 1.0",
    "duur_ms": 280,
    "uit_cache": false,
    "status": "ok"
  }],
  "data": { ... }                        // de genormaliseerde inhoud
}

Bij CC BY-bronnen (zoals CBS) bevat bronnen[] tevens een verplicht attributie-veld dat u bij hergebruik dient mee te geven.

Foutafhandeling

Alle fouten — ook wanneer een bron onbereikbaar is — volgen RFC 7807:

HTTP/1.1 400 Bad Request
{
  "type": "about:blank",
  "title": "Parameter 'q' is verplicht (minimaal 2 tekens)",
  "status": 400
}

Status	Betekenis
`400`	Ongeldige of ontbrekende parameter (zie `title`).
`404`	Onbekend endpoint — zie `GET /v1/bronnen`.
`502`	De broninstantie is onbereikbaar of gaf een fout; details in `detail`.
`500`	Interne fout (zou niet moeten voorkomen).

Dataverificatie & integriteit

Elk antwoord is onafhankelijk verifieerbaar. Drie mechanismen:

1. Hash over de genormaliseerde data

Elke response bevat integriteit.hash: een SHA-256 over de canonieke JSON van data. U herberekent die hash en vergelijkt — zo weet u dat het antwoord niet onderweg is gewijzigd:

import hashlib, json

canoniek = json.dumps(antwoord["data"], sort_keys=True,
                      separators=(",", ":"), ensure_ascii=False)
hash = hashlib.sha256(canoniek.encode("utf-8")).hexdigest()
assert hash == antwoord["integriteit"]["hash"]   # 1:1

2. Exacte bron-URL per antwoord

Elke bronnen[]-registratie bevat bron_url: de exacte aanroep die wij bij de instantie deden (parameters incluis). Haal die zelf op en vergelijk de ruwe bron met onze genormaliseerde weergave — er mag inhoudelijk niets anders verschillen dan formaatnormalisatie.

3. Normalisatiebeleid (wat wij wél en niét veranderen)

Wij veranderen nooit inhoud. Alleen formaat: coderingen naar snake_case, datums naar ISO-8601, CBS-'onbekend'-codes naar null, coördinaten naar WGS84 (+RD), getallen naar getallen. Ontbrekende of afgeschermde bronwaarden worden null — nooit ingevuld, geschat of gecorrigeerd.

Standaarden

Standaard	Toepassing
ISO 8601	Alle datums en tijdstempels (UTC, `Z`-suffix).
RFC 7807	Foutformaat voor alle endpoints.
SHA-256 (FIPS 180-4)	Integriteits-hash per antwoord.
DCAT-AP NL	Catalogus-ontsluiting sluit aan op de landelijke datasetmetadata (titel, instantie, licentie, resources).
W3C PROV-O (invulling)	`bronnen[]` is een PROV-achtige herkomstregistratie: entiteit (bron), tijdstip (gegenereerd_op), activiteit (bron_url, duur_ms, cache-status).
GeoJSON (RFC 7946)	Geometrieën in `geometrie_wgs84`.

Op de roadmap: ondertekende responses (HMAC met klantsleutel), een publiek auditlog van bron-versies, en ISO/IEC 27001-certificering van de hosting.

Enterprise-functies

Deze mogelijkheden gelden voor élk endpoint — bron-API's én datasets.

Filteren, sorteren en pagineren op alles

GET /v1/rdw/voertuigen?merk=TESLA&waar=catalogusprijs_eur>=50000&sorteer=catalogusprijs_eur&richting=desc&velden=kenteken,merk&rijen=5&start=5

Parameter	Werking
`waar` (herhaalbaar)	`kolom=waarde` (exact), `kolom~deel`, `kolom!=`, `kolom>=`, `kolom<=`; meerdere = EN. Werkt op élke lijstrespons.
`velden`	Kolomselectie (komma-gescheiden).
`sorteer` + `richting`	Sortering, numeriek waar mogelijk.
`rijen` / `start`	Paging (max 500); bij expliciete paging stuurt de server een `Link`-header (`rel="next"`/`prev`).

De integriteits-hash wordt na filtering herberekend — verificatie blijft kloppen.

Conditionele requests (ETag / 304)

Elke succesvolle response draagt een ETag (gelijk aan de integriteits-hash). Stuur If-None-Match mee: ongewijzigd → 304 Not Modified zonder body. Met Accept-Encoding: gzip worden antwoorden > 1 KB gecomprimeerd.

Batch-uitvoering

POST /v1/batch
{ "aanvragen": [
    { "pad": "/v1/bag/adressen", "parameters": { "q": "Dam 1" } },
    { "pad": "/v1/cbs/kerncijfers", "parameters": { "regio": "WK0363AE" } } ] }

Maximaal 25 aanvragen per batch, elk met eigen parameters en enterprise-filters. Eén roundtrip voor portfolio- en dashboard-use-cases.

API-sleutels, rate limiting en gebruiksinzicht

Anoniem geldt een royale limiet (standaard 600/uur per IP; X-RateLimit-*-headers en Retry-After bij 429). Voor productiegebruik: een sleutel met eigen quotum via POST /v1/sleutels (vereist X-Admin-Token), meesturen als X-API-Key-header. Verbruiksinzicht via GET /v1/gebruik.

Roadmap enterprise

HMAC-ondertekende responses · webhooks/mutatie-notificaties · SLA's en prioriteitsqueu's · SSO/teamaccounts · auditlog-export · dedicated hosting (ISO 27001).

BAG · Adressen

live Kadaster / PDOK CC0

Zoekt adressen in de Basisregistratie Adressen en Gebouwen: straat, huisnummer, postcode, woonplaats, gemeente, wijk, buurt, kadastrale percelen en coördinaten.

Aanroepen

GET /v1/bag/adressen?q={zoekterm}&rows=8&start=0    // zoeken met paging
GET /v1/bag/suggest?q={fragment}&rows=6              // type-ahead
GET /v1/bag/lookup?id={object-id}                     // object per id

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/bag/adressen`	`q`	ja	Vrije zoekterm: adres, postcode + huisnummer, plaatsnaam.	`q=Dam 1, Amsterdam`
	`rows`	nee	Aantal resultaten per pagina (1–50, standaard 8).	`rows=10`
	`start`	nee	Paging-offset (standaard 0). `totaal_in_bron` in de respons geeft de totaalomvang.	`start=10`
`/v1/bag/suggest`	`q`	ja	Begin van een zoekterm; levert `{id, weergavenaam, type}` — licht en snel, ideaal voor autocomplete.	`q=keizersgr`
`/v1/bag/suggest`	`rows`	nee	Aantal suggesties (1–25, standaard 6).	`rows=5`
`/v1/bag/lookup`	`id`	ja	Locatieserver-id (uit `suggest` of `adressen`); adres-objecten worden volledig genormaliseerd.	`id=adr-2a8dc1af…`

Responsvelden (per resultaat)

Veld	Type	Beschrijving
`nummeraanduiding_id`	string	BAG-identificatie van de nummeraanduiding (koppelsleutel binnen de BAG).
`straat` / `huisnummer` / `huisletter` / `huisnummertoevoeging`	string / int	Geadresseerde openbare ruimte en huisnummertoevoegingen.
`postcode` / `woonplaats`	string	Postcode (1234AB) en woonplaatsnaam.
`gemeente` / `provincie`	object	`{code, naam}`; provincie ook `afkorting`.
`wijk` / `buurt`	object	CBS-gebiedscodes (`WK0363AE`, `BU0363AE02`) met naam — direct te gebruiken in de CBS-API.
`percelen[]`	array	Gekoppelde kadastrale percelen (`ASD04-F-6417`) — direct bruikbaar als locatiehint voor de Kadaster-API.
`geometrie`	object	`centroide_wgs84 {lon, lat}` en `centroide_rd {lon, lat}`.

Bron en brondocumentatie

Bron: PDOK Locatieserver (BAG). Licentie CC0 1.0 — vrij hergebruik, geen attributie verplicht.
Onderliggende documentatie: pdok.nl · Locatieserver · Kadaster BAG API

Laag	Belangrijkste velden	Geometrie
`percelen`	`kadastrale_aanduiding`, `kadastrale_aanduiding_code`, `kadastrale_gemeente`, `sectie`, `perceelnummer`, `oppervlak_m2`, `soort_grootte`, `status`, `geldig_vanaf`	polygon
`grenzen`	`type_grens` (Definitief/voorlopig), `kwaliteitsklasse`, `status`, `perceel_links_id`, `perceel_rechts_id`, `geldig_vanaf`	lijn
`bebouwing`	`bag_pand_id` (koppeling naar BAG-pand!), `status_bgt`, `in_onderzoek`, `relatieve_hoogteligging`, `bronhouder`	(multi-)polygon
`openbareruimtenamen`	`naam`, `type` (Weg/Water/…), `bag_openbare_ruimte_id`, `hoek` (kaartlabel-oriëntatie)	punt
`nummeraanduidingreeksen`	`label` (huisnummer), `vbo_id_laagste_huisnummer`, `vbo_id_hoogste_huisnummer`, `bebouwing_id`	punt

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/luchtmeetnet/metingen`	`station`	ja	Stationnummer uit de stationslijst.	`station=NL49565`
	`formule`	nee	Filter op één stof: `PM10`, `PM25`, `O3`, `NO2`, `SO2`, `CO`…	`formule=PM10`
	`van`	nee	Start tijdbereik (ISO-8601). Zonder filter: meest recente metingen.	`van=2026-08-19T00:00:00`
	`tot`	nee	Eind tijdbereik (ISO-8601).	`tot=2026-08-19T06:00:00`
`/v1/luchtmeetnet/stations`	`zoek`	nee	Filter op (deel van) locatienaam of stationnummer.	`zoek=amsterdam`
`/v1/luchtmeetnet/stations`	`pagina`	nee	Pagina van de bronlijst (standaard 1); `laatste_pagina` staat in de respons.	`pagina=2`

Veld	Type	Beschrijving
`stof`	string	Formule: `PM10`, `PM25`, `O3`, `NO2`, `SO2`, `CO`, …
`waarde`	number	Gemeten waarde; `null` = niet beschikbaar.
`eenheid`	string	Voor zover vastgesteld: `µg/m³` (CO: `mg/m³`), anders `null`.
`gemeten_op`	string	Meettijdstip, ISO-8601 UTC.

Parameter	Verplicht	Beschrijving	Voorbeeld
`kenteken`	ja (of `merk`)	Nederlands kenteken; streepjes en spaties worden genegeerd, hoofdletterongevoelig.	`kenteken=XS005T`
`merk`	ja (of `kenteken`)	Merknaam voor een zoekresultaat.	`merk=TESLA`
`rows`	nee	Max. resultaten bij merkpzoek (1–100, standaard 10).	`rows=5`

Parameter	Verplicht	Beschrijving	Voorbeeld
`rijksmonumentnummer`	één van de drie	Monumentnummer (exact).	`518313`
`postcode` + `straat`	één van de drie	Samen opgeven; postcode wordt genormaliseerd naar 1234AB.	`1012JS + Dam`
`woonplaatsnaam`	één van de drie	Plaatsnaam.	`Amsterdam`
`page`	nee	Pagina (standaard 1, 25 per pagina).	`page=2`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/cbs/kerncijfers`	`regio`	ja	Regiocode: buurt (`BU…`), wijk (`WK…`) of gemeente (`GM…`).	`regio=WK0363AE`
`/v1/cbs/kerncijfers`	`jaar`	nee	Peiljaar (standaard: nieuwste tabel). Nuttig voor jaar-op-jaar vergelijking.	`jaar=2024`
`/v1/cbs/regios`	`binnen`	ja	Bovenliggende regiocode: alle wijken van een gemeente, alle buurten van een wijk, enz.	`binnen=GM0363`
`/v1/cbs/regios`	`niveau`	ja	Gevraagd niveau: `buurt`, `wijk` of `gemeente`.	`niveau=wijk`

Veld	Type	Beschrijving
`regio`	object	`code`, `niveau` (buurt/wijk/gemeente), `naam`, `indelingswijziging` (gb-wijziging t.o.v. voorgaand jaar).
`kerncijfers.{veld}`	object	Altijd `{waarde, eenheid}`; `waarde: null` = afgeschermd door CBS.

Parameter	Verplicht	Beschrijving	Voorbeeld
`lon`	ja	Lengtegraad in WGS84 (decimaal).	`lon=4.8930`
`lat`	ja	Breedtegraad in WGS84 (decimaal).	`lat=52.3730`
`radius`	nee	Zoekstraal in meters (5–2000, standaard 50). Max. 100 objecten per opvraag.	`radius=100`
`id`	ja (pad)	Alleen voor `/percelen/{id}`: kadastrale objectidentificatie.	`/v1/kadaster/percelen/11440871270001`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/wet/regelingen`	`q`	ja	Zoekterm op regelingnaam of BWB-id (minimaal 2 tekens); doorzoekt het register van bekende wetten.	`q=woningwet`
`/v1/wet/regeling/{bwb_id}`	`bwb_id`	ja (in het pad)	BWB-identificatie van de regeling; élk geldig BWB-id werkt.	`BWBR0005181`
`/v1/wet/regeling/{bwb_id}`	`artikel`	nee	Artikelnummer (of lid-vorm) waarop gefilterd wordt; zonder deze parameter alle artikelen.	`artikel=2`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/amsterdam/datasets`	`q`	nee	Zoekterm op naam, beschrijving of tag; zonder `q` de complete catalogus.	`q=parkeer`
`/v1/amsterdam/datasets/{id}/data`	`tabel`	nee	Tabelnaam (zie `/tabellen`); standaard de eerste tabel.	`tabel=buurt`
	`rijen`	nee	Rijen per pagina (1–500, standaard 50).	`rijen=25`
	`pagina`	nee	Paginanummer (vanaf 1); de bron pagineert via cursors, wij reiken dat aan als `pagina`.	`pagina=2`
	`velden`	nee	Komma-gescheiden veldnamen voor een smalle selectie.	`velden=id,buurtNaam`
	`sorteer`	nee	Sorteerveld uit de tabel.	`sorteer=buurtNaam`
	`id`	ja (in het pad)	Dataset-id uit de catalogus.	`/v1/amsterdam/datasets/parkeervakken/data`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/weer/nu` · `/v1/weer/voorspelling`	`lon`	ja	Lengtegraad (WGS84, ook met komma).	`lon=4.8930`
`/v1/weer/nu` · `/v1/weer/voorspelling`	`lat`	ja	Breedtegraad (WGS84).	`lat=52.3730`
`/v1/weer/voorspelling`	`dagen`	nee	1–16 dagen, standaard 7.	`dagen=7`

Parameter	Verplicht	Beschrijving	Voorbeeld
`entiteit`	ja (in het pad)	Entiteitset — enkelvoudig, zoals de bron: `Zaak`, `Document`, `Stemming`, `Persoon`…	`/v1/kamer/Zaak`
`rijen`	nee	1–500, standaard 50.	`rijen=25`
`start`	nee	Skip voor paginering.	`start=50`
`velden`	nee	Komma-gescheiden bronvelden (PascalCase).	`velden=Nummer,Onderwerp`
`sorteer`	nee	Bronveld; `-`-prefix = aflopend.	`sorteer=-Aangifte`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/rijksmuseum/collectie`	`type`	één van de vier	Objecttype.	`type=painting`
	`maker`	één van de vier	Maker (bron: `creator`).	`maker=Rembrandt`
	`materiaal`	één van de vier	Materiaal/techniek.	`materiaal=olieverf`
	`objectnummer`	één van de vier	Direct op objectnummer.	`objectnummer=SK-A-4691`
	`pagina_token`	nee	Cursor uit `volgende_token` van de vorige respons.	`pagina_token=eyJ0…`
`/v1/rijksmuseum/object/{objectnummer}`	`objectnummer`	ja (in het pad)	Objectnummer of LOD-URI.	`/v1/rijksmuseum/object/SK-A-4691`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/catalogus/datasets`	`q`	nee	Vrije zoekterm in titel, beschrijving en tags. Leeg = alles.	`q=luchtkwaliteit`
	`instantie`	nee	Filter op instantie-slug (uit `instanties`).	`instantie=gemeente-rotterdam`
	`rows`	nee	Aantal resultaten (1–100, standaard 10).	`rows=25`
	`start`	nee	Paging-offset; `totaal_in_bron` geeft de omvang.	`start=25`
`/v1/catalogus/datasets/{id}`	`id`	ja (pad)	Dataset-slug of -uuid (veld `id` uit zoekresultaten).	`/v1/catalogus/datasets/energielabel-postcode-assen`
`/v1/catalogus/instanties`	—	—	Alle publicerende instanties, grootste eerst.	—
`/v1/datasets/{id}/query`	`waar`	nee (herhaalbaar)	Filteren als een normale API: `kolom=waarde` (exact), `kolom~deel` (bevat), `kolom!=waarde`, `kolom>=getal`, `kolom<=getal`. Meerdere voorwaarden = EN.	`waar=MEAN_EnergieLAB=A&waar=postcode~9401`
	`velden` / `sorteer` + `richting`	nee	Kolomselectie (komma-gescheiden) en sortering (asc/desc).	`velden=postcode,label&sorteer=postcode`
	`rijen` / `start`	nee	Paging (1–500, standaard 50).	`rijen=100&start=100`
	De dataset wordt bij de eerste aanroep gematerialiseerd (volledig opgehaald, ArcGIS zonder geometrie) en 24 uur als query-baar materiaal aangeboden — daarna automatisch ververst. Elke response vermeldt `materiaal.opgehaald_op` en `uit_cache`.
	`/v1/datasets/{id}/data`	`id`	ja (pad)	De data zelf: catalogus raadplegen, resource kiezen, ophalen, normaliseren. CSV → tabel, ArcGIS → features, JSON → direct; PDF/XLS → heldere melding.	`/v1/datasets/energielabel-postcode-assen/data`
`resource`		nee	Resource-index uit de dataset-detailrespons (standaard 0).	`resource=1`
`rijen`		nee	Max. rijen/features (1–500, standaard 50).	`rijen=100`

Veld	Type	Beschrijving
`id` / `uuid`	string	Slug (bruikbaar in de detail-call) en interne UUID.
`titel` / `samenvatting`	string	Titel en beschrijving van de dataset.
`instantie` / `instantie_slug`	string	Publicerende organisatie (naam + slug).
`licentie` / `toegangsrechten`	string	Bijv. "CC-BY (4.0)" en "PUBLIC".
`high_value_dataset`	boolean	Of het een Europese high-value dataset is.
`tags[]`	array	Onderwerpstags.
`resources[]`	array	Per resource: `naam`, `formaat` (genormaliseerd: CSV, JSON, …), `url` en `api` (of het een webservice is).
`heeft_api`	boolean	True als minstens één resource een API-dienst is — de kandidaten voor directe adapters.
`laatst_gewijzigd`	string	Metadata-wijziging (ISO-8601).

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/afm/instellingen`	`q`	nee	Zoekterm in statutaire- én handelsnamen (hoofdletterongevoelig).	`q=volmacht`
	`kvk_nummer`	nee	Exact KvK-nummer (8 cijfers).	`kvk_nummer=94805172`
	`land` / `plaats`	nee	Land van zetel / vestigingsplaats (deel van de naam).	`land=Oostenrijk`
	`ep`	nee	Inkomende Europese paspoorting: `ja` of `nee`.	`ep=ja`
	`waar/velden/sorteer/rijen/start`	nee	Enterprise-laag: filter op velden, kies velden, sorteer, pagina (rijen max 500).	`waar=land=Nederland&rijen=25`
`/v1/afm/instellingen/{id}`	`id`	ja	AFM-instellings-id (GUID) uit de lijstrespons; levert het volledige dossier met vergunningen, producten, diensten en beleidsbepalers.	`/v1/afm/instellingen/4385f1d1-…`
`/v1/afm/vergunningen`	`vergunningnummer`	nee	Exact AFM-vergunningnummer.	`vergunningnummer=12050233`
	`instelling_id`	nee	Alle vergunningen van één instelling.	`instelling_id=4385f1d1-…`
	`status`	nee	Onze afleiding: `geldig` (geen einddatum of einddatum ≥ peildatum) of `beëindigd`.	`status=geldig`

Veld	Type	Beschrijving
`id`	string	AFM-instellings-id (GUID) — sleutel voor het dossier.
`statutaire_naam` / `handelsnamen[]`	string / array	Officiële naam en handelsnamen (met `start_datum`).
`kvk_nummer` / `rechtsvorm` / `land` / `statutaire_zetel`	string	Bedrijfsgegevens zoals in het register.
`vestigingsadres` / `postadres`	object	`{straat, huisnummer, postcode, plaats, landcode}`.
`inkomend_ep`	object	Inkomende Europese paspoorting: `{heeft_inkomend_ep, heeft_bijkantoor}`.
`vergunningen[]`	array	Per vergunning: `vergunningnummer`, `start_datum`, `eind_datum`, `status` (geldig/beëindigd), `producten[]` met `diensten[]` en `beleidsbepalers[]`.
`peildatum` / `bron_url` / `vers`	—	In élke respons: peildatum van het geïmporteerde extract, URL van het officiële extract en de verversingsstatus (nooit stil verouderd).

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/dnb/instellingen`	`q`	nee	Zoekterm in statutaire- en handelsnaam (hoofdletterongevoelig).	`q=ing bank`
	`kvk_nummer` / `rsin` / `lei`	nee	Exacte identificaties — koppelsleutels naar KvK en GLEIF.	`kvk_nummer=73712590`
	`deelregister`	nee	Deel van een deelregisternaam (Banken, Verzekeraars, Pensioenfondsen, Betaalinstellingen, …).	`deelregister=Pensioenfondsen`
	`land` / `plaats`	nee	Statutair land / vestigingsplaats (deel van de naam).	`land=Nederland`
	`waar/velden/sorteer/rijen/start`	nee	Enterprise-laag: filter, kies velden, sorteer, pagina (rijen max 500).	`waar=lei!=&rijen=25`
			Elke instelling: `relatienummer` (DNB-sleutel), namen, KvK/RSIN/LEI, adressen, `deelregisters[]`, registratietellingen, `in_liquidatie`.
`/v1/dnb/instellingen/{relatienummer}`	`relatienummer`	ja	Volledig dossier met alle registraties (type, wetsartikel, begin/eind, status, activiteiten, gerelateerde relaties).	`/v1/dnb/instellingen/R182615`
`/v1/dnb/registraties`	`deelregister`	nee	Filter op deel van een deelregisternaam.	`deelregister=Banken`
	`status`	nee	Onze afleiding: `geldig` (geen einddatum of ≥ peildatum) of `beëindigd`.	`status=geldig`
	`type` / `q`	nee	Registratietype (Vergunning, Ontheffing, Goedkeuring…) / naamzoekterm.	`type=Vergunning`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/anbi/instellingen`	`q`	nee	Zoekterm in naam én alias (hoofdletterongevoelig).	`q=rozenkruis`
	`rsin`	nee	Exact RSIN (9 cijfers, incl. voorloopnullen) — koppelsleutel naar KvK/LEI.	`rsin=001000652`
	`plaats`	nee	Vestigingsplaats (deel van de naam).	`plaats=Haarlem`
	`status` / `cultuur`	nee	Status: `geldig`/`beëindigd` (onze afleiding tegen de peildatum); cultuur-ANBI: `ja`/`nee`.	`status=geldig&cultuur=ja`
	`waar/velden/sorteer/rijen/start`	nee	Enterprise-laag: filter, kies velden, sorteer, pagina (rijen max 500).	`waar=status=geldig&rijen=25`
`/v1/anbi/instellingen/{id}`	`id`	ja	RSIN van de instelling, of het dossiernummer voor de vijf wettelijke ANBI's (Staat, Provincie, Gemeente, Waterschap, buitenlandse wettelijke).	`/v1/anbi/instellingen/001000652`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/gleif/entiteiten`	`q`	nee	Zoekterm in naam (hoofdletterongevoelig).	`q=snap-on`
	`kvk_nummer`	nee	Exact KvK-nummer (8 cijfers) — directe koppeling naar het handelsregister.	`kvk_nummer=34153487`
	`plaats` / `status`	nee	Plaats (deel van) / `actief` (ACTIVE+ISSUED) of `inactief`.	`status=actief`
	`waar/velden/sorteer/rijen/start`	nee	Enterprise-laag over álle 195.000+ entiteiten (rijen max 500).	`waar=status=actief&rijen=25`
`/v1/gleif/entiteiten/{lei}`	`lei`	ja	20-teken LEI; volledig record met datums, statussen en beherende LOU.	`/v1/gleif/entiteiten/04VK4ASM6OJ180YRBJ15`
`/v1/gleif/kvk/{kvk_nummer}`	`kvk_nummer`	ja	De brug in één call: alle LEI-records (actief én historisch) die bij één KvK-nummer horen.	`/v1/gleif/kvk/34153487`

Call	Parameter	Verplicht	Beschrijving	Voorbeeld
`/v1/klimaatmonitor/variabelen`	`q`	nee	Zoekterm in naam, code of keyword.	`q=co2`
	`bron`	nee	Filter op de databron van de variabele (bijv. CBS, PBL).	`bron=CBS`
	`rijen/start`	nee	Paginering (rijen max 200).	`rijen=50&start=0`
`/v1/klimaatmonitor/variabelen/{code}`	`code`	ja	Externe code van de variabele — metadata incl. beschikbare jaren en gebiedsniveaus.	`/v1/klimaatmonitor/variabelen/aandeel_zon_vermogen_won`
`/v1/klimaatmonitor/waarden`	`variabele`	ja	Externe code van de variabele.	`variabele=aandeel_zon_vermogen_won`
	`geo_level`	nee	Gebiedsniveau: nederland, provincie, gemeente, wijk, buurt, pc4 …	`geo_level=gemeente`
	`geo_code`	nee	Exacte gebiedscode (zoals in de bron, bijv. gemeente_106).	`geo_code=gemeente_106`
	`jaar` / `rijen/start`	nee	Jaar (bijv. 2023) en paginering (rijen max 1000).	`jaar=2023`

Tool	Parameters	Komt overeen met
`bag_adressen`	`q` · `rows` · `start`	`GET /v1/bag/adressen`
`bag_suggest`	`q` · `rows`	`GET /v1/bag/suggest`
`bag_lookup`	`id`	`GET /v1/bag/lookup`
`cbs_kerncijfers`	`regio` · `jaar`	`GET /v1/cbs/kerncijfers`
`cbs_regios`	`binnen` · `niveau`	`GET /v1/cbs/regios`
`kadaster_percelen`	`lon`, `lat` · `radius`	`GET /v1/kadaster/percelen`
`kadaster_perceel`	`id`	`GET /v1/kadaster/percelen/{id}`
`kadaster_grenzen`	`lon`, `lat` · `radius`	`GET /v1/kadaster/grenzen`
`kadaster_bebouwing`	`lon`, `lat` · `radius`	`GET /v1/kadaster/bebouwing`
`kadaster_openbareruimtenamen`	`lon`, `lat` · `radius`	`GET /v1/kadaster/openbareruimtenamen`
`kadaster_nummeraanduidingreeksen`	`lon`, `lat` · `radius`	`GET /v1/kadaster/nummeraanduidingreeksen`
`luchtmeetnet_metingen`	`station` · `formule` · `van` · `tot`	`GET /v1/luchtmeetnet/metingen`
`luchtmeetnet_stations`	`zoek`	`GET /v1/luchtmeetnet/stations`

Documentatie

Algemene conventies

De envelop

Foutafhandeling

Dataverificatie & integriteit

1 · Hash over de genormaliseerde data

2 · Exacte bron-URL per antwoord

3 · Normalisatiebeleid

Enterprise-functies

Filteren, sorteren en pagineren op alles

Conditionele requests (ETag / 304)

Batch-uitvoering

Limieten en gebruiksinzicht

BAG · Adressen

Parameters

Responsvelden

CBS · Kerncijfers

Parameters

Combi-API's

Datasets

Voor LLM's & agents

Algemene conventies

De envelop

Foutafhandeling

Dataverificatie & integriteit

1. Hash over de genormaliseerde data

2. Exacte bron-URL per antwoord

3. Normalisatiebeleid (wat wij wél en niét veranderen)

Standaarden

Enterprise-functies

Filteren, sorteren en pagineren op alles

Conditionele requests (ETag / 304)

Batch-uitvoering

API-sleutels, rate limiting en gebruiksinzicht

Roadmap enterprise

BAG · Adressen

Aanroepen

Responsvelden (per resultaat)

Bron en brondocumentatie

CBS · Kerncijfers

Aanroepen

Responsvelden

Bron en brondocumentatie

Kadaster · Kadastrale percelen

Aanroepen

Responsvelden per laag

Bron en brondocumentatie

Luchtmeetnet · Metingen

Aanroepen

Responsvelden (per meting)

Bron en brondocumentatie

Waterschappen · Oppervlaktewateren IMWA

KB · Collecties & linked data

ESEF · Jaarverslagen (iXBRL)

Collectie Nederland · Museumcollecties

Tweede Kamer · SyncFeed

Open Archieven · Persoonsaktes (A2A)

Open Beelden · Audiovisueel erfgoed

RDW · Voertuigen

Aanroepen

Responsvelden (per voertuig)

Bron en brondocumentatie

RCE · Rijksmonumenten

Aanroepen

Bron en brondocumentatie

Wetgeving · BWB-regelingen

Aanroepen

Bron en brondocumentatie

Rechtspraak · Uitspraken

Aanroepen

Bron en brondocumentatie

Amsterdam · Dataplatform

Aanroepen

Bron en brondocumentatie

Combi-API's · Koppelingen op de data

Adres-context — alles rond één adres

Pand-dossier — gebouw, perceel, monument, buurt

Regio-vergelijking — kerncijfers naast elkaar

Wet-artikel-relevantie — artikel + weg naar jurisprudentie

Punt-context — alles rond één coördinaat