Documentatie

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"

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.

HTTPCodeBetekenis
400ongeldige_invoerEen parameter klopt niet, bijv. een postcode in het verkeerde formaat.
401sleutel_ontbreektEr is geen X-API-Key meegestuurd.
401sleutel_ongeldigDe sleutel bestaat niet of is ingetrokken.
403geen_toegangAccount geblokkeerd of e-mailadres nog niet bevestigd, of deze sleutel mag deze bron of dit IP-adres niet gebruiken.
403https_vereistHet request ging over http. Gebruik https; stuurde je een sleutel mee, maak dan een nieuwe aan.
404niet_gevondenHet endpoint of het gevraagde item bestaat niet.
405methode_niet_toegestaanAlleen GET is toegestaan.
429limiet_bereiktTe veel requests per minuut, of het maandquotum is op. Kijk in Retry-After hoe lang je moet wachten.
500interne_foutEr ging iets mis aan onze kant.
503bron_onbereikbaarDe 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:

HeaderBetekenis
X-RateLimit-LimitMaximum aantal requests per minuut voor deze sleutel.
X-RateLimit-RemainingWat er deze minuut nog over is.
X-Quota-LimitMaximum aantal requests per maand voor je account.
X-Quota-RemainingWat er deze maand nog over is.
Retry-AfterBij 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

VeldTypeUitleg
statusok of verstoord
versietekst
tijdtekst (datum en tijd)
onderdelenobject
onderdelen.databaseok of fout
onderdelen.bronnenobject

Voorbeeld

