Documentatie

Algemene conventies

De envelop

Elk succesvol antwoord heeft dezelfde buitenkant, ongeacht de API:

{
  "api": "Identix.org",
  "versie": "v1 (bèta)",
  "onderdeel": "bag.adressen",          // welke API u aanriep
  "bron_type": "bron-api",              // 'bron-api', 'dataset' of 'eigen-dienst'
  "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
}

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

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

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).

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

Responsvelden (per resultaat)

Bron en brondocumentatie

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

Kerncijfers wijken en buurten per regio: inwoners, huishoudens, woningvoorraad, gemiddelde WOZ-waarde, inkomen en leeftijdsopbouw. Regiocodes volgen uit de BAG-API.

Aanroepen

GET /v1/cbs/kerncijfers?regio={code}&jaar=2025     // profiel per regio (en jaar)
GET /v1/cbs/regios?binnen={code}&niveau=wijk     // alle regio's binnen een gebied

Voorbeeld: /v1/cbs/regios?binnen=GM0363&niveau=wijk levert alle 110 Amsterdamse wijken met codes — die elk direct in kerncijfers te gebruiken zijn.

Responsvelden

Beschikbare kerncijfers: inwoners, huishoudens, woningvoorraad, gemiddelde_woz_waarde (€×1000), inkomen_per_ontvanger, inkomen_per_inwoner, aandeel_laagste_inkomens, aandeel_hoogste_inkomens, inwoners_0_tot_15, inwoners_65_plus.

Bron en brondocumentatie

Bron: CBS StatLine, tabel "Kerncijfers wijken en buurten" (jaarlijks wisselend tabel-id; het actuele jaar staat in bronnen[].tabel). Licentie CC BY 4.0 — attributie "CBS, Den Haag" is verplicht en wordt in elk antwoord meegeleverd.
Onderliggende documentatie: cbs.nl · Open Data · tabel-informatie (86165NED)

Alle kadastrale percelen rond een punt: aanduiding (gemeente, sectie, nummer), oppervlak, grootte-soort, historiestatus en geometrie. Combineerbaar met de BAG-API (coördinaten) of de percelen uit een adresrespons.

Aanroepen

GET /v1/kadaster/percelen?lon={l}&lat={b}&radius=50                 // kadastrale percelen
GET /v1/kadaster/grenzen?lon={l}&lat={b}&radius=50                  // perceelsgrenzen (lijnen)
GET /v1/kadaster/bebouwing?lon={l}&lat={b}&radius=50                // gebouwvoetprints (BAG-koppeling)
GET /v1/kadaster/openbareruimtenamen?lon={l}&lat={b}&radius=50      // straatnamen
GET /v1/kadaster/nummeraanduidingreeksen?lon={l}&lat={b}&radius=50  // huisnummerreeksen
GET /v1/kadaster/percelen/{id}                                       // één perceel per id

Alle vijf de kaartlagen delen hetzelfde aanroeppatroon:

Responsvelden per laag

Elk object bevat bovendien objecttype, identificatie en geometrie_wgs84 (GeoJSON). De bag_pand_id- en bag_openbare_ruimte_id-velden sluiten direct aan op de BAG-API.

Bron en brondocumentatie

Bron: PDOK OGC API — Kadastrale kaart (alle vijf de collecties). Licentie CC0 1.0.
Onderliggende documentatie: pdok.nl · Kadastrale kaart OGC API · endpoint-verkenner

Actuele luchtkwaliteitsmetingen per meetstation: stof, waarde, eenheid en meettijdstip. Gebruik de stationslijst om een stationnummer te vinden.

Aanroepen

GET /v1/luchtmeetnet/metingen?station={nr}&formule=PM10&van=…&tot=…   // metingen (+filters)
GET /v1/luchtmeetnet/stations?zoek={filter}&pagina=1                   // stationlijst

Het toegepaste filter wordt in de respons herhaald onder data.filter, zodat antwoorden altijd zelfbeschrijvend zijn.

Responsvelden (per meting)

Bron en brondocumentatie

