# nederland.cloud

> Alle API's van Nederland, één standaard. Elke bron-API is individueel
> aanspreekbaar; antwoorden zijn genormaliseerd (ISO-datums, WGS84,
> null = onbekend bij de bron, fouten in RFC 7807). Live vanaf de bron.

Menselijke documentatie: /docs — machine-specificatie: /openapi.yaml —
MCP (tools voor LLM's): POST /mcp (streamable HTTP).

Elk endpoint is een API. Achter elk endpoint zit óf een onderliggende
bron-API (veld bron_type: 'bron-api'; eigen adapter op de API van de
instantie) óf een dataset uit de landelijke catalogus (bron_type:
'dataset'; universele ontsluiting via /v1/datasets/{id}/data). Voor de
aanroeper is het formaat identiek.

## API's

### BAG — Adressen
- GET /v1/bag/adressen — parameters: q (verplicht), rows (optioneel), start (optioneel)
- GET /v1/bag/suggest — parameters: q (verplicht), rows (optioneel)
- GET /v1/bag/lookup — parameters: id (verplicht)
- Instantie: Kadaster / PDOK · licentie: CC0 1.0 (BAG)

### CBS — Kerncijfers wijken en buurten
- GET /v1/cbs/kerncijfers — parameters: regio (verplicht), jaar (optioneel)
- GET /v1/cbs/regios — parameters: binnen (verplicht), niveau (verplicht)
- Instantie: Centraal Bureau voor de Statistiek · licentie: CC BY 4.0

### Kadaster — Kadastrale kaart (5 collecties)
- GET /v1/kadaster/percelen — parameters: lon (verplicht), lat (verplicht), radius (optioneel)
- GET /v1/kadaster/grenzen — parameters: lon (verplicht), lat (verplicht), radius (optioneel)
- GET /v1/kadaster/bebouwing — parameters: lon (verplicht), lat (verplicht), radius (optioneel)
- GET /v1/kadaster/openbareruimtenamen — parameters: lon (verplicht), lat (verplicht), radius (optioneel)
- GET /v1/kadaster/nummeraanduidingreeksen — parameters: lon (verplicht), lat (verplicht), radius (optioneel)
- GET /v1/kadaster/percelen/{id} — parameters: id (verplicht)
- Instantie: Kadaster / PDOK · licentie: CC0 1.0

### Luchtmeetnet — Luchtkwaliteit
- GET /v1/luchtmeetnet/metingen — parameters: station (verplicht), formule (optioneel), van (optioneel), tot (optioneel)
- GET /v1/luchtmeetnet/stations — parameters: zoek (optioneel), pagina (optioneel)
- Instantie: RIVM en samenwerkende GGD'en · licentie: Open data (zie bronportaal)

### data.overheid.nl — Catalogus
- GET /v1/catalogus/datasets — parameters: q (optioneel), instantie (optioneel), rows (optioneel), start (optioneel)
- GET /v1/catalogus/datasets/{id} — parameters: id (verplicht)
- GET /v1/catalogus/instanties
- Instantie: Koop Overheid · licentie: CC0 1.0

### RDW — Voertuigen
- GET /v1/rdw/voertuigen — parameters: kenteken (optioneel), merk (optioneel), rows (optioneel)
- Instantie: Rijksdienst voor het Wegverkeer · licentie: CC0 1.0

### RCE — Rijksmonumentenregister
- GET /v1/rce/monumenten — parameters: rijksmonumentnummer (optioneel), postcode (optioneel), straat (optioneel), woonplaatsnaam (optioneel), page (optioneel)
- Instantie: Rijksdienst voor het Cultureel Erfgoed · licentie: CC0 1.0

## Response-formaat

Elk antwoord: `{api, versie, onderdeel, gegenereerd_op, duur_ms, bronnen[], data}`.
`bronnen[]` vermeldt per antwoord de herkomst, licentie en (bij CC BY) de
verplichte attributie. Alle voorbeelden:

- GET /v1/bag/adressen?q=Dam 1, Amsterdam
- GET /v1/cbs/kerncijfers?regio=WK0363AE
- GET /v1/kadaster/percelen?lon=4.8930&lat=52.3730
- GET /v1/luchtmeetnet/metingen?station=NL49565

## Gebruiksadvies voor LLM's

1. Zoek eerst een adres met bag_adressen; de respons bevat wijk-/buurtcodes
   en coördinaten voor de andere API's.
2. Gebruik MCP indien beschikbaar: de tools hebben identieke namen en schema's.