curl "https://api.nlapi.nl/v1/status"
{
    "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

NaamInTypeUitleg
jaar pad tekst Voorbeeld: 2027

Velden in data

VeldTypeUitleg
[].datumtekst (datum)
[].naamtekst
[].algemeen_erkendtrue/falseGenoemd in de Algemene termijnenwet.
[].opmerkingtekst of null

Voorbeeld

curl "https://api.nlapi.nl/v1/feestdagen/2027" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
schooljaar pad tekst Voorbeeld: 2025-2026
regio pad noord, midden of zuid Voorbeeld: zuid

Velden in data

VeldTypeUitleg
schooljaartekstLoopt van augustus tot en met juli.
regionoord, midden of zuidRegio-indeling van de Rijksoverheid.
vakantieslijst
vakanties[].naamtekst
vakanties[].begindatumtekst (datum)Eerste vakantiedag (meestal een zaterdag).
vakanties[].einddatumtekst (datum)Laatste vakantiedag (meestal een zondag).
vakanties[].verplichttrue/falsefalse: adviesdata, scholen mogen afwijken.

Voorbeeld

curl "https://api.nlapi.nl/v1/schoolvakanties/2025-2026/zuid" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
postcode pad tekst

Met of zonder spatie, hoofd- of kleine letters.

Voorbeeld: 1012JS
huisnummer pad tekst

Zonder toevoeging; die gaat in toevoeging.

Voorbeeld: 1
toevoeging (optioneel) query tekst

Huisletter en/of huisnummertoevoeging, bijv. B, 2 of A-1.

Velden in data

VeldTypeUitleg
straattekstStraatnaam (openbare ruimte in de BAG).
huisnummergeheel getal
huislettertekst of nullEén letter, bijv. A in 12A.
huisnummertoevoegingtekst of nullToevoeging na het nummer, bijv. 2 in 12-2 of bis.
postcodetekstZonder spatie, hoofdletters.
plaatstekstWoonplaats volgens de BAG (kan afwijken van de gemeente).
gemeentetekst of null
provincietekst of null
latgetal of nullBreedtegraad (WGS84) van het adresseerbaar object, 6 decimalen.
longetal of nullLengtegraad (WGS84).
nummeraanduiding_idtekst of nullVaste BAG-sleutel van dit adres. Blijft gelijk bij hernummering; handig om adressen op te slaan of te koppelen aan andere BAG-gegevens.
toevoegingenlijstAlle 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"
{
    "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

NaamInTypeUitleg
postcode pad tekst

Met of zonder spatie, hoofd- of kleine letters.

Voorbeeld: 1012JS
huisnummer pad tekst

Zonder toevoeging; die gaat in toevoeging.

Voorbeeld: 1
toevoeging (optioneel) query tekst

Huisletter en/of huisnummertoevoeging, bijv. B, 2 of A-1.

Velden in data

VeldTypeUitleg
adresobject
adres.straattekstStraatnaam (openbare ruimte in de BAG).
adres.huisnummergeheel getal
adres.huislettertekst of nullEén letter, bijv. A in 12A.
adres.huisnummertoevoegingtekst of nullToevoeging na het nummer, bijv. 2 in 12-2 of bis.
adres.postcodetekstZonder spatie, hoofdletters.
adres.plaatstekstWoonplaats volgens de BAG (kan afwijken van de gemeente).
adres.gemeentetekst of null
adres.provincietekst of null
adres.latgetal of nullBreedtegraad (WGS84) van het adresseerbaar object, 6 decimalen.
adres.longetal of nullLengtegraad (WGS84).
adres.nummeraanduiding_idtekst of nullVaste BAG-sleutel van dit adres. Blijft gelijk bij hernummering; handig om adressen op te slaan of te koppelen aan andere BAG-gegevens.
adres.toevoegingenlijstAlle toevoegingen bij dit huisnummer (huisletter en toevoeging aan elkaar), leeg als er geen zijn.
objecttypeverblijfsobject, ligplaats, standplaats of Soort adresseerbaar object: een ruimte in een gebouw, een ligplaats (woonboot) of een standplaats (woonwagen).
adrestypehoofdadres, nevenadres of Een object heeft één hoofdadres en soms nevenadressen.
indelingobjectBestuurlijke indeling. Buurt- en wijkcodes zijn die van het CBS (koppelen aan CBS-cijfers); ze ontbreken soms bij nieuwe adressen.
indeling.buurtcodetekst of null
indeling.buurtnaamtekst of null
indeling.wijkcodetekst of null
indeling.wijknaamtekst of null
indeling.gemeentecodetekst of nullGemeentecode van vier cijfers.
indeling.gemeentetekst of null
indeling.provinciecodetekst of null
indeling.provincieafkortingtekst of null
indeling.provincietekst of null
indeling.waterschapscodetekst of null
indeling.waterschaptekst of null
gebouwobject of nullHet verblijfsobject en de panden waarin het ligt. null bij een ligplaats of standplaats.
gebouw.gebruiksdoelenlijstGebruiksdoelen volgens de BAG.
gebouw.oppervlaktegeheel getal of nullGebruiksoppervlakte in m² volgens de BAG.
gebouw.statustekst of null
gebouw.pandenlijstMeestal één pand; een verblijfsobject kan in meer panden liggen.
gebouw.panden[].idtekst of nullPand-identificatie in de BAG.
gebouw.panden[].bouwjaargeheel getal of nullJaar van oplevering van het pand.
gebouw.panden[].statustekst of null
gebouw.panden[].aantal_verblijfsobjectengeheel getal of nullVerblijfsobjecten in dit pand (bijv. appartementen).
kadasterobject
kadaster.percelenlijstKadastrale percelen onder het object, bijv. ASD04-F-6417.
kadaster.appartementsrechtenlijstGekoppelde appartementsrechten, leeg als er geen zijn.
coordinatenobject
coordinaten.latgetal of nullBreedtegraad (WGS84).
coordinaten.longetal of nullLengtegraad (WGS84).
coordinaten.rd_xgetal of nullX in Rijksdriehoekscoördinaten (EPSG:28992), in meters.
coordinaten.rd_ygetal of nullY in Rijksdriehoekscoördinaten.
idsobjectIdentificaties in de BAG, om te koppelen met andere bronnen.
ids.nummeraanduiding_idtekst of null
ids.adresseerbaarobject_idtekst of nullVerblijfsobject, ligplaats of standplaats.
ids.openbareruimte_idtekst of null
ids.woonplaats_idtekst of null
ids.pand_idslijst

Voorbeeld

curl "https://api.nlapi.nl/v1/gebouw/1012JS/1" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
kenteken pad tekst Voorbeeld: HP-R64-S

Velden in data

VeldTypeUitleg
kentekentekstZonder streepjes, hoofdletters.
voertuigsoorttekst of null
merktekst of null
handelsbenamingtekst of nullModel zoals de fabrikant het noemt.
inrichtingtekst of null
eerste_kleurtekst of null
tweede_kleurtekst of null
datum_eerste_toelatingtekst (datum) of nullEerste toelating op de weg, ook in het buitenland.
datum_eerste_tenaamstelling_in_nederlandtekst (datum) of null
vervaldatum_apktekst (datum) of nullTot wanneer de APK geldig is.
aantal_zitplaatsengeheel getal of null
aantal_deurengeheel getal of null
aantal_cilindersgeheel getal of null
cilinderinhoudgeheel getal of nullIn cm³.
massa_ledig_voertuiggeheel getal of nullIn kg.
massa_rijklaargeheel getal of nullIn kg.
toegestane_maximum_massa_voertuiggeheel getal of nullIn kg.
maximum_massa_trekken_ongeremdgeheel getal of nullIn kg.
maximum_trekken_massa_geremdgeheel getal of nullIn kg.
catalogusprijsgeheel getal of nullIn euro.
bruto_bpmgeheel getal of nullIn euro.
europese_voertuigcategorietekst of nullBijv. M1 (personenauto) of N1 (bestelauto).
zuinigheidsclassificatietekst of null
wam_verzekerdtrue/false of nullIs er een WA-verzekering geregistreerd?
openstaande_terugroepactietrue/false of nullStaat er een terugroepactie open voor dit voertuig?
exporttrue/false of nullIs het voertuig geëxporteerd?
taxitrue/false of null
tellerstandoordeeltekst of nullOordeel van de RDW over de kilometerstand, bijv. Logisch.
brandstoffenlijst
brandstoffen[].brandstoftekst of null
brandstoffen[].vermogen_kwgetal of null
brandstoffen[].co2_gecombineerd_wltpgeheel getal of nullIn g/km.
brandstoffen[].verbruik_gecombineerd_wltpgetal of nullIn l/100 km.
brandstoffen[].emissieniveautekst of null
brandstoffen[].hybride_klassetekst of null

Voorbeeld

curl "https://api.nlapi.nl/v1/rdw/HP-R64-S" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
geometrie (optioneel) query 1

1 = ook het gebied als GeoJSON (groot).

Velden in data

VeldTypeUitleg
uitgegeventekst (datum en tijd) of nullWanneer het KNMI deze stand uitgaf.
waarschuwingenlijst
waarschuwingen[].fenomeentekst
waarschuwingen[].fenomeen_codetekstZoals het KNMI het noemt, bijv. fog.
waarschuwingen[].kleurtekst
waarschuwingen[].ernsttekst of null
waarschuwingen[].typetekst of null
waarschuwingen[].koptekst of null
waarschuwingen[].omschrijvingtekst of null
waarschuwingen[].toelichtingtekst of null
waarschuwingen[].gebiedtekst of nullIn woorden, bijv. "Noord-Nederland en delen van: Flevoland en Overijssel".
waarschuwingen[].beginttekst (datum en tijd) of null
waarschuwingen[].eindigttekst (datum en tijd) of null
waarschuwingen[].kanstekst of nullKans in procenten, bijv. "60-90".
waarschuwingen[].zekerheidtekst of null
waarschuwingen[].gevolgentekst of null
waarschuwingen[].adviestekst of null
waarschuwingen[].geometrieobjectAlleen met geometrie=1. GeoJSON (Multi)Polygon met [lon, lat].
waarschuwingen[].geometrie.typePolygon of MultiPolygon
waarschuwingen[].geometrie.coordinateslijst

Voorbeeld

curl "https://api.nlapi.nl/v1/weer/waarschuwingen" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
postcode pad tekst

Met of zonder spatie.

Voorbeeld: 1012JS

Velden in data

VeldTypeUitleg
locatieobjectDe plaats of postcode zoals wij die vonden (controleer bij plaatsnamen die vaker voorkomen).
locatie.naamtekstWoonplaats.
locatie.postcodetekst of nullAlleen bij /v1/weer/postcode/{postcode}.
locatie.gemeentetekst of null
locatie.provincietekst of null
locatie.latgetal
locatie.longetal
stationobjectHet KNMI-station waar de metingen vandaan komen.
station.idtekstWMO-nummer, bijv. 06260 (De Bilt).
station.naamtekst
station.latgetal
station.longetal
station.afstand_kmgetalAfstand tot de gevraagde plek.
gemetentekst (datum en tijd) of nullTijd van de meting (elke 10 minuten).
temperatuurgetal of nullIn °C, op 1,5 m hoogte.
gevoelstemperatuurgetal of nullIn °C: windchill bij 10 °C of kouder en wind, anders gelijk aan de temperatuur.
dauwpuntgetal of nullIn °C.
luchtvochtigheidgeheel getal of nullRelatieve luchtvochtigheid in %.
luchtdrukgetal of nullOp zeeniveau, in hPa.
windobject
wind.snelheidgetal of nullGemiddeld over 10 minuten, in m/s.
wind.snelheid_kmhgeheel getal of null
wind.beaufortgeheel getal of null0 tot en met 12.
wind.richtingtekst of nullWaar de wind vandaan komt: N, NNO, NO, … (16 richtingen).
wind.richting_gradengeheel getal of null
wind.windstotengetal of nullHoogste windstoot in de afgelopen 10 minuten, in m/s.
neerslagobject
neerslag.intensiteitgetal of nullNu, in mm per uur.
neerslag.laatste_uurgetal of nullGevallen in het afgelopen uur, in mm.
zichtgeheel getal of nullIn meter.
bewolkinggeheel getal of nullIn achtsten (okta): 0 = onbewolkt, 8 = geheel bewolkt, 9 = lucht onzichtbaar (bijv. mist).
weerobject of nullHet weertype; niet elk station meet dit.
weer.codegeheel getalWMO-codetabel 4680.
weer.omschrijvingtekst of null
waarschuwingenlijst of nullWaarschuwingen die nu of later op deze plek gelden (leeg = geen); null als ze tijdelijk niet beschikbaar zijn.
waarschuwingen[].fenomeentekst
waarschuwingen[].kleurtekst
waarschuwingen[].koptekst of null
waarschuwingen[].omschrijvingtekst of null
waarschuwingen[].beginttekst (datum en tijd) of null
waarschuwingen[].eindigttekst (datum en tijd) of null
waarschuwingen[].gevolgentekst of null
waarschuwingen[].adviestekst of null

Voorbeeld

curl "https://api.nlapi.nl/v1/weer/postcode/1012JS" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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

NaamInTypeUitleg
plaats pad tekst

Woonplaats, bijv. Utrecht of Den Haag.

Voorbeeld: Groningen
provincie (optioneel) query tekst

Om te kiezen bij plaatsnamen die vaker voorkomen, bijv. NH of Noord-Holland.

Velden in data

VeldTypeUitleg
locatieobjectDe plaats of postcode zoals wij die vonden (controleer bij plaatsnamen die vaker voorkomen).
locatie.naamtekstWoonplaats.
locatie.postcodetekst of nullAlleen bij /v1/weer/postcode/{postcode}.
locatie.gemeentetekst of null
locatie.provincietekst of null
locatie.latgetal
locatie.longetal
stationobjectHet KNMI-station waar de metingen vandaan komen.
station.idtekstWMO-nummer, bijv. 06260 (De Bilt).
station.naamtekst
station.latgetal
station.longetal
station.afstand_kmgetalAfstand tot de gevraagde plek.
gemetentekst (datum en tijd) of nullTijd van de meting (elke 10 minuten).
temperatuurgetal of nullIn °C, op 1,5 m hoogte.
gevoelstemperatuurgetal of nullIn °C: windchill bij 10 °C of kouder en wind, anders gelijk aan de temperatuur.
dauwpuntgetal of nullIn °C.
luchtvochtigheidgeheel getal of nullRelatieve luchtvochtigheid in %.
luchtdrukgetal of nullOp zeeniveau, in hPa.
windobject
wind.snelheidgetal of nullGemiddeld over 10 minuten, in m/s.
wind.snelheid_kmhgeheel getal of null
wind.beaufortgeheel getal of null0 tot en met 12.
wind.richtingtekst of nullWaar de wind vandaan komt: N, NNO, NO, … (16 richtingen).
wind.richting_gradengeheel getal of null
wind.windstotengetal of nullHoogste windstoot in de afgelopen 10 minuten, in m/s.
neerslagobject
neerslag.intensiteitgetal of nullNu, in mm per uur.
neerslag.laatste_uurgetal of nullGevallen in het afgelopen uur, in mm.
zichtgeheel getal of nullIn meter.
bewolkinggeheel getal of nullIn achtsten (okta): 0 = onbewolkt, 8 = geheel bewolkt, 9 = lucht onzichtbaar (bijv. mist).
weerobject of nullHet weertype; niet elk station meet dit.
weer.codegeheel getalWMO-codetabel 4680.
weer.omschrijvingtekst of null
waarschuwingenlijst of nullWaarschuwingen die nu of later op deze plek gelden (leeg = geen); null als ze tijdelijk niet beschikbaar zijn.
waarschuwingen[].fenomeentekst
waarschuwingen[].kleurtekst
waarschuwingen[].koptekst of null
waarschuwingen[].omschrijvingtekst of null
waarschuwingen[].beginttekst (datum en tijd) of null
waarschuwingen[].eindigttekst (datum en tijd) of null
waarschuwingen[].gevolgentekst of null
waarschuwingen[].adviestekst of null

Voorbeeld

curl "https://api.nlapi.nl/v1/weer/Groningen" \
  -H "X-API-Key: $NLAPI_KEY"
{
    "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).