Aan de slag met nlapi.nl
Alle endpoints werken op dezelfde manier: een GET-request naar https://api.nlapi.nl/v1/... met je sleutel in een header, en een JSON-antwoord terug. De volledige specificatie is er ook als OpenAPI, om te importeren in bijvoorbeeld Postman of Insomnia.
Werk je met een coding agent? Gebruik de Markdown-handleiding en llms.txt om de beschikbare functies en beperkingen te vinden. De OpenAPI-specificatie beschrijft het technische contract. Bekijk ook de toepassingen per API.
Authenticatie
Stuur je API-sleutel mee in de header X-API-Key, nooit in de URL, en altijd via https: over http weigeren we het request (https_vereist) in plaats van door te sturen, want dan is je sleutel al onversleuteld onderweg geweest. Gebruik de sleutel alleen op je server: in JavaScript in de browser is hij voor iedereen leesbaar. Een sleutel maak je aan in je dashboard.
curl "https://api.nlapi.nl/v1/feestdagen/2026" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/feestdagen/2026');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/feestdagen/2026", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/feestdagen/2026",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
De voorbeelden lezen je sleutel uit de omgevingsvariabele NLAPI_KEY. Voor Python heb je het pakket requests nodig; het Node.js-voorbeeld vraagt Node 18 of nieuwer, in een ES-module (.mjs) vanwege de await. Je keuze voor een taal geldt voor alle voorbeelden op deze pagina.
Antwoorden
Elk antwoord heeft dezelfde vorm. Bij succes staat de data in data, met in meta de bron, de licentie, wanneer we het ophaalden en of het uit onze buffer komt (cache).
{
"success": true,
"data": { ... },
"meta": { "bron": "BAG (PDOK)", "licentie": "CC0", "opgehaald": "2026-11-05T10:12:00+01:00", "cache": true }
}
Is een bron even niet bereikbaar, maar hebben we een eerdere versie, dan krijg je die, met "verouderd": true in meta. Veldnamen zijn Nederlands, datums ISO 8601, coördinaten lat/lon.
Foutcodes
{
"success": false,
"error": { "code": "limiet_bereikt", "message": "Maandlimiet van 100 requests bereikt." }
}
Reageer op code, niet op message: de code blijft gelijk, de tekst kan veranderen.
| HTTP | Code | Betekenis |
|---|---|---|
| 400 | ongeldige_invoer | Een parameter klopt niet, bijv. een postcode in het verkeerde formaat. |
| 401 | sleutel_ontbreekt | Er is geen X-API-Key meegestuurd. |
| 401 | sleutel_ongeldig | De sleutel bestaat niet of is ingetrokken. |
| 403 | geen_toegang | Account geblokkeerd of e-mailadres nog niet bevestigd, of deze sleutel mag deze bron of dit IP-adres niet gebruiken. |
| 403 | https_vereist | Het request ging over http. Gebruik https; stuurde je een sleutel mee, maak dan een nieuwe aan. |
| 404 | niet_gevonden | Het endpoint of het gevraagde item bestaat niet. |
| 405 | methode_niet_toegestaan | Alleen GET is toegestaan. |
| 429 | limiet_bereikt | Te veel requests per minuut, of het maandquotum is op. Kijk in Retry-After hoe lang je moet wachten. |
| 500 | interne_fout | Er ging iets mis aan onze kant. |
| 503 | bron_onbereikbaar | De bron reageert niet en we hebben geen eerdere versie in de buffer. Kijk in Retry-After. |
Limieten
Er geldt een limiet per minuut per sleutel en een quotum per maand voor je hele account, afhankelijk van je plan. Elk antwoord met een sleutel vertelt hoeveel je nog hebt:
| Header | Betekenis |
|---|---|
X-RateLimit-Limit | Maximum aantal requests per minuut voor deze sleutel. |
X-RateLimit-Remaining | Wat er deze minuut nog over is. |
X-Quota-Limit | Maximum aantal requests per maand voor je account. |
X-Quota-Remaining | Wat er deze maand nog over is. |
Retry-After | Bij 429 en 503: na hoeveel seconden je het opnieuw kunt proberen. |
Algemeen
Werken de API en de bronnen?
GET /v1/status
zonder sleutel Zonder sleutel. status is ok of verstoord (een bron heeft een storing; de andere
werken gewoon). HTTP 503 alleen als de API zelf niet werkt.
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
status | ok of verstoord | |
versie | tekst | |
tijd | tekst (datum en tijd) | |
onderdelen | object | |
onderdelen.database | ok of fout | |
onderdelen.bronnen | object |
Voorbeeld
curl "https://api.nlapi.nl/v1/status"
$ch = curl_init('https://api.nlapi.nl/v1/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/status");
const { data } = await res.json();
console.log(data);
import requests
res = requests.get("https://api.nlapi.nl/v1/status", timeout=10)
print(res.json()["data"])
{
"success": true,
"data": {
"status": "ok",
"versie": "v1",
"tijd": "2026-11-14T10:12:00+01:00",
"onderdelen": {
"database": "ok",
"bronnen": {
"feestdagen": {
"status": "ok",
"laatst_opgehaald": null
},
"postcode": {
"status": "ok",
"laatst_opgehaald": "2026-11-14T09:58:51+01:00"
},
"rdw": {
"status": "ok",
"laatst_opgehaald": "2026-11-14T10:11:09+01:00"
},
"schoolvakanties": {
"status": "ok",
"laatst_opgehaald": "2026-11-14T08:30:59+01:00"
}
}
}
}
}
Mogelijke fouten: 503 (zie foutcodes).
Kalender
Nederlandse feestdagen van een jaar
GET /v1/feestdagen/{jaar}
Zelf berekend (Pasen volgens de Gregoriaanse kalender). Jaren 2014 tot en met 2099.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
jaar |
pad | tekst | Voorbeeld: 2027 |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
[].datum | tekst (datum) | |
[].naam | tekst | |
[].algemeen_erkend | true/false | Genoemd in de Algemene termijnenwet. |
[].opmerking | tekst of null |
Voorbeeld
curl "https://api.nlapi.nl/v1/feestdagen/2027" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/feestdagen/2027');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/feestdagen/2027", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/feestdagen/2027",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": [
{
"datum": "2027-01-01",
"naam": "Nieuwjaarsdag",
"algemeen_erkend": true,
"opmerking": null
},
{
"datum": "2027-03-26",
"naam": "Goede Vrijdag",
"algemeen_erkend": false,
"opmerking": "Geen algemeen erkende feestdag; vrij volgens sommige cao's."
},
{
"datum": "2027-03-28",
"naam": "Eerste Paasdag",
"algemeen_erkend": true,
"opmerking": null
}
],
"meta": {
"bron": "Berekend door nlapi.nl",
"jaar": 2027
}
}
Mogelijke fouten: 400, 401, 403, 429 (zie foutcodes).
Schoolvakanties per schooljaar en regio
GET /v1/schoolvakanties/{schooljaar}/{regio}
Bron: opendata.rijksoverheid.nl. Vakanties voor heel Nederland staan in elke regio.
verplicht: false betekent dat de data een advies zijn; scholen mogen afwijken.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
schooljaar |
pad | tekst | Voorbeeld: 2025-2026 |
regio |
pad | noord, midden of zuid | Voorbeeld: zuid |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
schooljaar | tekst | Loopt van augustus tot en met juli. |
regio | noord, midden of zuid | Regio-indeling van de Rijksoverheid. |
vakanties | lijst | |
vakanties[].naam | tekst | |
vakanties[].begindatum | tekst (datum) | Eerste vakantiedag (meestal een zaterdag). |
vakanties[].einddatum | tekst (datum) | Laatste vakantiedag (meestal een zondag). |
vakanties[].verplicht | true/false | false: adviesdata, scholen mogen afwijken. |
Voorbeeld
curl "https://api.nlapi.nl/v1/schoolvakanties/2025-2026/zuid" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/schoolvakanties/2025-2026/zuid');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/schoolvakanties/2025-2026/zuid", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/schoolvakanties/2025-2026/zuid",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"schooljaar": "2025-2026",
"regio": "zuid",
"vakanties": [
{
"naam": "Herfstvakantie",
"begindatum": "2025-10-11",
"einddatum": "2025-10-19",
"verplicht": false
},
{
"naam": "Kerstvakantie",
"begindatum": "2025-12-20",
"einddatum": "2026-01-04",
"verplicht": true
},
{
"naam": "Voorjaarsvakantie",
"begindatum": "2026-02-14",
"einddatum": "2026-02-22",
"verplicht": false
},
{
"naam": "Meivakantie",
"begindatum": "2026-04-25",
"einddatum": "2026-05-03",
"verplicht": false
},
{
"naam": "Zomervakantie",
"begindatum": "2026-07-11",
"einddatum": "2026-08-23",
"verplicht": true
}
]
},
"meta": {
"bron": "Rijksoverheid (opendata.rijksoverheid.nl)",
"licentie": "CC0",
"opgehaald": "2026-11-14T10:12:00+01:00",
"cache": true
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).
Adres
Adres op postcode en huisnummer
GET /v1/postcode/{postcode}/{huisnummer}
Bron: BAG via PDOK. Zonder toevoeging krijg je het adres zonder toevoeging, of als dat
niet bestaat het eerste adres met dat huisnummer. toevoegingen noemt alle toevoegingen
bij het huisnummer, bijvoorbeeld voor een keuzelijst.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
postcode |
pad | tekst | Met of zonder spatie, hoofd- of kleine letters. Voorbeeld:1012JS |
huisnummer |
pad | tekst | Zonder toevoeging; die gaat in 1 |
toevoeging (optioneel) |
query | tekst | Huisletter en/of huisnummertoevoeging, bijv. |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
straat | tekst | Straatnaam (openbare ruimte in de BAG). |
huisnummer | geheel getal | |
huisletter | tekst of null | Eén letter, bijv. A in 12A. |
huisnummertoevoeging | tekst of null | Toevoeging na het nummer, bijv. 2 in 12-2 of bis. |
postcode | tekst | Zonder spatie, hoofdletters. |
plaats | tekst | Woonplaats volgens de BAG (kan afwijken van de gemeente). |
gemeente | tekst of null | |
provincie | tekst of null | |
lat | getal of null | Breedtegraad (WGS84) van het adresseerbaar object, 6 decimalen. |
lon | getal of null | Lengtegraad (WGS84). |
nummeraanduiding_id | tekst of null | Vaste BAG-sleutel van dit adres. Blijft gelijk bij hernummering; handig om adressen op te slaan of te koppelen aan andere BAG-gegevens. |
toevoegingen | lijst | Alle toevoegingen bij dit huisnummer (huisletter en toevoeging aan elkaar), leeg als er geen zijn. |
Voorbeeld
curl "https://api.nlapi.nl/v1/postcode/1012JS/1" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/postcode/1012JS/1');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/postcode/1012JS/1", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/postcode/1012JS/1",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"straat": "Dam",
"huisnummer": 1,
"huisletter": null,
"huisnummertoevoeging": null,
"postcode": "1012JS",
"plaats": "Amsterdam",
"gemeente": "Amsterdam",
"provincie": "Noord-Holland",
"lat": 52.373293,
"lon": 4.893718,
"nummeraanduiding_id": "0363200003761447",
"toevoegingen": []
},
"meta": {
"bron": "BAG (PDOK)",
"licentie": "CC0",
"opgehaald": "2026-11-14T10:12:00+01:00",
"cache": true
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).
Gebouw en buurt bij een adres
GET /v1/gebouw/{postcode}/{huisnummer}
Bron: BAG via PDOK. Het adres zoals bij /v1/postcode, plus wat de BAG verder over het
adres weet: het gebouw (gebruiksdoelen, oppervlakte, status en per pand het bouwjaar), de
buurt- en wijkindeling, het waterschap, de kadastrale percelen en de BAG-identificaties.
Zelfde invoer als /v1/postcode, ook toevoeging. Telt als één request.
Een ligplaats (woonboot) of standplaats (woonwagen) heeft geen gebouw: dan is gebouw
null en zegt objecttype welk soort adres het is.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
postcode |
pad | tekst | Met of zonder spatie, hoofd- of kleine letters. Voorbeeld:1012JS |
huisnummer |
pad | tekst | Zonder toevoeging; die gaat in 1 |
toevoeging (optioneel) |
query | tekst | Huisletter en/of huisnummertoevoeging, bijv. |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
adres | object | |
adres.straat | tekst | Straatnaam (openbare ruimte in de BAG). |
adres.huisnummer | geheel getal | |
adres.huisletter | tekst of null | Eén letter, bijv. A in 12A. |
adres.huisnummertoevoeging | tekst of null | Toevoeging na het nummer, bijv. 2 in 12-2 of bis. |
adres.postcode | tekst | Zonder spatie, hoofdletters. |
adres.plaats | tekst | Woonplaats volgens de BAG (kan afwijken van de gemeente). |
adres.gemeente | tekst of null | |
adres.provincie | tekst of null | |
adres.lat | getal of null | Breedtegraad (WGS84) van het adresseerbaar object, 6 decimalen. |
adres.lon | getal of null | Lengtegraad (WGS84). |
adres.nummeraanduiding_id | tekst of null | Vaste BAG-sleutel van dit adres. Blijft gelijk bij hernummering; handig om adressen op te slaan of te koppelen aan andere BAG-gegevens. |
adres.toevoegingen | lijst | Alle toevoegingen bij dit huisnummer (huisletter en toevoeging aan elkaar), leeg als er geen zijn. |
objecttype | verblijfsobject, ligplaats, standplaats of | Soort adresseerbaar object: een ruimte in een gebouw, een ligplaats (woonboot) of een standplaats (woonwagen). |
adrestype | hoofdadres, nevenadres of | Een object heeft één hoofdadres en soms nevenadressen. |
indeling | object | Bestuurlijke indeling. Buurt- en wijkcodes zijn die van het CBS (koppelen aan CBS-cijfers); ze ontbreken soms bij nieuwe adressen. |
indeling.buurtcode | tekst of null | |
indeling.buurtnaam | tekst of null | |
indeling.wijkcode | tekst of null | |
indeling.wijknaam | tekst of null | |
indeling.gemeentecode | tekst of null | Gemeentecode van vier cijfers. |
indeling.gemeente | tekst of null | |
indeling.provinciecode | tekst of null | |
indeling.provincieafkorting | tekst of null | |
indeling.provincie | tekst of null | |
indeling.waterschapscode | tekst of null | |
indeling.waterschap | tekst of null | |
gebouw | object of null | Het verblijfsobject en de panden waarin het ligt. null bij een ligplaats of standplaats. |
gebouw.gebruiksdoelen | lijst | Gebruiksdoelen volgens de BAG. |
gebouw.oppervlakte | geheel getal of null | Gebruiksoppervlakte in m² volgens de BAG. |
gebouw.status | tekst of null | |
gebouw.panden | lijst | Meestal één pand; een verblijfsobject kan in meer panden liggen. |
gebouw.panden[].id | tekst of null | Pand-identificatie in de BAG. |
gebouw.panden[].bouwjaar | geheel getal of null | Jaar van oplevering van het pand. |
gebouw.panden[].status | tekst of null | |
gebouw.panden[].aantal_verblijfsobjecten | geheel getal of null | Verblijfsobjecten in dit pand (bijv. appartementen). |
kadaster | object | |
kadaster.percelen | lijst | Kadastrale percelen onder het object, bijv. ASD04-F-6417. |
kadaster.appartementsrechten | lijst | Gekoppelde appartementsrechten, leeg als er geen zijn. |
coordinaten | object | |
coordinaten.lat | getal of null | Breedtegraad (WGS84). |
coordinaten.lon | getal of null | Lengtegraad (WGS84). |
coordinaten.rd_x | getal of null | X in Rijksdriehoekscoördinaten (EPSG:28992), in meters. |
coordinaten.rd_y | getal of null | Y in Rijksdriehoekscoördinaten. |
ids | object | Identificaties in de BAG, om te koppelen met andere bronnen. |
ids.nummeraanduiding_id | tekst of null | |
ids.adresseerbaarobject_id | tekst of null | Verblijfsobject, ligplaats of standplaats. |
ids.openbareruimte_id | tekst of null | |
ids.woonplaats_id | tekst of null | |
ids.pand_ids | lijst |
Voorbeeld
curl "https://api.nlapi.nl/v1/gebouw/1012JS/1" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/gebouw/1012JS/1');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/gebouw/1012JS/1", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/gebouw/1012JS/1",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"adres": {
"straat": "Dam",
"huisnummer": 1,
"huisletter": null,
"huisnummertoevoeging": null,
"postcode": "1012JS",
"plaats": "Amsterdam",
"gemeente": "Amsterdam",
"provincie": "Noord-Holland",
"lat": 52.373293,
"lon": 4.893718,
"nummeraanduiding_id": "0363200003761447",
"toevoegingen": []
},
"objecttype": "verblijfsobject",
"adrestype": "hoofdadres",
"indeling": {
"buurtcode": "BU0363AE02",
"buurtnaam": "Oude Kerk e.o.",
"wijkcode": "WK0363AE",
"wijknaam": "Burgwallen-Oude Zijde",
"gemeentecode": "0363",
"gemeente": "Amsterdam",
"provinciecode": "PV27",
"provincieafkorting": "NH",
"provincie": "Noord-Holland",
"waterschapscode": "11",
"waterschap": "Waterschap Amstel, Gooi en Vecht"
},
"gebouw": {
"gebruiksdoelen": [
"winkelfunctie"
],
"oppervlakte": 23820,
"status": "Verblijfsobject in gebruik",
"panden": [
{
"id": "0363100012168052",
"bouwjaar": 1914,
"status": "Pand in gebruik",
"aantal_verblijfsobjecten": 1
}
]
},
"kadaster": {
"percelen": [
"ASD04-F-6417",
"ASD04-F-7285"
],
"appartementsrechten": []
},
"coordinaten": {
"lat": 52.373293,
"lon": 4.893718,
"rd_x": 121394.0,
"rd_y": 487383.0
},
"ids": {
"nummeraanduiding_id": "0363200003761447",
"adresseerbaarobject_id": "0363010003761571",
"openbareruimte_id": "0363300000003186",
"woonplaats_id": "3594",
"pand_ids": [
"0363100012168052"
]
}
},
"meta": {
"bron": "BAG (PDOK)",
"licentie": "CC0",
"opgehaald": "2026-11-17T21:30:00+01:00",
"cache": false
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).
Voertuig
Voertuiggegevens op kenteken
GET /v1/rdw/{kenteken}
Bron RDW Open Data. Kenteken met of zonder streepjes.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
kenteken |
pad | tekst | Voorbeeld: HP-R64-S |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
kenteken | tekst | Zonder streepjes, hoofdletters. |
voertuigsoort | tekst of null | |
merk | tekst of null | |
handelsbenaming | tekst of null | Model zoals de fabrikant het noemt. |
inrichting | tekst of null | |
eerste_kleur | tekst of null | |
tweede_kleur | tekst of null | |
datum_eerste_toelating | tekst (datum) of null | Eerste toelating op de weg, ook in het buitenland. |
datum_eerste_tenaamstelling_in_nederland | tekst (datum) of null | |
vervaldatum_apk | tekst (datum) of null | Tot wanneer de APK geldig is. |
aantal_zitplaatsen | geheel getal of null | |
aantal_deuren | geheel getal of null | |
aantal_cilinders | geheel getal of null | |
cilinderinhoud | geheel getal of null | In cm³. |
massa_ledig_voertuig | geheel getal of null | In kg. |
massa_rijklaar | geheel getal of null | In kg. |
toegestane_maximum_massa_voertuig | geheel getal of null | In kg. |
maximum_massa_trekken_ongeremd | geheel getal of null | In kg. |
maximum_trekken_massa_geremd | geheel getal of null | In kg. |
catalogusprijs | geheel getal of null | In euro. |
bruto_bpm | geheel getal of null | In euro. |
europese_voertuigcategorie | tekst of null | Bijv. M1 (personenauto) of N1 (bestelauto). |
zuinigheidsclassificatie | tekst of null | |
wam_verzekerd | true/false of null | Is er een WA-verzekering geregistreerd? |
openstaande_terugroepactie | true/false of null | Staat er een terugroepactie open voor dit voertuig? |
export | true/false of null | Is het voertuig geëxporteerd? |
taxi | true/false of null | |
tellerstandoordeel | tekst of null | Oordeel van de RDW over de kilometerstand, bijv. Logisch. |
brandstoffen | lijst | |
brandstoffen[].brandstof | tekst of null | |
brandstoffen[].vermogen_kw | getal of null | |
brandstoffen[].co2_gecombineerd_wltp | geheel getal of null | In g/km. |
brandstoffen[].verbruik_gecombineerd_wltp | getal of null | In l/100 km. |
brandstoffen[].emissieniveau | tekst of null | |
brandstoffen[].hybride_klasse | tekst of null |
Voorbeeld
curl "https://api.nlapi.nl/v1/rdw/HP-R64-S" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/rdw/HP-R64-S');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/rdw/HP-R64-S", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/rdw/HP-R64-S",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"kenteken": "HPR64S",
"voertuigsoort": "Personenauto",
"merk": "VOLVO",
"handelsbenaming": "XC40",
"inrichting": "stationwagen",
"eerste_kleur": "GRIJS",
"tweede_kleur": null,
"datum_eerste_toelating": "2025-06-02",
"datum_eerste_tenaamstelling_in_nederland": "2025-06-02",
"vervaldatum_apk": "2029-06-02",
"aantal_zitplaatsen": 5,
"aantal_deuren": 5,
"aantal_cilinders": 4,
"cilinderinhoud": 1969,
"massa_ledig_voertuig": 1588,
"massa_rijklaar": 1688,
"toegestane_maximum_massa_voertuig": 2000,
"maximum_massa_trekken_ongeremd": 750,
"maximum_trekken_massa_geremd": 2000,
"catalogusprijs": 56008,
"bruto_bpm": 12607,
"europese_voertuigcategorie": "M1",
"zuinigheidsclassificatie": "D",
"wam_verzekerd": true,
"openstaande_terugroepactie": false,
"export": false,
"taxi": false,
"tellerstandoordeel": "Logisch",
"brandstoffen": [
{
"brandstof": "Elektriciteit",
"vermogen_kw": 10.0,
"co2_gecombineerd_wltp": null,
"verbruik_gecombineerd_wltp": null,
"emissieniveau": null,
"hybride_klasse": "NOVC-HEV"
},
{
"brandstof": "Benzine",
"vermogen_kw": 145.0,
"co2_gecombineerd_wltp": 152,
"verbruik_gecombineerd_wltp": 6.7,
"emissieniveau": "EURO 6 EB",
"hybride_klasse": "NOVC-HEV"
}
]
},
"meta": {
"bron": "RDW Open Data",
"licentie": "CC0",
"opgehaald": "2026-11-14T10:12:00+01:00",
"cache": true
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).
Weer
Geldende weerwaarschuwingen
GET /v1/weer/waarschuwingen
Alle waarschuwingen van het KNMI die nu gelden of nog komen, de ernstigste eerst. Sinds november 2026
geeft het KNMI geen codes per provincie meer, maar per waarschuwing een gebied. Met geometrie=1 krijg
je dat gebied als GeoJSON (MultiPolygon), bijvoorbeeld voor een kaart. Wil je weten of een waarschuwing
op één plek geldt, gebruik dan /v1/weer/{plaats}: dat rekenen wij voor je uit.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
geometrie (optioneel) |
query | 1 |
|
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
uitgegeven | tekst (datum en tijd) of null | Wanneer het KNMI deze stand uitgaf. |
waarschuwingen | lijst | |
waarschuwingen[].fenomeen | tekst | |
waarschuwingen[].fenomeen_code | tekst | Zoals het KNMI het noemt, bijv. fog. |
waarschuwingen[].kleur | tekst | |
waarschuwingen[].ernst | tekst of null | |
waarschuwingen[].type | tekst of null | |
waarschuwingen[].kop | tekst of null | |
waarschuwingen[].omschrijving | tekst of null | |
waarschuwingen[].toelichting | tekst of null | |
waarschuwingen[].gebied | tekst of null | In woorden, bijv. "Noord-Nederland en delen van: Flevoland en Overijssel". |
waarschuwingen[].begint | tekst (datum en tijd) of null | |
waarschuwingen[].eindigt | tekst (datum en tijd) of null | |
waarschuwingen[].kans | tekst of null | Kans in procenten, bijv. "60-90". |
waarschuwingen[].zekerheid | tekst of null | |
waarschuwingen[].gevolgen | tekst of null | |
waarschuwingen[].advies | tekst of null | |
waarschuwingen[].geometrie | object | Alleen met geometrie=1. GeoJSON (Multi)Polygon met [lon, lat]. |
waarschuwingen[].geometrie.type | Polygon of MultiPolygon | |
waarschuwingen[].geometrie.coordinates | lijst |
Voorbeeld
curl "https://api.nlapi.nl/v1/weer/waarschuwingen" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/weer/waarschuwingen');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/weer/waarschuwingen", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/weer/waarschuwingen",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"uitgegeven": "2026-11-14T23:30:43+01:00",
"waarschuwingen": [
{
"fenomeen": "mist",
"fenomeen_code": "fog",
"kleur": "geel",
"ernst": "matig",
"type": "waarschuwing",
"kop": "Mist in het noordoosten",
"omschrijving": "In het noordoosten van het land komt plaatselijk dichte mist voor",
"toelichting": "In het noordoosten komt plaatselijk dichte mist voor. In de loop van de nacht naar zondag zal deze mist weer verdwijnen.",
"gebied": "Noord-Nederland en delen van: Flevoland en Overijssel",
"begint": "2026-11-14T21:15:00+01:00",
"eindigt": "2026-11-15T04:00:00+01:00",
"kans": "60-90",
"zekerheid": "waarschijnlijk",
"gevolgen": "Houd rekening met vertragingen op de weg.\nEr is kans op gevaarlijke situaties, bijvoorbeeld omdat de weg opeens slecht te zien is.",
"advies": "Rijd langzamer, houd grotere afstand tot andere weggebruikers.\nDoe de juiste autolichten aan: mistlampen voor (bij minder dan 200 meter zicht), ook mistlampen achter (bij minder dan 50 meter zicht)."
}
]
},
"meta": {
"bron": "KNMI",
"licentie": "CC BY 4.0",
"opgehaald": "2026-11-15T00:18:10+01:00",
"cache": true
}
}
Mogelijke fouten: 401, 403, 429, 503 (zie foutcodes).
Actueel weer bij een postcode
GET /v1/weer/postcode/{postcode}
Zoals /v1/weer/{plaats}, maar voor het midden van een postcodegebied (zonder huisnummer).
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
postcode |
pad | tekst | Met of zonder spatie. Voorbeeld:1012JS |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
locatie | object | De plaats of postcode zoals wij die vonden (controleer bij plaatsnamen die vaker voorkomen). |
locatie.naam | tekst | Woonplaats. |
locatie.postcode | tekst of null | Alleen bij /v1/weer/postcode/{postcode}. |
locatie.gemeente | tekst of null | |
locatie.provincie | tekst of null | |
locatie.lat | getal | |
locatie.lon | getal | |
station | object | Het KNMI-station waar de metingen vandaan komen. |
station.id | tekst | WMO-nummer, bijv. 06260 (De Bilt). |
station.naam | tekst | |
station.lat | getal | |
station.lon | getal | |
station.afstand_km | getal | Afstand tot de gevraagde plek. |
gemeten | tekst (datum en tijd) of null | Tijd van de meting (elke 10 minuten). |
temperatuur | getal of null | In °C, op 1,5 m hoogte. |
gevoelstemperatuur | getal of null | In °C: windchill bij 10 °C of kouder en wind, anders gelijk aan de temperatuur. |
dauwpunt | getal of null | In °C. |
luchtvochtigheid | geheel getal of null | Relatieve luchtvochtigheid in %. |
luchtdruk | getal of null | Op zeeniveau, in hPa. |
wind | object | |
wind.snelheid | getal of null | Gemiddeld over 10 minuten, in m/s. |
wind.snelheid_kmh | geheel getal of null | |
wind.beaufort | geheel getal of null | 0 tot en met 12. |
wind.richting | tekst of null | Waar de wind vandaan komt: N, NNO, NO, … (16 richtingen). |
wind.richting_graden | geheel getal of null | |
wind.windstoten | getal of null | Hoogste windstoot in de afgelopen 10 minuten, in m/s. |
neerslag | object | |
neerslag.intensiteit | getal of null | Nu, in mm per uur. |
neerslag.laatste_uur | getal of null | Gevallen in het afgelopen uur, in mm. |
zicht | geheel getal of null | In meter. |
bewolking | geheel getal of null | In achtsten (okta): 0 = onbewolkt, 8 = geheel bewolkt, 9 = lucht onzichtbaar (bijv. mist). |
weer | object of null | Het weertype; niet elk station meet dit. |
weer.code | geheel getal | WMO-codetabel 4680. |
weer.omschrijving | tekst of null | |
waarschuwingen | lijst of null | Waarschuwingen die nu of later op deze plek gelden (leeg = geen); null als ze tijdelijk niet beschikbaar zijn. |
waarschuwingen[].fenomeen | tekst | |
waarschuwingen[].kleur | tekst | |
waarschuwingen[].kop | tekst of null | |
waarschuwingen[].omschrijving | tekst of null | |
waarschuwingen[].begint | tekst (datum en tijd) of null | |
waarschuwingen[].eindigt | tekst (datum en tijd) of null | |
waarschuwingen[].gevolgen | tekst of null | |
waarschuwingen[].advies | tekst of null |
Voorbeeld
curl "https://api.nlapi.nl/v1/weer/postcode/1012JS" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/weer/postcode/1012JS');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/weer/postcode/1012JS", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/weer/postcode/1012JS",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"locatie": {
"naam": "Amsterdam",
"postcode": "1012JS",
"gemeente": "Amsterdam",
"provincie": "Noord-Holland",
"lat": 52.37291,
"lon": 4.89411
},
"station": {
"id": "06240",
"naam": "Schiphol Airport",
"lat": 52.3156,
"lon": 4.7903,
"afstand_km": 9.4
},
"gemeten": "2026-11-15T00:40:00+01:00",
"temperatuur": 0.6,
"gevoelstemperatuur": -1.7,
"dauwpunt": 0.4,
"luchtvochtigheid": 99,
"luchtdruk": 1012.6,
"wind": {
"snelheid": 2.0,
"snelheid_kmh": 7,
"beaufort": 2,
"richting": "OZO",
"richting_graden": 110,
"windstoten": 3.2
},
"neerslag": {
"intensiteit": 0.0,
"laatste_uur": 0.0
},
"zicht": 12500,
"bewolking": 2,
"weer": {
"code": 0,
"omschrijving": "geen bijzonder weer"
},
"waarschuwingen": []
},
"meta": {
"bron": "KNMI (metingen en waarschuwingen), PDOK (locatie)",
"licentie": "CC BY 4.0 (KNMI), CC0 (PDOK)",
"opgehaald": "2026-11-15T00:20:04+01:00",
"cache": true
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).
Actueel weer in een plaats
GET /v1/weer/{plaats}
De laatste metingen van het dichtstbijzijnde KNMI-station dat temperatuur en wind meet (stations op zee
tellen niet mee), met de waarschuwingen die op deze plek gelden. Het KNMI meet elke 10 minuten; wij halen
de metingen ook elke 10 minuten op. Komt een plaatsnaam vaker voor (Bergen), geef dan de provincie mee;
locatie in het antwoord zegt welke plaats het is geworden.
Bron: KNMI (CC BY 4.0). Gebruik je de data in je eigen product, vermeld dan het KNMI als bron.
Parameters
| Naam | In | Type | Uitleg |
|---|---|---|---|
plaats |
pad | tekst | Woonplaats, bijv. Groningen |
provincie (optioneel) |
query | tekst | Om te kiezen bij plaatsnamen die vaker voorkomen, bijv. |
Velden in data
| Veld | Type | Uitleg |
|---|---|---|
locatie | object | De plaats of postcode zoals wij die vonden (controleer bij plaatsnamen die vaker voorkomen). |
locatie.naam | tekst | Woonplaats. |
locatie.postcode | tekst of null | Alleen bij /v1/weer/postcode/{postcode}. |
locatie.gemeente | tekst of null | |
locatie.provincie | tekst of null | |
locatie.lat | getal | |
locatie.lon | getal | |
station | object | Het KNMI-station waar de metingen vandaan komen. |
station.id | tekst | WMO-nummer, bijv. 06260 (De Bilt). |
station.naam | tekst | |
station.lat | getal | |
station.lon | getal | |
station.afstand_km | getal | Afstand tot de gevraagde plek. |
gemeten | tekst (datum en tijd) of null | Tijd van de meting (elke 10 minuten). |
temperatuur | getal of null | In °C, op 1,5 m hoogte. |
gevoelstemperatuur | getal of null | In °C: windchill bij 10 °C of kouder en wind, anders gelijk aan de temperatuur. |
dauwpunt | getal of null | In °C. |
luchtvochtigheid | geheel getal of null | Relatieve luchtvochtigheid in %. |
luchtdruk | getal of null | Op zeeniveau, in hPa. |
wind | object | |
wind.snelheid | getal of null | Gemiddeld over 10 minuten, in m/s. |
wind.snelheid_kmh | geheel getal of null | |
wind.beaufort | geheel getal of null | 0 tot en met 12. |
wind.richting | tekst of null | Waar de wind vandaan komt: N, NNO, NO, … (16 richtingen). |
wind.richting_graden | geheel getal of null | |
wind.windstoten | getal of null | Hoogste windstoot in de afgelopen 10 minuten, in m/s. |
neerslag | object | |
neerslag.intensiteit | getal of null | Nu, in mm per uur. |
neerslag.laatste_uur | getal of null | Gevallen in het afgelopen uur, in mm. |
zicht | geheel getal of null | In meter. |
bewolking | geheel getal of null | In achtsten (okta): 0 = onbewolkt, 8 = geheel bewolkt, 9 = lucht onzichtbaar (bijv. mist). |
weer | object of null | Het weertype; niet elk station meet dit. |
weer.code | geheel getal | WMO-codetabel 4680. |
weer.omschrijving | tekst of null | |
waarschuwingen | lijst of null | Waarschuwingen die nu of later op deze plek gelden (leeg = geen); null als ze tijdelijk niet beschikbaar zijn. |
waarschuwingen[].fenomeen | tekst | |
waarschuwingen[].kleur | tekst | |
waarschuwingen[].kop | tekst of null | |
waarschuwingen[].omschrijving | tekst of null | |
waarschuwingen[].begint | tekst (datum en tijd) of null | |
waarschuwingen[].eindigt | tekst (datum en tijd) of null | |
waarschuwingen[].gevolgen | tekst of null | |
waarschuwingen[].advies | tekst of null |
Voorbeeld
curl "https://api.nlapi.nl/v1/weer/Groningen" \ -H "X-API-Key: $NLAPI_KEY"
$ch = curl_init('https://api.nlapi.nl/v1/weer/Groningen');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('NLAPI_KEY')],
]);
$antwoord = json_decode(curl_exec($ch), true);
print_r($antwoord['data']);
const res = await fetch("https://api.nlapi.nl/v1/weer/Groningen", {
headers: { "X-API-Key": process.env.NLAPI_KEY },
});
const { data } = await res.json();
console.log(data);
import os
import requests
res = requests.get(
"https://api.nlapi.nl/v1/weer/Groningen",
headers={"X-API-Key": os.environ["NLAPI_KEY"]},
timeout=10,
)
print(res.json()["data"])
{
"success": true,
"data": {
"locatie": {
"naam": "Groningen",
"postcode": null,
"gemeente": "Groningen",
"provincie": "Groningen",
"lat": 53.22223,
"lon": 6.56334
},
"station": {
"id": "06280",
"naam": "Groningen Airport Eelde",
"lat": 53.1236,
"lon": 6.5847,
"afstand_km": 11.1
},
"gemeten": "2026-11-15T00:40:00+01:00",
"temperatuur": 0.6,
"gevoelstemperatuur": -1.7,
"dauwpunt": 0.4,
"luchtvochtigheid": 99,
"luchtdruk": 1012.6,
"wind": {
"snelheid": 2.0,
"snelheid_kmh": 7,
"beaufort": 2,
"richting": "OZO",
"richting_graden": 110,
"windstoten": 3.2
},
"neerslag": {
"intensiteit": 0.0,
"laatste_uur": 0.0
},
"zicht": 495,
"bewolking": 9,
"weer": {
"code": 33,
"omschrijving": "mist, onveranderd"
},
"waarschuwingen": [
{
"fenomeen": "mist",
"kleur": "geel",
"kop": "Mist in het noordoosten",
"omschrijving": "In het noordoosten van het land komt plaatselijk dichte mist voor",
"begint": "2026-11-14T21:15:00+01:00",
"eindigt": "2026-11-15T04:00:00+01:00",
"gevolgen": "Houd rekening met vertragingen op de weg.\nEr is kans op gevaarlijke situaties, bijvoorbeeld omdat de weg opeens slecht te zien is.",
"advies": "Rijd langzamer, houd grotere afstand tot andere weggebruikers.\nDoe de juiste autolichten aan: mistlampen voor (bij minder dan 200 meter zicht), ook mistlampen achter (bij minder dan 50 meter zicht)."
}
]
},
"meta": {
"bron": "KNMI (metingen en waarschuwingen), PDOK (locatie)",
"licentie": "CC BY 4.0 (KNMI), CC0 (PDOK)",
"opgehaald": "2026-11-15T00:20:04+01:00",
"cache": true
}
}
Mogelijke fouten: 400, 401, 403, 404, 429, 503 (zie foutcodes).