Bron: Luchtmeetnet (RIVM en samenwerkende GGD'en). Attributie "Luchtmeetnet" bij hergebruik.
Onderliggende documentatie: api-docs.luchtmeetnet.nl · luchtmeetnet.nl

Het landelijke waterbeheer-register: waterdelen, oevers, oppervlaktewaterlichamen, profielverdediging en ondersteunend waterdeel — van álle waterschappen, als GeoJSON.

GET /v1/watersystemen/imwa/collecties                            // 5 collecties
GET /v1/watersystemen/imwa/waterdeel/items?rijen=100              // features (max 1000)
GET /v1/watersystemen/imwa/waterdeel/items?bbox=4.6,52.2,5.0,52.5 // Amsterdamse grachten

De bron ondersteunt geen start/paging — gebruik bbox + rijen. PDOK OGC-API

Doorzoek de KB-collecties (DBNL, ANP-nieuws, Krantenbank…) op titel/auteur/jaar — of bevraag de KB-graaf direct met SPARQL.

GET /v1/kb/zoeken?q=multatuli&rijen=25          // SRU door alle collecties
GET /v1/kb/sparql?query=SELECT…               // linked data (SELECT/ASK)

De bron spreekt standaard-SRU (query=, recordSchema=dc). jsru.kb.nl · data.bibliotheken.nl

Machine-leesbare jaarrekeningen van beursgenoteerde ondernemingen (Inline XBRL, IFRRS): per deponering de LEI, naam, boekjaar en links naar het xBRL-JSON-bestand en het originele pakket. Standaard Nederlandse zetel (AFM-scope).

GET /v1/esef/filings?rijen=25                       // NL-deponeringen (656)
GET /v1/esef/filings?q=724500EPCYPZE4M65U03        // per LEI (Vopak)
GET /v1/esef/filings?q=vopak&land=               // naam, alle lidstaten

Scope: ESEF-plicht volgt de statutaire zetel, niet de beurs (Airbus SE depositeert bij de AFM; buitenlandse fondsen aan Euronext Amsterdam elders — die vind je via /v1/toezicht/esma/zoeken?core=firds&q=isin:…). Instrumenten via ESMA FIRDS zijn al ontsloten op de esma-stroom. filings.xbrl.org/api

De digitale collecties van honderden Nederlandse musea en erfgoedinstellingen in één zoekindex: titel, maker, instelling en bronlink per object.

GET /v1/collectie-nl/zoeken?q=rembrandt&rijen=25   // 13.000+ treffers

collectienederland.nl

De mutatiestroom van het Gegevensmagazijn: alle parlementaire entiteiten — verslagen, vergaderingen, activiteiten, kamervragen — als Atom-feed met skiptoken-paging en per entry een link naar de volledige resource-XML.

GET /v1/kamer/syncfeed                              // 250 entries
GET /v1/kamer/syncfeed?categorie=verslag            // op type
GET /v1/kamer/syncfeed?skiptoken=32541              // volgende pagina

Complementair op de Kamer-ODATA-bron (entiteitsets opvragen); SyncFeed is de stroom wat wíjzigdt. opendata.tweedekamer.nl

Genealogische aktes uit Nederlandse archieven — bevolkingsregisters, burgerlijke stand, DTB — genormaliseerd: personen met geboorte­datum en -plaats, gebeurtenissen met rollen, en de archiefbron met IIIF-scans.

GET /v1/archieven/records                        // 150 aktes per pagina
GET /v1/archieven/records?van=2024-01-01         // gewijzigd sinds
GET /v1/archieven/records?token={vervolg}        // paging

Historische aktes: per definitie ouder dan de openbaarheidstermijnen uit de Archiefwet (zie avg_toelichting in elke respons). openarchieven.nl/api

Open filmmateriaal (publiek domein/CC0) via OAI-PMH: titel, maker, datum, rechten en links per record — met vervolgpaging via token.

GET /v1/openbeelden/records                       // nieuwste records
GET /v1/openbeelden/records?van=2024-01-01        // gewijzigd sinds

Eerste gebruiker van onze generieke OAI-PMH-brug (volgen straks: Rijksmuseum, opendata.archieven.nl). openbeelden.nl/feeds/oai

Voertuiggegevens uit de open Basisregistratie Voertuigen van de RDW: per kenteken (exact) of per merk (zoekresultaat).

Aanroepen

GET /v1/rdw/voertuigen?kenteken=XS005T          // per kenteken
GET /v1/rdw/voertuigen?merk=TESLA&rows=5     // per merk

Responsvelden (per voertuig)

kenteken, voertuigsoort, merk, handelsbenaming, eerste_kleur, aantal_zitplaatsen, aantal_deuren, aantal_wielen, lengte_mm, breedte_mm, massa_rijklaar_kg, catalogusprijs_eur, datum_eerste_toelating (ISO), datum_eerste_afgifte_nl, wam_verzekerd, trekker. De bron levert ~52 velden als ruwe strings; wij leveren de curate set met getallen als getallen en datums als ISO-8601.

Bron en brondocumentatie

Bron: RDW Open Data (Socrata), dataset m9d7-ebf2. Licentie CC0 1.0.
Onderliggende documentatie: opendata.rdw.nl

Het landelijke rijksmonumentenregister, met per monument o.a. adres en BAG-koppelingen (heeft_pand, heeft_verblijfsobject) — direct te combineren met de BAG-API.

Aanroepen

GET /v1/rce/monumenten?rijksmonumentnummer=518313        // per nummer
GET /v1/rce/monumenten?postcode=1012JS&straat=Dam      // per adres
GET /v1/rce/monumenten?woonplaatsnaam=Amsterdam          // per plaats

De bron levert JSON-LD met wisselende velden per treffer; wij vlakken die af naar stabiele snake_case-velden. De veldenset per monument kan daarom per treffer verschillen (null = niet geregistreerd). Bronparameters gemeenteCode en provinciecode leveren in de praktijk lege responses en worden daarom niet aangeboden.

Bron en brondocumentatie

Bron: RCE Linked Data API (Rijksmonumentenregister). Licentie CC0 1.0.
Onderliggende documentatie: cultureelerfgoed.github.io/API · monumentenregister.cultureelerfgoed.nl

Alle geldende regelgeving van Nederland uit het Bureau Wetgeving-register (wetten.overheid.nl): zoeken op naam of BWB-id, en per regeling de volledige geconsolideerde wettekst — geparseerd tot artikelen met kop en tekst.

Aanroepen

GET /v1/wet/regelingen?q=woningwet              // zoeken op naam of BWB-id
GET /v1/wet/regeling/BWBR0005181                // volledige regeling met artikelen
GET /v1/wet/regeling/BWBR0005181?artikel=2      // alleen artikel 2

De bron biedt de kale XML-output niet meer sleutelloos aan; wij parsen de gestructureerde HTML-weergave tot artikelen[] met kop en tekst. Grote regelingen tellen ~300 artikelen — het antwoord kan groot zijn; gebruik artikel= voor gerichte opvraging. De combinatie met rechtspraak loopt via de eigen dienst wet-artikel-relevantie.

Bron en brondocumentatie

Bron: wetten.overheid.nl (Wetten en regelgeving, geconsolideerd). Wetteksten zijn publiek domein.
Onderliggende documentatie: wetten.overheid.nl · voorbeeldregeling (Woningwet)

Uitspraken van álle rechterlijke colleges (Hoge Raad, Raad van State, Centrale Raad van Beroep, rechtbanken, hoven) per ECLI — met instantie, jaar, samenvatting (voor zover aanwezig) en volledige uitspraaktekst, genormaliseerd uit de officiële open data van de Rechtspraak.

Aanroepen

GET /v1/rechtspraak/uitspraak?ecli=ECLI:NL:HR:2023:100

De open-data-feed van de Rechtspraak biedt geen tekstzoeken op uitspraken (alleen datum- en instantiefilters) — vandaar dit endpoint per ECLI, en de eerlijke koppeling vanuit wet-artikel-relevantie met de officiële zoeklink per citatievorm. samenvatting is null als de bron die niet levert. Attributie bij hergebruik: Rechtspraak (data.rechtspraak.nl), CC BY 4.0.

Bron en brondocumentatie

Bron: data.rechtspraak.nl — officiële open data van de uitspraken. Licentie CC BY 4.0.
Onderliggende documentatie: data.rechtspraak.nl · rechtspraak.nl

Het stedelijke dataplatform van Gemeente Amsterdam: 122 datasets (parkeervakken, BAG, BBGA-statistiek, canon van Amsterdam, …) waarvan 106 volledig sleutelloos. Zoek in de catalogus, bekijk de tabellen + velden per dataset, en haal de rijen op als normale API — geometrie altijd in WGS84.

Aanroepen

GET /v1/amsterdam/datasets?q=parkeer                          // catalogus doorzoeken
GET /v1/amsterdam/datasets/{id}/tabellen                      // tabellen + velden
GET /v1/amsterdam/datasets/{id}/data?tabel=buurt&rijen=50     // rijen ophalen

Per dataset staat de licentie in de respons (data.licentie bij tabellen, sleutelloos en licentie per catalogus-entry); null = bij de bron niet vermeld. Rijen bevatten geometrie_wgs84 als de tabel geometrie heeft — de bron levert standaard Rijksdriehoekscoördinaten, wij vragen WGS84 op.

Bron en brondocumentatie

Bron: Dataplatform API (Gemeente Amsterdam). Attributie "Gemeente Amsterdam — Dataplatform" bij hergebruik, plus de per dataset vermelde licentie.
Onderliggende documentatie: api.data.amsterdam.nl/v1/docs · data.amsterdam.nl

Deze producten bestaan alleen bij Identix.org: wij combineren bronnen die alléén al genormaliseerd en op elkaar aansluitend zijn — wijk-/buurtcodes uit de BAG sluiten direct aan op CBS-kerncijfers, coördinaten op de kadastrale kaart, adressen op het monumentenregister. Alle broncalls gaan parallel; duur_ms is de eerlijk gemeten totaltijd. En eerlijk over fouten: valt een deelfout weg, dan staat die bron in bronnen[] met status onbeschikbaar en blijft de rest van het antwoord gewoon staan.

Adres-context — alles rond één adres

GET /v1/adres/1012JS/1/context

BAG-adresidentiteit (incl. wijk- en buurtcodes, coördinaten, kadastrale perceel-aanduidingen) + CBS-kerncijfers van de buurt én de wijk + percelen en bebouwing rond het punt + rijksmonumenten op het adres — in één call. Postcode wordt genormaliseerd (1012js werkt ook); geen exacte match → RFC 7807-404.

Pand-dossier — gebouw, perceel, monument, buurt

GET /v1/pand/1012JS/1/dossier

Het gebouwdossier — zeven bronnen in één call: BAG-pandidentificaties (uit de kadastrale kaart), kadastraal perceel met oppervlak, rijksmonumentstatus, CBS-buurtprofiel, vastgestelde WOZ-waarden (alle peiljaren) en energielabel-toegang (open datasets op postcode-/wijkniveau; het label per pand zit bij RVO achter een gratis API-key — roadmap). Direct opvragen per BAG-pand-id vereist dezelfde key; tot die tijd is het adres de sleutel en staan de pand-id's in de respons.

Regio-vergelijking — kerncijfers naast elkaar

GET /v1/regio/WK0363AE/vergelijk?met=WK0363AC
GET /v1/regio/GM0363/vergelijk?met=GM0599&jaar=2024

Twee regio's (buurt, wijk of gemeente — ook verschillende niveaus mogen door elkaar) in één respons: elk kerncijfer naast elkaar met verschil (b − a) en verschil_pct. Kenmerken die maar één kant kent staan in alleen_bekend_in_a/b.

Wet-artikel-relevantie — artikel + weg naar jurisprudentie

GET /v1/wet/BWBR0005181/artikelen/2/relevant
GET /v1/wet/BWBR0002656/artikelen/1:1/relevant

Artikel-tekst per BWB-regeling met genormaliseerde citatievormen (waaronder BW-vormen als art. 1:1 BW) en de directe vervolgstappen naar jurisprudentie: officiële zoeklink met de citatie als zoekterm, de open-data-feed, en het uitspraak-per-ECLI-endpoint. Tekstzoeken op artikelnummer biedt de open-data-feed van de Rechtspraak niet (alleen datum-/instantie-filters) — vandaar deze eerlijke koppeling in plaats van een gesloopte interne API.

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

GET /v1/punt/4.8937/52.3733/context              // standaard radius 150 m
GET /v1/punt/4.8937/52.3733/context?radius=500

De adres-context, maar op coördinaat: reverse geocoding naar het dichtstbijzijnde adres en vandaaruit de volledige context (CBS van buurt én wijk, percelen, bebouwing, monumenten). Zonder adres binnen de radius: alléén de kadastrale lagen, met toelichting — nooit een halve fout.

Regio-ranglijst — top-N binnen een gebied

GET /v1/regio/GM0363/top?kenmerk=gemiddelde_woz_waarde     // duurste wijken Amsterdam
GET /v1/regio/GM0599/top?kenmerk=inwoners&richting=laagste  // kleinste buurten Rotterdam

Alle wijken of buurten van een gemeente (of buurten van een wijk) op één kerncijfer gerangschikt. Eén bulkcall bij CBS — geen N profielrequests, dus ook grote steden zijn snel. Kenmerken: de velden uit cbs_kerncijfers (inwoners, huishoudens, woningvoorraad, gemiddelde_woz_waarde, inkomen, leeftijdsopbouw).

Uitspraak-artikelen — wetgeving in één uitspraak

GET /v1/rechtspraak/ECLI:NL:RBNHO:2026:8258/relevante-artikelen

De omgekeerde kant van wet-artikel-relevantie: wij lezen de uitspraaktekst en extraheren de wetsartikel-verwijzingen (BW-citaties zoals 6:96 BW én bekende wetten), met per citatie het BWB-id en een direct artikel_endpoint naar de wettekst. Onbekende regelingen krijgen bwb_id: null met toelichting — geen verzonnen koppelingen.

Adres-luchtkwaliteit — dichtstbijzijnde meetpunt

GET /v1/adres/1012JS/1/lucht            // 3 dichtstbijzijnde stations
GET /v1/adres/1012JS/1/lucht?n=5

Adres → coördinaat → de dichtstbijzijnde Luchtmeetnet-stations (hemelsbrede afstand) met per station de nieuwste meting per stof (PM10, NO₂, O₃, …). De stationcoördinaten komen uit het detail-endpoint (de lijst-endpoint geeft ze niet) en zijn 24 uur gecached — de eerste aanroep per dag is daardoor even trager, alle volgende direct.

Pand-WOZ — vastgestelde WOZ-waarden per object

GET /v1/pand/1015CC/1/woz                  // alle objecten op nr. 1
GET /v1/pand/1015CC/1/woz?letter=H        // specifieke huisletter

De vastgestelde WOZ-waarden van de WOZ-objecten op een adres, over alle beschikbare peiljaren — uit het publieke WOZ-waardeloket (Waarderingskamer/Kadaster): bijv. € 1.081.000 op peildatum 2025-01-01, € 931.000 op 2024. Een huisnummer kan meerdere objecten hebben (toevoegingen); alle treffers worden gegeven, filter met letter/toevoeging.

Adres-subsidies — verduurzamingssubsidies per adres

GET /v1/adres/1012JS/1/subsidies

Actuele ISDE-bedragen per maatregel (RVO): warmtepomp (minimaal € 500 + variabel per type), isolatie per m² (met laag/hoog-tarief per woningtype), zonneboiler (€ 300–1.750), elektrisch koken (€ 400) en warmtenet-aansluiting (€ 3.775) — rond één adres, met de officiële vervolgstappen (RVO-rekentool, Warmtefonds, energiebespaarlening). De bedragen gelden landelijk en wijzigen periodiek: opgevraagd_op en bron_url per rubriek staan altijd in de respons (24-uurs cache).

Regio-woningmarkt — verkoopprijzen over jaren

GET /v1/regio/GM0363/woningmarkt            // 10 jaar
GET /v1/regio/WK0363AE/woningmarkt?jaren=5  // wijk → gemeente

Gemiddelde verkoopprijzen van bestaande koopwoningen per gemeente (CBS, reeks vanaf 1995) met jaar-op-jaar-delta's, plus woningvoorraad/WOZ-context uit de kerncijfers. Wijk- en buurtcodes mappen wij op de bovenliggende gemeente — CBS publiceert verkoopprijzen uitsluitend op gemeente-niveau; dat staat eerlijk in de respons.

Waarde-indicatie — open kengetallen per adres

GET /v1/pand/1012JS/1/waarde-indicatie

Open kengetallen rond één adres: buurt- en wijk-WOZ, woningvoorraad en de gemeentelijke verkoopprijs-reeks. Expliciet géén taxatie of AVM — objecttransactieprijzen zijn een betaald bestand; dit is de eerlijke ondergrens uit open statistiek (vaste geen_taxatie-toelichting in elke respons).

Regio-trend — kerncijfers over jaren

GET /v1/regio/WK0363AE/trend

CBS-kerncijfers van één regio over jaartabellen heen (2025/2024/2023): per kenmerk een reeks {jaar, waarde} met delta t.o.v. het jaar ervoor — de ontwikkeling van een buurt, wijk of gemeente in één call. Jaren zonder data ontbreken eerlijk: de adapter valt bij een ontbrekend jaar terug op een ander jaartabel, en deze dienst detecteert dat en laat het jaar weg i.p.v. het te dupliceren. Elk nieuw CBS-jaartabel groeit automatisch mee.

Punt-reistijden — actuele reistijden bij een punt

GET /v1/punt/4.8937/52.3733/reistijden          // 10 km, top-10

De dichtstbijzijnde verkeersmeetpunten (van 100.000+ in Nederland) met hun actuele reistijd per wegvak én gemiddelde snelheid bij lusmeetpunten (20.000+, vooral snelwegen) — Dam-centrum: "Amstel-Damrak → Dam" momenteel ~19 s. Meetpunten zijn 24-uurs gecached, waarden 10-min; cache-warm antwoordt dit in ~1 s, de eerste call na verval kan tientallen seconden duren (grote DATEX-feeds) — duur_ms rapporteert dit eerlijk. Op de box verversen we deze caches daarom automatisch vóór verloop (diensten-warmer), zodat responses vrijwel altijd warm zijn.

Punt-brugopeningen — brugopeningen + SRTI bij een punt

GET /v1/punt/4.8937/52.3733/brugopeningen      // 15 km, top-10

Geplande brugopeningen (RIS-locaties; openen in vensters van enkele minuten — zie geldig_van/tot) en actuele veiligheidsberichten (SRTI) rond een punt. Beide feeds leveren zelf coördinaten; null-velden = niet geregistreerd bij de bron.

Punt-gebieden — bestuurlijke gebieden op een punt

GET /v1/punt/4.8937/52.3733/gebieden

Gemeente, provincie en land op één coördinaat, met officiële codes (GM0363, PV27) en liggt-in-relaties — uit de actuele bestuurlijke grenzen van PDOK (mini-bbox-lookup, geometrie via de bron-API). De respons lonkt meteen door: vervolg geeft de CBS-regio-diensten van dezelfde gemeente (kerncijfers, ranglijst, trend).

Punt-verkeer — tijdelijke maatregelen bij een punt

GET /v1/punt/4.8937/52.3733/verkeer           // 10 km, top-10
GET /v1/punt/4.8937/52.3733/verkeer?radius=3000

Actuele afsluitingen en tijdelijke maximumsnelheden (NDW DATEX II, 10-min cache): per maatregel het geldigheidsvenster, de oorzaak (meestal wegwerkzaamheden), rijstroken en de limiet. De afstand is hemelsbreed tot het dichtstbijzijnde punt van de weglijn (gmlLineString) — maatregelen volgen immers wegvakken, geen punten.

Punt-BGT — grootschalige topografie op een punt

GET /v1/punt/4.8937/52.3733/bgt          // 50 m, top-5 per collectie
GET /v1/punt/4.8937/52.3733/bgt?radius=200

De BGT-lens op een coördinaat: acht collecties parallel — gebouwen (met BAG-pand-koppeling), wegdelen, waterdelen, vegetatie, functionele gebieden, straatnaamlabels, straatmeubilair en overbruggingsdelen. Kenmerken zonder geometrie (die via de BGT-bron-API's op te vragen zijn); null bij totaal = bron geeft geen numberMatched.

Punt-milieuzone — in-emissiezone-check

GET /v1/punt/4.8937/52.3733/milieuzone        // Dam: in 3 Amsterdamse zones
GET /v1/punt/5.10/52.10/milieuzone             // polder: dichtstbij Utrecht

Punt-in-polygoon over álle nationale emissiezones (NDW, DATEX II): per treffer de zone-naam, gemeente, euro-norm-voorwaarden en de officiële regeling-verwijzing; buiten alle zones de dichtstbijzijnde met hemelsbrede afstand. Voor logistiek, voertuigplanning en adreschecks. De zonevlakken zijn 24 uur gecached.

Punt-voorzieningen — alles in de buurt

GET /v1/punt/4.8937/52.3733/voorzieningen          // 750 m, top-5
GET /v1/punt/4.8937/52.3733/voorzieningen?radius=2000&n=10

De voorzieningen-lens op een coördinaat: laadpalen met realtime beschikbaarheid (NDW — alle 79.000+ laadpunten van Nederland, lokaal gefilterd), deelfiets-stations over álle GBFS-systemen, truckparkingen met realtime bezetting (binnen 10 km) en het actuele weer. De gebouwde-/regio-lens op hetzelfde punt staat in /v1/punt/{lon}/{lat}/context. Let op: de deelfiets-feeds zijn realtime (korte cache) — de eerste call na cache-verval vraagt alle systemen parallel op en kan enkele seconden duren; duur_ms rapporteert dit eerlijk.

Enterprise en MCP

Deze diensten leven in dezelfde enterprise-laag: waar/ velden-filters werken op lijstvelden zoals panden en kerncijfers, plus ETag/304 en gzip. Als MCP-tool: adres_context, pand_dossier, regio_vergelijk, wet_artikel_relevant, punt_context, regio_ranglijst, uitspraak_artikelen, adres_lucht en punt_voorzieningen (zie MCP-sectie).

De werklijst — wat er nog komt

Nieuwe eigen diensten staan op de machinale werklijst: GET /v1/diensten/backlog (filter: ?status=direct-bouwbaar). De status van elk idee wordt automatisch afgeleid — zodra alle benodigde bronnen live zijn (of een API-key valt), klapt een kandidaat vanzelf door naar direct-bouwbaar.

Actueel weer en dagvoorspelling per coördinaat — modeldata van nationale weerdiensten (o.a. KNMI-HARMONIE, DWD ICON, ECMWF), ontsloten door Open-Meteo. Weathercodes zijn naar het Nederlands vertaald; tijden in Europe/Amsterdam.

Aanroepen

GET /v1/weer/nu?lon=4.8930&lat=52.3730                    // actueel weer
GET /v1/weer/voorspelling?lon=4.8930&lat=52.3730&dagen=7   // dagvoorspelling

Responsvelden: temperatuur_c, luchtvochtigheid_pct, wind_km_u, windrichting_graden, neerslag_mm, weer_code (WMO) + weer_omschrijving (Nederlands), en per dag temp_max_c/temp_min_c, neerslagkans_pct, zonsopgang/zonsondergang.

Bron en brondocumentatie

Bron: Open-Meteo Forecast API (CC BY 4.0). Attributie verplicht: Weather data by Open-Meteo.com — staat automatisch in bronnen[].
Onderliggende documentatie: open-meteo.com/en/docs

Realtime deelfiets-data van álle Nederlandse GBFS-systemen (56 registraties: Donkey Republic, Check, enzovoort) — één adapter voor het hele land. Stations krijgen informatie én status gemerged; free-floating systemen leveren losse voertuigen.

Aanroepen

GET /v1/deelfiets/systemen                          // alle NL-systemen
GET /v1/deelfiets/{systeem}/stations                // stations + beschikbaarheid
GET /v1/deelfiets/{systeem}/voertuigen              // free-floating fietsen

Per station: naam, lat/lon, capaciteit, fietsen_beschikbaar, fietsen_per_type, kopers_beschikbaar, verhuurt, laatste_melding (ISO-8601 Z). Updatefrequentie van de bron ≈ 60 s; onze cache volgt die TTL.

Bron en brondocumentatie

Bron: GBFS-feeds van de aanbieders, systeemlijst via het MobilityData-register (CC0).
Onderliggende documentatie: gbfs.org · MobilityData/gbfs

Het complete gegevensmagazijn van de Tweede Kamer als normale, bevraagbare API: 38 entiteiten — zaken (wetsvoorstellen, moties), documenten, kamerstukdossiers, activiteiten, agendapunten, vergaderingen, besluiten, stemmingen, personen, fracties, commissies, toezeggingen. Velden genormaliseerd naar snake_case.

Aanroepen

GET /v1/kamer/entiteiten                                    // alle 38 entiteiten
GET /v1/kamer/Zaak?velden=Nummer,Onderwerp&rijen=25      // zaken
GET /v1/kamer/Stemming?sorteer=-Aangifte&rijen=100       // stemmingen

De entiteitsets heten enkelvoudig en attribuutnamen zijn recent bij de bron gewijzigd — /v1/kamer/entiteiten is de waarheid. Voor verdere filtering (waar=) geldt de enterprise-laag van het platform op élke lijstrespons.

Bron en brondocumentatie

Bron: Gegevensmagazijn Tweede Kamer (OData v4, CC0). Let op: de Eerste Kamer heeft geen eigen API — die loopt via officiële bekendmakingen (KOOP).
Onderliggende documentatie: opendata.tweedekamer.nl

Zoeken in de museumcollectie op facetten en elk object als Linked Art JSON-LD. Let op: de oude Rijksmuseum-API (usersets e.d.) is per 2026-01-05 uitgeschakeld — dit is de huidige, officiële data.route.

Aanroepen

GET /v1/rijksmuseum/collectie?type=painting&maker=Rembrandt   // zoeken op facetten
GET /v1/rijksmuseum/object/SK-A-4691                        // object als Linked Art

De zoekrespons levert objectnummers + LOD-URI's (zoals de bron); totaal_in_bron en cursor-paginatie zijn meegenomen. Het object zelf is de ongewijzigde Linked Art-record (producer, techniek, identificatie, afbeeldingsverwijzingen).

Bron en brondocumentatie

Bron: Rijksmuseum Data Services (collectie-metadata CC0).
Onderliggende documentatie: data.rijksmuseum.nl/docs/search

Landelijke meldkamerdata uit het GMS: incidenten, reactietijden, nieuwjaarsincidenten, kazernes, personeel en materieel — het legitieme, open alternatief voor P2000 (dat geen open data is). Deze endpoint ontsluit de officiële documentenfeed; CSV-ontsluiting volgt via de dataset-laag.

Aanroepen

GET /v1/veiligheid/kerncijfers          // documentencatalogus (live feed)

Per document: titel, soort, gewijzigd (ISO-8601), url (indien de bron die levert, anders null).

Bron en brondocumentatie

Bron: NIPV Kerncijfers Veiligheidsregio's (CC0). Contact: opendata@nipv.nl.
Onderliggend portaal: kerncijfers.nipv.nl

2,5+ miljoen radio-, tv- en filmitems op schema.org-model. Zoek op titel, of stel zelf een SPARQL-vraag (alleen SELECT/ASK — de bron weigert zware scans met 503, blijf dus selectief).

Aanroepen

GET /v1/beeldengeluid/zoeken?q=troonrede&rijen=25     // zoeken op titel
GET /v1/beeldengeluid/sparql?query=SELECT …           // eigen SPARQL (SELECT/ASK)

Zoekresultaat per item: item (URI), naam, types (gededupliceerd, korte namen). De SPARQL-passthrough levert variabelen + platte rijen.

Bron en brondocumentatie

Bron: NISV Mediacatalogus SPARQL (CC0).
Onderliggend endpoint: cat.apis.beeldengeluid.nl/sparql

De gedetailleerde basiskaart van Nederland als 49 bevraagbare feature-collecties: gebouwen, wegen, water, spoor, terreinen, bakken, borden, kasten, kunstwerken… Geometrie in WGS84. Eerste bron op de OGC-API-brug — andere PDOK-diensten volgen.

Aanroepen

GET /v1/pdok/bgt/collecties                            // alle 49 collecties
GET /v1/pdok/bgt/bord/items?rijen=50                    // features
GET /v1/pdok/bgt/bak/items?bbox=4.88,52.35,4.92,52.39   // binnen een vlak

Deze PDOK-dienst ondersteunt géén paging (start) — verklein met bbox (minlon,minlat,maxlon,maxlat) en verhoog rijen (max 1000). Veldnamen per collectie volgen de bron (bronhouder, lokaal_id, …).

Bron en brondocumentatie

Bron: BGT via PDOK OGC API Features (CC BY 4.0).
Onderliggende dienst: api.pdok.nl/lv/bgt/ogc/v1

Álle laadpunten van Nederland (79.000+) met realtime beschikbaarheid per connector — plus de bestandencatalogus van het NDW-portaal (DATEX II-verkeersfeeds, verkeersborden, emissiezones, truckparking).

Aanroepen

GET /v1/mobiliteit/laadpalen?operator=Qwello                // per operator
GET /v1/mobiliteit/laadpalen?alleen_beschikbaar=true        // alleen vrije palen
GET /v1/mobiliteit/ndw/bestanden                             // feed-catalogus

Per laadpunt: lat/lon, adres, operator, openbaar, beschikbaar/totaal (gesommeerd over connectoren), connectoren, laatst_bijgewerkt. De feed verschijnt vrijwel uurlijks; onze cache volgt met 10 minuten.

Bron en brondocumentatie

Bron: NDW Open Data (laadpalenfeed als GeoJSON-gzip).
Onderliggend portaal: opendata.ndw.nu · docs.ndw.nu

821 StatLine-tabellen die CBS namens ándere bronhouders publiceert: geregistreerde misdrijven en aangiften (Politie), volksgezondheid en vaccinatiegraad (RIVM), gemeentefinanciën (Iv3). Eén endpoint, drie bronhouders — de verantwoording vermeldt per tabel de echte instantie.

Aanroepen

GET /v1/statistiek/dataderden/tabellen?q=misdrij     // tabellen zoeken
GET /v1/statistiek/dataderden/47013NED?rijen=25      // rijen uit één tabel

Rijen genormaliseerd: snake_case (geregistreerde_misdrijven_1), spaties achter waarden weg ("NL01 " → "NL01"), getallen als getallen. Parameters rijen/start/velden/sorteer mappen op OData ($top/$skip/$select/$orderby).

Bron en brondocumentatie

Bron: CBS StatLine voor derden (OData v3). Bronhouder per tabel vermeld.
Onderliggende dienst: dataderden.cbs.nl

Het landelijke datasetregister voor erfgoed (DCAT-AP-NL 3.0 — hetzelfde profiel dat Identix.org hanteert): datasets van musea, archieven en bibliotheken. Zoek op titel of stel een eigen SPARQL-vraag (SELECT/ASK).

Aanroepen

GET /v1/erfgoed/datasetregister/zoeken?q=beeld      // datasets op titel
GET /v1/erfgoed/datasetregister/sparql?query=…     // eigen SPARQL (SELECT/ASK)

Bron en brondocumentatie

Bron: NDE Datasetregister (draait op QLever).
Onderliggend endpoint: datasetregister.netwerkdigitaalerfgoed.nl

Alle officiële publicaties van overheden — Staatsblad, Staatscourant, kamerstukken, gemeente- en provinciebladen, Tractatenblad, tuchtrecht en Woo-besluiten (7,2 mln documenten). Doorzoekbaar op 192 velden; q is een vrije term of ruwe CQL. Eerste bron op de SRU-brug.

Aanroepen

GET /v1/bekendmakingen/zoeken?q=woningwet                          // alles
GET /v1/bekendmakingen/zoeken?q=woningwet&productgebied=sgd        // Staten-Generaal
GET /v1/bekendmakingen/zoeken?q=(dossiernummer=32847)&rijen=50     // ruime CQL
GET /v1/bekendmakingen/indexen                                     // alle 192 velden

Productgebieden: officielepublicaties, sgd, tuchtrecht, vd (verdragen), plooi (Woo), samenwerkendecatalogi. Per record under andere: identifier, title, creator, date, preferredUrl, dossiernummer, vergaderjaar. Paginering is 1-based (start, conform SRU) met volgende_start in de respons.

Bron en brondocumentatie

Bron: KOOP SRU-dienst (art. 11 Auteurswet: wetten en besluiten zijn auteursrechtvrij).
Onderliggende dienst: repository.overheid.nl/sru · menselijke view: zoek.officielebekendmakingen.nl

De actuele bestuurlijke grenzen van Nederland als drie collecties: gemeentegebied (342 gemeenten, codes zoals GM0263), provinciegebied en landgebied. Geometrie in WGS84.

Aanroepen

GET /v1/pdok/bestuurlijkegebieden/collecties                       // 3 collecties
GET /v1/pdok/bestuurlijkegebieden/gemeentegebied/items?rijen=342    // álle gemeenten

Deze dienst ondersteunt geen paging (start) — verklein met bbox. Per feature: code, identificatie (GM/PR-code), naam en geometrie.

Bron en brondocumentatie

Bron: Bestuurlijke gebieden via PDOK OGC API Features.
Onderliggende dienst: api.pdok.nl/kadaster/bestuurlijkegebieden

De catalogus van het moderne CBS Open Data-platform (±5.900 tabellen): titel, beschrijving, status, versie, observatie-aantal en wijzigingsdata — server-side doorzoekbaar. De v4-datatoegang zelf (Observations-model) is vervolgstap; tabeldata loopt tot die tijd via CBS v3.

Aanroepen

GET /v1/cbs/v4/tabellen?q=energie                    // zoeken
GET /v1/cbs/v4/tabellen?sorteer=-Modified&rijen=25   // recent gewijzigd

Datatoegang per tabel

GET /v1/cbs/v4/00370/data?rijen=25                   // observaties (zip-distributie)
GET /v1/cbs/v4/00370/data?velden=id,value&rijen=10    // kolomselectie

De v4-distributie is een ZIP met Observations.csv (scheidingsteken ;); wij pakken die uit en leveren rijen met kolommen, totaal_in_bron en paginering (rijen/start). Tabellen > 25 MiB vallen terug op de dataset-laag. Codes (measure/dimensies) verwijzen naar de *Codes-sets uit dezelfde distributie.

Bron en brondocumentatie

Bron: CBS Open Data v4 (OData).
Onderliggende dienst: datasets.cbs.nl/odata/v1

De onderwijsdatacatalogus van de Dienst Uitvoering Onderwijs: examenresultaten, school- en bestuursadressen, leerlingaantallen, indicatoren. Per dataset de resources (CSV/Excel per jaar) — inhoudelijke ontsluiting loopt via de universele dataset-laag.

Aanroepen

GET /v1/onderwijs/datasets?q=examens              // catalogus doorzoeken
GET /v1/onderwijs/dataset/04_voex-v1             // één dataset + resources

Per dataset: id, titel, beschrijving, organisatie, licentie, gewijzigd en resources[] (naam, formaat, url, wijzigingsdatum).

Bron en brondocumentatie

Bron: DUO Open Onderwijsdata (CKAN, sleutelloos).
Onderliggend portaal: onderwijsdata.duo.nl

Gelijktijdig zoeken in 56 erfgoedthesauri en termenlijsten — Adamlink, Archeologisch Basisregister, Getty AAT, RKD, Wikidata… — op één zoekterm. Eerste bron op de GraphQL-brug; per resultaat de term, uri en herkomstbron.

Aanroepen

GET /v1/erfgoed/termen/zoeken?q=rembrandt     // alle 56 bronnen
GET /v1/erfgoed/termen/bronnen                // de thesauri-lijst

Per resultaat: term (voorkeurslabel), alternatief, uri, bron + bron_uri. Zoeken over het hele netwerk kan enkele seconden duren (de bronnen werken met eigen timeouts); resultaten staan 6 uur in de cache.

Bron en brondocumentatie

Bron: NDE Termennetwerk (GraphQL-API). Licentie per thesaurus.
Onderliggend endpoint: termennetwerk-api.netwerkdigitaalerfgoed.nl

SPARQL-passthrough op de kennisbank Wikidata (CC0): honderdduizenden Nederlandse entiteiten — gemeenten, monumenten, personen, organisaties — met relaties. Alleen SELECT/ASK; resultaten worden gecached (ToS).

Aanroepen

GET /v1/wikidata/sparql?query=SELECT … WHERE { … }    // eigen SPARQL (SELECT/ASK)

Bron en brondocumentatie

Bron: Wikidata Query Service (CC0). Houd vragen selectief — de bron weigert zware queries.
Onderliggend endpoint: query.wikidata.org

De open index van wetenschappelijke werken, auteurs en instellingen (incl. alle NL-universiteiten). Zoeken op vrij tekst met per werk: titel, jaar, DOI, open-access-link, eerste auteur, bron en citaties.

Aanroepen

GET /v1/wetenschap/openalex/zoeken?q=wadden&rijen=25    // zoeken

Bron en brondocumentatie

Bron: OpenAlex (CC0).
Onderliggende documentatie: docs.openalex.org

Actuele en historische wisselkoersen op basis van de ECB-referentiekoersen.

GET /v1/financieel/koersen?naar=USD,GBP                             // actueel
GET /v1/financieel/koersen?periode_van=2026-01-01&periode_tot=2026-01-31 // periode

Bron: frankfurter.dev — attributie automatisch in bronnen[].

Wetenschappelijke publicaties via DOI-metadata: titel, auteur, jaar, uitgever, tijdschrift.

GET /v1/wetenschap/crossref/zoeken?q=wadden     // zoeken

Bron: crossref.org.

Open muziekencyclopedie (CC0-kerndata) met Nederlandse catalogi. Zoek artiesten op naam of veld (artist:André Hazes); ToS-volledig: 1 req/s, gecached.

GET /v1/cultuur/muziek/artiesten?q=artist:André%20Hazes     // artiesten

Bron: musicbrainz.org.

Het wereldwijde LEI-register: 195.000+ Nederlandse rechtspersonen. De spil-identifier die KVK (RA000463), ESMA en TED koppelt — kvk_nummer waar geregistreerd.

GET /v1/bedrijven/lei/zoeken?q=JEVELUNI%20B.V.     // exacte naam (geen fuzzy)
GET /v1/bedrijven/lei/724500P3WJ4N9ULP9V05       // lookup op LEI

Bron: api.gleif.org (CC0).

Europese aanbestedingsaankondigingen (vrij herbruikbaar incl. commercieel). q is een vrije term (wordt FT=) of expert-query (PD>=20260101); standaard alleen NL-kop (buyer-country=NLD).

GET /v1/aanbestedingen/zoeken?q=spoorwegen     // NL-aanbestedingen

Bron: TED Search API v3.

Financieel-toezichtsregisters van de ESMA (100.000+ entiteiten): MiFID/UCITS/AIFMD, prospectussen, short selling, sancties. Bevat LEI's → koppelbaar via GLEIF. Cores: upreg, firds, sanctions en meer.

GET /v1/toezicht/esma/zoeken?q=ing&core=upreg     // entiteiten zoeken

Bron: registers.esma.europa.eu.

Statistische reeksen van de ECB: wisselkoersen (EXR), rentestanden (MIR, incl. Nederlandse hypotheekrente), inflatie (ICP), bankbalansen (BSI). Generieke toegang: dataflow + dotted key; levering als CSV (csvdata) die wij normaliseren.

GET /v1/statistiek/ecb/EXR/D.USD.EUR.SP00.A?van=2026-08-01     // USD/EUR-dagkoers
GET /v1/statistiek/ecb/MIR/B.L21.AM.R.A.2240LE.N.A       // hypotheekrente NL

Bron: ECB Data Portal.

Europese statistiek met Nederlandse slice (standaard geo=NL): HICP-inflatie, bevolking, economie. JSON-stat wordt afgevlakt naar rijen mét dimensielabels (coicop, periode).

GET /v1/statistiek/eurostat/prc_hicp_aind?laatste=1     // HICP NL

Bron: Eurostat API.

BAG-panden verrijkt met LOD12/22/23-3D-geometrie. Collectie pand; item-id's zijn NL.IMBAG.Pand.{id}. Geen paging — verklein met bbox.

GET /v1/pdok/3dbag/pand/items?bbox=4.88,52.35,4.92,52.39     // 3D-panden

Bron: api.3dbag.nl.

De EU-vocabulaires: EuroVoc-thesaurus (meertalig incl. Nederlands) en de Named Authority Lists. De NAL data-theme bevat exact de DCAT-AP-thema's die data.overheid.nl gebruikt — gratis interoperabiliteit met de NL-keten.

GET /v1/euvoc/sparql?query=SELECT …     // eigen SPARQL (SELECT/ASK)

Bron: EU Vocabularies.

Content over regelingen: subsidies, artikelen, blogs, events, subjects. Let op: géén subsidie-ontvangers (die lopen via projects.rvo.nl/IATI).

GET /v1/regelingen/rvo/subsidies?rijen=25     // subsidieregelingen

Bron: RVO open-data API.

De meta-bron: de landelijke catalogus met 20.300+ open datasets van honderden Nederlandse instanties. Vind per onderwerp welke data bestaat, bij wie, onder welke licentie — en of er een API-koppeling is.

Aanroepen

GET /v1/catalogus/datasets?q={zoekterm}&instantie=&rows=&start=   // zoeken
GET /v1/catalogus/datasets/{id}                                        // detail per slug/uuid
GET /v1/catalogus/instanties                                           // publicerende instanties
GET /v1/datasets/{id}/data?resource=0&rijen=50                      // ruwe weergave (universeel)
GET /v1/datasets/{id}/query?waar=kolom=waarde&velden=a,b&sorteer=k // QUERY-BARE API (normale calls)

Responsvelden (per dataset)

Bron en brondocumentatie

Bron: data.overheid.nl (Koop Overheid), CKAN API v3. Licentie CC0.
Onderliggende documentatie: data.overheid.nl · API · CKAN API-documentatie

Het Wft-register financiële dienstverleners van de AFM: 23.000+ instanties met vergunningen, vergunde producten en diensten (adviseren, bemiddelen), inkomende Europese paspoorting, adressen en beleidsbepalers. De AFM biedt géén open API — Identix.org importeert het officiële publieke XML-extract (dagelijks ververst, geen login) en ontsluit het als curated API. Dit is het eerste endpoint met bron_type: "collectiebron": een brongecontroleerde kopie met peildatum — in élke respons peildatum, bron_url (naar het officiële extract) en de vereiste bronvermelding van de AFM.

Aanroepen

GET /v1/afm/register                                        // metadata, peildatum, hergebruiksvoorwaarden
GET /v1/afm/instellingen?q=elevate&kvk_nummer=94805172   // zoeken + filters
GET /v1/afm/instellingen/{id}                               // volledig dossier per instelling
GET /v1/afm/vergunningen?status=geldig&rijen=25          // vlakke vergunningenlijst

Responsvelden (per instelling)

Bron, hergebruik en brondocumentatie

Bron: AFM — Register financiële dienstverleners (officieel XML-extract, publiek zonder login; dagelijks ververst door Identix.org met peildatum en sha-256 in het manifest).
Hergebruik (sitevoorwaarden afm.nl): "Uitsluitend met uitdrukkelijke bronvermelding van de AFM is het toegestaan de informatie op deze website geheel of gedeeltelijk op enigerlei wijze over te nemen en/of te verspreiden." — de attributie wordt in elke respons meegestuurd.
Officiële registerpagina: afm.nl · register financiële dienstverleners · officieel extract (XML)

Het Openbaar register van DNB: 3.300+ financiële instellingen (banken, verzekeraars, pensioenfondsen, betaalinstellingen, trustkantoren, …) met 46.000+ registraties over 15 deelregisters — vergunningen, ontheffingen en goedkeuringen met wetsartikel, geldigheidsdatums en relaties. Per instelling KvK, RSIN en LEI. DNB biedt geen sleutelloze API — Identix.org importeert de officiële complete CSV-export (elke werkdag 06:00 ververst) en ontsluit die als curated API (bron_type: "collectiebron"): peildatum, bron-URL en CC-BY-attributie in élke respons.

Aanroepen

GET /v1/dnb/register                                          // metadata, peildatum, hergebruiksvoorwaarden
GET /v1/dnb/instellingen?q=ing%20bank&kvk_nummer=73712590  // zoeken + filters
GET /v1/dnb/instellingen/{relatienummer}                     // dossier met alle registraties
GET /v1/dnb/registraties?deelregister=Pensioenfondsen        // vlakke registratielijst

Bron, hergebruik en brondocumentatie

Bron: DNB — Openbaar register (officiële complete CSV-export, publiek zonder login; DNB ververst elke werkdag om 06:00, Identix.org herimporteert dagelijks met peildatum en sha-256 in het manifest).
Hergebruik (DNB-disclaimer): CC BY 4.0 — vermeld dat de data van DNB afkomstig zijn, de licentie, en of de data bewerkt zijn. De attributie in elke respons neemt alle drie de verplichtingen mee; de normalisatie staat daarin vermeld.
Officiële registerpagina: dnb.nl · openbaar register · officiële export (CSV) · DNB-disclaimer (licentie)

Het ANBI-register van de Belastingdienst: 54.000+ algemeen nut beogende instellingen (goede doelen) met naam, alias, vestigingsplaats, website, geldigheidsdatums en cultuur-ANBI-status. Het RSIN per instelling is de koppelsleutel naar het handelsregister en de andere collectiebronnen (DNB-register: KvK↔RSIN↔LEI per instelling). Officiële open-data-export (CC0, zip met XML, wekelijks elke dinsdag ververst door de Belastingdienst) — Identix.org importeert en ontsluit die dagelijks als curated API (bron_type: "collectiebron") met de peildatum úit het bestand zelf.

Aanroepen

GET /v1/anbi/register                                     // metadata, peildatum (uit het bestand), hergebruik
GET /v1/anbi/instellingen?q=rozenkruis&plaats=Haarlem  // zoeken + filters
GET /v1/anbi/instellingen/{rsin}                          // volledige beschikking

Bron, hergebruik en brondocumentatie

Bron: Belastingdienst — ANBI-register (officiële open-data-export, publiek zonder login; peildatum en versienummer staan in het bestand zelf, wekelijks elke dinsdag ververst, Identix.org herimporteert dagelijks met sha-256 in het manifest).
Hergebruik: CC0 1.0 — vrij hergebruik en doorlevering zonder voorwaarden (vermeld in de landelijke catalogus en bij de download); attributie wordt niettemin in elke respons meegestuurd.
Officieel: belastingdienst.nl · open data ANBI · data.overheid.nl · ANBI (CC0) · officiële export (zip)

De Nederlandse slice van de GLEIF LEI Golden Copy: 195.000+ entiteiten met LEI, naam, plaats, status en — de kern — het KvK-nummer (registratie-autoriteit KvK, RA000463). Dit is dé LEI↔KvK↔naam-brug: koppel een KvK-nummer aan zijn LEI('s) en vice versa, en daarmee aan ESMA, TED en de andere collectiebronnen (DNB-register, AFM-register, ANBI). Identix.org importeert de officiële bulk-export (~500 MB wereldbestand, streamend gefilterd op NL) elke ochtend; peildatum komt uit de publicatie-bestandsnaam van GLEIF (bron_type: "collectiebron").

Aanroepen

GET /v1/gleif/register                                  // metadata, peildatum, hergebruik
GET /v1/gleif/entiteiten?q=snap-on&kvk_nummer=34153487 // zoeken + filters
GET /v1/gleif/entiteiten/{lei}                          // volledig LEI-record
GET /v1/gleif/kvk/34153487                              // de brug: alle LEI's bij één KvK

Bron, hergebruik en brondocumentatie

Bron: GLEIF — LEI Golden Copy (officiële bulk-export, publiek zonder login; GLEIF publiceert 3x per dag; wij verversen elke ochtend na 06:00 UTC, peildatum en sha-256 in het manifest).
Hergebruik: CC0 1.0 volgens de GLEIF LEI Data Terms of Use — vrij hergebruik en doorlevering; attributie wordt niettemin meegestuurd.
Officieel: gleif.org · Golden Copy · LEI Data Terms of Use (CC0) · officiële export (zip)

Alle API's zijn direct als tools beschikbaar via het Model Context Protocol. Elke MCP-client (Claude Desktop, Cursor, uw eigen chatbot) kan ze zo aanspreken — de tools dragen Nederlandse beschrijvingen en JSON-Schema's waarmee een LLM zelfstandig de juiste tool kiest en parameters invult.

Transport 1 — streamable HTTP (aanbevolen)

POST /mcp        Content-Type: application/json   (JSON-RPC 2.0)

{ "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2025-06-18" } }

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "cbs_kerncijfers", "arguments": { "regio": "WK0363AE" } } }

Clientconfiguratie (bijv. Claude Desktop / Cursor / eigen agent):

{
  "mcpServers": {
    "nederland-cloud": {
      "url": "https://Identix.org/mcp"
    }
  }
}

Transport 2 — stdio (lokaal)

{
  "mcpServers": {
    "nederland-cloud": {
      "command": "python3",
      "args": ["/pad/naar/mcp_server.py"]
    }
  }
}

Beschikbare tools

Toolantwoorden bevatten dezelfde genormaliseerde JSON als de HTTP-API's, inclusief de bronnen[]-herkomst. Fouten (bijv. ontbrekende parameter) keren terug als isError: true met een leesbare melding — zodat een LLM zichzelf kan corrigeren.

llms.txt

Voor LLM's zonder MCP: GET /llms.txt serveert een compact markdown-overzicht van alle endpoints, parameters en het responsformaat — direct in te laden als context. De OpenAPI-specificatie is eveneens beschikbaar voor frameworks die tools uit een specificatie genereren.

Een chat-dienst over het eigen aanbod, in drie modi: Data (vraag → live cijfers), Documentatie (register-gestuurd antwoord over het aanbod — gratis, zónder LLM) en Onderzoek (meerstaps: meerdere calls, vergelijkingen, tussenstappen). De interface staat op /assistent.

POST /v1/assistent/vraag    Content-Type: application/json

{ "vraag": "Hoeveel woningen telt Amsterdam?", "modus": "data" }
GET /v1/assistent/status   // modi, modellen, limieten, datamodus-activatie

De respons is de gewone envelop (bron_type "eigen-dienst", onderdeel "assistent.vraag"). Het data-blok bevat: antwoord, aanroepen[] (de exacte uitgevoerde MCP-calls, herhaalbaar via POST /mcp), bronnen[] (inclusief licentie en CC BY-attributie, ook op envelop-niveau), stappen[] (alleen onderzoek) en gebruik (model, rondes, toolcalls, tokens, cap).

Architectuur: documentatie-modus doorzoekt uitsluitend het eigen register — deterministisch, gratis. De data-/onderzoek-modus plannen via een gehost mid-tier model achter een OpenAI-compatibele endpoint-config (env LLM_BASE_URL, LLM_KEY, LLM_MODEL — provider-vrij; LLM_MODEL_ONDERZOEK voor een zwaarder onderzoek-model). Het model krijgt alléén geselecteerde MCP-tooldefinities en voert calls uit via dezelfde MCP-laag als elke client — Identix.org roept nóóit direct broninstanties aan voor een antwoord.

Afscherming: rate limiting per ident (apart LLM-budget: ASSISTENT_LIMIET_PER_UUR · ASSISTENT_LLM_LIMIET_PER_UUR), harde token-cap (LLM_TOKEN_CAP) met inkappen van toolresultaten, max toolcalls per vraag. Zonder provider-config antwoorden de LLM-modi met HTTP 503 — de pagina valt terug op de documentatie-modus. Privacy: géén gesprekslogs; gebruik wordt uitsluitend als anoniem, in-memory aggregaat geteld (GET /v1/assistent/status).