{
    "openapi": "3.1.0",
    "info": {
        "title": "nlapi.nl",
        "version": "1.0.0",
        "summary": "Nederlandse open data via één API-sleutel.",
        "description": "Eén sleutel voor feestdagen, schoolvakanties, adressen en gebouwen (BAG), voertuiggegevens (RDW)\nen actuele KNMI-weermetingen en weerwaarschuwingen,\nin steeds dezelfde vorm.\n\n**Sleutel.** Geef je sleutel mee in de header `X-API-Key`, nooit in de URL. Alleen via\nhttps: een request over http weigeren we met `https_vereist` (403), zonder doorverwijzing.\n\n**Antwoorden.** Altijd JSON met `success`. Bij succes staat het resultaat in `data` en\nde herkomst in `meta`; bij een fout staat er een vaste `code` en een uitleg in `error`.\n\n**Limieten.** Per sleutel per minuut en per account per maand, afhankelijk van je plan.\nElk antwoord met sleutel bevat `X-RateLimit-*` en `X-Quota-*`; bij `429` zegt\n`Retry-After` hoeveel seconden je moet wachten.\n\n**Buffer.** We bewaren wat we bij een bron ophalen. `meta.cache` zegt of het antwoord uit\nonze buffer komt. Is een bron tijdelijk onbereikbaar, dan krijg je de laatst bekende\nversie met `meta.verouderd: true` in plaats van een fout.\n",
        "contact": {
            "url": "https://nlapi.nl/contact"
        }
    },
    "servers": [
        {
            "url": "https://api.nlapi.nl",
            "description": "Productie"
        },
        {
            "url": "https://api-test.nlapi.nl",
            "description": "Test (alleen vanaf toegestane IP-adressen)"
        }
    ],
    "security": [
        {
            "apiKey": []
        }
    ],
    "tags": [
        {
            "name": "Algemeen"
        },
        {
            "name": "Kalender"
        },
        {
            "name": "Adres"
        },
        {
            "name": "Voertuig"
        },
        {
            "name": "Weer"
        }
    ],
    "paths": {
        "/v1/status": {
            "get": {
                "tags": [
                    "Algemeen"
                ],
                "summary": "Werken de API en de bronnen?",
                "description": "Zonder sleutel. `status` is `ok` of `verstoord` (een bron heeft een storing; de andere\nwerken gewoon). HTTP 503 alleen als de API zelf niet werkt.\n",
                "operationId": "status",
                "security": [],
                "responses": {
                    "200": {
                        "description": "De API werkt.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "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"
                                                }
                                            }
                                        }
                                    }
                                },
                                "schema": {
                                    "$ref": "#/components/schemas/StatusAntwoord"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "De API werkt niet (database onbereikbaar).",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StatusAntwoord"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/feestdagen/{jaar}": {
            "get": {
                "tags": [
                    "Kalender"
                ],
                "summary": "Nederlandse feestdagen van een jaar",
                "description": "Zelf berekend (Pasen volgens de Gregoriaanse kalender). Jaren 2014 tot en met 2099.",
                "operationId": "feestdagen",
                "parameters": [
                    {
                        "name": "jaar",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^\\d{4}$"
                        },
                        "example": "2027"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Alle feestdagen, op datum gesorteerd.",
                        "headers": {
                            "X-RateLimit-Limit": {
                                "$ref": "#/components/headers/X-RateLimit-Limit"
                            },
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Limit": {
                                "$ref": "#/components/headers/X-Quota-Limit"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Feestdag"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "additionalProperties": false,
                                            "required": [
                                                "bron",
                                                "jaar"
                                            ],
                                            "properties": {
                                                "bron": {
                                                    "type": "string"
                                                },
                                                "jaar": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    }
                }
            }
        },
        "/v1/schoolvakanties/{schooljaar}/{regio}": {
            "get": {
                "tags": [
                    "Kalender"
                ],
                "summary": "Schoolvakanties per schooljaar en regio",
                "description": "Bron: opendata.rijksoverheid.nl. Vakanties voor heel Nederland staan in elke regio.\n`verplicht: false` betekent dat de data een advies zijn; scholen mogen afwijken.\n",
                "operationId": "schoolvakanties",
                "parameters": [
                    {
                        "name": "schooljaar",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{4}$"
                        },
                        "example": "2025-2026"
                    },
                    {
                        "name": "regio",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "noord",
                                "midden",
                                "zuid"
                            ]
                        },
                        "example": "zuid"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "De vakanties in die regio, op begindatum.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Schoolvakanties"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/postcode/{postcode}/{huisnummer}": {
            "get": {
                "tags": [
                    "Adres"
                ],
                "summary": "Adres op postcode en huisnummer",
                "description": "Bron: BAG via PDOK. Zonder `toevoeging` krijg je het adres zonder toevoeging, of als dat\nniet bestaat het eerste adres met dat huisnummer. `toevoegingen` noemt alle toevoegingen\nbij het huisnummer, bijvoorbeeld voor een keuzelijst.\n",
                "operationId": "postcode",
                "parameters": [
                    {
                        "name": "postcode",
                        "in": "path",
                        "required": true,
                        "description": "Met of zonder spatie, hoofd- of kleine letters.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1012JS"
                    },
                    {
                        "name": "huisnummer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^[1-9][0-9]{0,4}$"
                        },
                        "description": "Zonder toevoeging; die gaat in `toevoeging`.",
                        "example": "1"
                    },
                    {
                        "name": "toevoeging",
                        "in": "query",
                        "required": false,
                        "description": "Huisletter en/of huisnummertoevoeging, bijv. `B`, `2` of `A-1`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Het adres.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Adres"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/gebouw/{postcode}/{huisnummer}": {
            "get": {
                "tags": [
                    "Adres"
                ],
                "summary": "Gebouw en buurt bij een adres",
                "description": "Bron: BAG via PDOK. Het adres zoals bij `/v1/postcode`, plus wat de BAG verder over het\nadres weet: het gebouw (gebruiksdoelen, oppervlakte, status en per pand het bouwjaar), de\nbuurt- en wijkindeling, het waterschap, de kadastrale percelen en de BAG-identificaties.\nZelfde invoer als `/v1/postcode`, ook `toevoeging`. Telt als één request.\n\nEen ligplaats (woonboot) of standplaats (woonwagen) heeft geen gebouw: dan is `gebouw`\n`null` en zegt `objecttype` welk soort adres het is.\n",
                "operationId": "gebouw",
                "parameters": [
                    {
                        "name": "postcode",
                        "in": "path",
                        "required": true,
                        "description": "Met of zonder spatie, hoofd- of kleine letters.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1012JS"
                    },
                    {
                        "name": "huisnummer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^[1-9][0-9]{0,4}$"
                        },
                        "description": "Zonder toevoeging; die gaat in `toevoeging`.",
                        "example": "1"
                    },
                    {
                        "name": "toevoeging",
                        "in": "query",
                        "required": false,
                        "description": "Huisletter en/of huisnummertoevoeging, bijv. `B`, `2` of `A-1`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Het adres met gebouw en buurt.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Gebouw"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/rdw/{kenteken}": {
            "get": {
                "tags": [
                    "Voertuig"
                ],
                "summary": "Voertuiggegevens op kenteken",
                "description": "Bron RDW Open Data. Kenteken met of zonder streepjes.",
                "operationId": "rdw",
                "parameters": [
                    {
                        "name": "kenteken",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "HP-R64-S"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Het voertuig.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Voertuig"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/weer/waarschuwingen": {
            "get": {
                "tags": [
                    "Weer"
                ],
                "summary": "Geldende weerwaarschuwingen",
                "description": "Alle waarschuwingen van het KNMI die nu gelden of nog komen, de ernstigste eerst. Sinds november 2026\ngeeft het KNMI geen codes per provincie meer, maar per waarschuwing een gebied. Met `geometrie=1` krijg\nje dat gebied als GeoJSON (MultiPolygon), bijvoorbeeld voor een kaart. Wil je weten of een waarschuwing\nop één plek geldt, gebruik dan `/v1/weer/{plaats}`: dat rekenen wij voor je uit.\n",
                "operationId": "weerwaarschuwingen",
                "parameters": [
                    {
                        "name": "geometrie",
                        "in": "query",
                        "required": false,
                        "description": "`1` = ook het gebied als GeoJSON (groot).",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "De waarschuwingen (een lege lijst als er geen zijn).",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "type": "object",
                                            "additionalProperties": false,
                                            "required": [
                                                "uitgegeven",
                                                "waarschuwingen"
                                            ],
                                            "properties": {
                                                "uitgegeven": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "format": "date-time",
                                                    "description": "Wanneer het KNMI deze stand uitgaf."
                                                },
                                                "waarschuwingen": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/Waarschuwing"
                                                    }
                                                }
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/weer/postcode/{postcode}": {
            "get": {
                "tags": [
                    "Weer"
                ],
                "summary": "Actueel weer bij een postcode",
                "description": "Zoals `/v1/weer/{plaats}`, maar voor het midden van een postcodegebied (zonder huisnummer).",
                "operationId": "weerPostcode",
                "parameters": [
                    {
                        "name": "postcode",
                        "in": "path",
                        "required": true,
                        "description": "Met of zonder spatie.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1012JS"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Het weer bij deze postcode.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Weer"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        },
        "/v1/weer/{plaats}": {
            "get": {
                "tags": [
                    "Weer"
                ],
                "summary": "Actueel weer in een plaats",
                "description": "De laatste metingen van het dichtstbijzijnde KNMI-station dat temperatuur en wind meet (stations op zee\ntellen niet mee), met de waarschuwingen die op deze plek gelden. Het KNMI meet elke 10 minuten; wij halen\nde metingen ook elke 10 minuten op. Komt een plaatsnaam vaker voor (Bergen), geef dan de provincie mee;\n`locatie` in het antwoord zegt welke plaats het is geworden.\n\nBron: KNMI (CC BY 4.0). Gebruik je de data in je eigen product, vermeld dan het KNMI als bron.\n",
                "operationId": "weer",
                "parameters": [
                    {
                        "name": "plaats",
                        "in": "path",
                        "required": true,
                        "description": "Woonplaats, bijv. `Utrecht` of `Den Haag`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Groningen"
                    },
                    {
                        "name": "provincie",
                        "in": "query",
                        "required": false,
                        "description": "Om te kiezen bij plaatsnamen die vaker voorkomen, bijv. `NH` of `Noord-Holland`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Het weer in deze plaats.",
                        "headers": {
                            "X-RateLimit-Remaining": {
                                "$ref": "#/components/headers/X-RateLimit-Remaining"
                            },
                            "X-Quota-Remaining": {
                                "$ref": "#/components/headers/X-Quota-Remaining"
                            }
                        },
                        "content": {
                            "application/json": {
                                "example": {
                                    "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
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "success",
                                        "data",
                                        "meta"
                                    ],
                                    "properties": {
                                        "success": {
                                            "const": true
                                        },
                                        "data": {
                                            "$ref": "#/components/schemas/Weer"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/OngeldigeInvoer"
                    },
                    "401": {
                        "$ref": "#/components/responses/SleutelOngeldig"
                    },
                    "403": {
                        "$ref": "#/components/responses/GeenToegang"
                    },
                    "404": {
                        "$ref": "#/components/responses/NietGevonden"
                    },
                    "429": {
                        "$ref": "#/components/responses/LimietBereikt"
                    },
                    "503": {
                        "$ref": "#/components/responses/BronOnbereikbaar"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "apiKey": {
                "type": "apiKey",
                "in": "header",
                "name": "X-API-Key",
                "description": "Begint met `nlapi_live_` (of `nlapi_test_` op test)."
            }
        },
        "headers": {
            "X-RateLimit-Limit": {
                "description": "Maximum aantal requests per minuut voor deze sleutel.",
                "schema": {
                    "type": "integer"
                }
            },
            "X-RateLimit-Remaining": {
                "description": "Requests die deze minuut nog over zijn.",
                "schema": {
                    "type": "integer"
                }
            },
            "X-Quota-Limit": {
                "description": "Maximum aantal requests per maand voor dit account.",
                "schema": {
                    "type": "integer"
                }
            },
            "X-Quota-Remaining": {
                "description": "Requests die deze maand nog over zijn.",
                "schema": {
                    "type": "integer"
                }
            },
            "Retry-After": {
                "description": "Seconden tot je het opnieuw kunt proberen.",
                "schema": {
                    "type": "integer"
                }
            }
        },
        "responses": {
            "OngeldigeInvoer": {
                "description": "Ongeldige invoer (`ongeldige_invoer`).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            },
            "SleutelOngeldig": {
                "description": "Geen sleutel (`sleutel_ontbreekt`) of een onbekende of ingetrokken sleutel (`sleutel_ongeldig`).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            },
            "GeenToegang": {
                "description": "Account geblokkeerd of e-mail niet bevestigd, of deze sleutel mag deze bron of dit IP-adres niet gebruiken (`geen_toegang`).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            },
            "NietGevonden": {
                "description": "Bestaat niet bij de bron (`niet_gevonden`).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            },
            "LimietBereikt": {
                "description": "Limiet per minuut of per maand bereikt (`limiet_bereikt`).",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/Retry-After"
                    }
                },
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            },
            "BronOnbereikbaar": {
                "description": "De bron is onbereikbaar of uitgeschakeld en we hebben geen eerdere versie (`bron_onbereikbaar`).",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/Retry-After"
                    }
                },
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Fout"
                        }
                    }
                }
            }
        },
        "schemas": {
            "Fout": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "success",
                    "error"
                ],
                "properties": {
                    "success": {
                        "const": false
                    },
                    "error": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "code",
                            "message"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "ongeldige_invoer",
                                    "sleutel_ontbreekt",
                                    "sleutel_ongeldig",
                                    "geen_toegang",
                                    "https_vereist",
                                    "niet_gevonden",
                                    "methode_niet_toegestaan",
                                    "limiet_bereikt",
                                    "interne_fout",
                                    "bron_onbereikbaar"
                                ]
                            },
                            "message": {
                                "type": "string"
                            }
                        }
                    }
                }
            },
            "Meta": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "bron",
                    "licentie",
                    "opgehaald",
                    "cache"
                ],
                "properties": {
                    "bron": {
                        "type": "string",
                        "examples": [
                            "BAG (PDOK)"
                        ]
                    },
                    "licentie": {
                        "type": "string",
                        "examples": [
                            "CC0"
                        ]
                    },
                    "opgehaald": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Wanneer we dit bij de bron ophaalden."
                    },
                    "cache": {
                        "type": "boolean",
                        "description": "Uit onze buffer (true) of net bij de bron opgehaald (false)."
                    },
                    "verouderd": {
                        "type": "boolean",
                        "description": "Alleen aanwezig (true) als de bron onbereikbaar is en dit de laatst bekende versie is."
                    }
                }
            },
            "Feestdag": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "datum",
                    "naam",
                    "algemeen_erkend",
                    "opmerking"
                ],
                "properties": {
                    "datum": {
                        "type": "string",
                        "format": "date"
                    },
                    "naam": {
                        "type": "string",
                        "examples": [
                            "Koningsdag"
                        ]
                    },
                    "algemeen_erkend": {
                        "type": "boolean",
                        "description": "Genoemd in de Algemene termijnenwet."
                    },
                    "opmerking": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            },
            "Schoolvakanties": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "schooljaar",
                    "regio",
                    "vakanties"
                ],
                "properties": {
                    "schooljaar": {
                        "type": "string",
                        "examples": [
                            "2025-2026"
                        ],
                        "description": "Loopt van augustus tot en met juli."
                    },
                    "regio": {
                        "type": "string",
                        "enum": [
                            "noord",
                            "midden",
                            "zuid"
                        ],
                        "description": "Regio-indeling van de Rijksoverheid."
                    },
                    "vakanties": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                                "naam",
                                "begindatum",
                                "einddatum",
                                "verplicht"
                            ],
                            "properties": {
                                "naam": {
                                    "type": "string",
                                    "examples": [
                                        "Herfstvakantie"
                                    ]
                                },
                                "begindatum": {
                                    "type": "string",
                                    "format": "date",
                                    "description": "Eerste vakantiedag (meestal een zaterdag)."
                                },
                                "einddatum": {
                                    "type": "string",
                                    "format": "date",
                                    "description": "Laatste vakantiedag (meestal een zondag)."
                                },
                                "verplicht": {
                                    "type": "boolean",
                                    "description": "false: adviesdata, scholen mogen afwijken."
                                }
                            }
                        }
                    }
                }
            },
            "Adres": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "straat",
                    "huisnummer",
                    "huisletter",
                    "huisnummertoevoeging",
                    "postcode",
                    "plaats",
                    "gemeente",
                    "provincie",
                    "lat",
                    "lon",
                    "nummeraanduiding_id",
                    "toevoegingen"
                ],
                "properties": {
                    "straat": {
                        "type": "string",
                        "description": "Straatnaam (openbare ruimte in de BAG)."
                    },
                    "huisnummer": {
                        "type": "integer"
                    },
                    "huisletter": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Eén letter, bijv. A in 12A."
                    },
                    "huisnummertoevoeging": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Toevoeging na het nummer, bijv. 2 in 12-2 of bis."
                    },
                    "postcode": {
                        "type": "string",
                        "pattern": "^[1-9][0-9]{3}[A-Z]{2}$",
                        "description": "Zonder spatie, hoofdletters."
                    },
                    "plaats": {
                        "type": "string",
                        "description": "Woonplaats volgens de BAG (kan afwijken van de gemeente)."
                    },
                    "gemeente": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "provincie": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "lat": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Breedtegraad (WGS84) van het adresseerbaar object, 6 decimalen."
                    },
                    "lon": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Lengtegraad (WGS84)."
                    },
                    "nummeraanduiding_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Vaste BAG-sleutel van dit adres. Blijft gelijk bij hernummering; handig om adressen op te slaan of te koppelen aan andere BAG-gegevens."
                    },
                    "toevoegingen": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Alle toevoegingen bij dit huisnummer (huisletter en toevoeging aan elkaar), leeg als er geen zijn."
                    }
                }
            },
            "Gebouw": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "adres",
                    "objecttype",
                    "adrestype",
                    "indeling",
                    "gebouw",
                    "kadaster",
                    "coordinaten",
                    "ids"
                ],
                "properties": {
                    "adres": {
                        "$ref": "#/components/schemas/Adres"
                    },
                    "objecttype": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "verblijfsobject",
                            "ligplaats",
                            "standplaats",
                            null
                        ],
                        "description": "Soort adresseerbaar object: een ruimte in een gebouw, een ligplaats (woonboot) of een standplaats (woonwagen)."
                    },
                    "adrestype": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "hoofdadres",
                            "nevenadres",
                            null
                        ],
                        "description": "Een object heeft één hoofdadres en soms nevenadressen."
                    },
                    "indeling": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "buurtcode",
                            "buurtnaam",
                            "wijkcode",
                            "wijknaam",
                            "gemeentecode",
                            "gemeente",
                            "provinciecode",
                            "provincieafkorting",
                            "provincie",
                            "waterschapscode",
                            "waterschap"
                        ],
                        "description": "Bestuurlijke indeling. Buurt- en wijkcodes zijn die van het CBS (koppelen aan CBS-cijfers); ze ontbreken soms bij nieuwe adressen.",
                        "properties": {
                            "buurtcode": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "BU0363AE02"
                                ]
                            },
                            "buurtnaam": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "wijkcode": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "WK0363AE"
                                ]
                            },
                            "wijknaam": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "gemeentecode": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "0363"
                                ],
                                "description": "Gemeentecode van vier cijfers."
                            },
                            "gemeente": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "provinciecode": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "PV27"
                                ]
                            },
                            "provincieafkorting": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "NH"
                                ]
                            },
                            "provincie": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "waterschapscode": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "waterschap": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        }
                    },
                    "gebouw": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": false,
                        "required": [
                            "gebruiksdoelen",
                            "oppervlakte",
                            "status",
                            "panden"
                        ],
                        "description": "Het verblijfsobject en de panden waarin het ligt. null bij een ligplaats of standplaats.",
                        "properties": {
                            "gebruiksdoelen": {
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "examples": [
                                        "woonfunctie",
                                        "winkelfunctie",
                                        "kantoorfunctie"
                                    ]
                                },
                                "description": "Gebruiksdoelen volgens de BAG."
                            },
                            "oppervlakte": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Gebruiksoppervlakte in m² volgens de BAG."
                            },
                            "status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "Verblijfsobject in gebruik"
                                ]
                            },
                            "panden": {
                                "type": "array",
                                "description": "Meestal één pand; een verblijfsobject kan in meer panden liggen.",
                                "items": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "required": [
                                        "id",
                                        "bouwjaar",
                                        "status",
                                        "aantal_verblijfsobjecten"
                                    ],
                                    "properties": {
                                        "id": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Pand-identificatie in de BAG."
                                        },
                                        "bouwjaar": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Jaar van oplevering van het pand."
                                        },
                                        "status": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "examples": [
                                                "Pand in gebruik"
                                            ]
                                        },
                                        "aantal_verblijfsobjecten": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Verblijfsobjecten in dit pand (bijv. appartementen)."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "kadaster": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "percelen",
                            "appartementsrechten"
                        ],
                        "properties": {
                            "percelen": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Kadastrale percelen onder het object, bijv. ASD04-F-6417."
                            },
                            "appartementsrechten": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Gekoppelde appartementsrechten, leeg als er geen zijn."
                            }
                        }
                    },
                    "coordinaten": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "lat",
                            "lon",
                            "rd_x",
                            "rd_y"
                        ],
                        "properties": {
                            "lat": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Breedtegraad (WGS84)."
                            },
                            "lon": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Lengtegraad (WGS84)."
                            },
                            "rd_x": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "X in Rijksdriehoekscoördinaten (EPSG:28992), in meters."
                            },
                            "rd_y": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Y in Rijksdriehoekscoördinaten."
                            }
                        }
                    },
                    "ids": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "nummeraanduiding_id",
                            "adresseerbaarobject_id",
                            "openbareruimte_id",
                            "woonplaats_id",
                            "pand_ids"
                        ],
                        "description": "Identificaties in de BAG, om te koppelen met andere bronnen.",
                        "properties": {
                            "nummeraanduiding_id": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "adresseerbaarobject_id": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Verblijfsobject, ligplaats of standplaats."
                            },
                            "openbareruimte_id": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "woonplaats_id": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "pand_ids": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            },
            "Voertuig": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "kenteken",
                    "voertuigsoort",
                    "merk",
                    "handelsbenaming",
                    "inrichting",
                    "eerste_kleur",
                    "tweede_kleur",
                    "datum_eerste_toelating",
                    "datum_eerste_tenaamstelling_in_nederland",
                    "vervaldatum_apk",
                    "aantal_zitplaatsen",
                    "aantal_deuren",
                    "aantal_cilinders",
                    "cilinderinhoud",
                    "massa_ledig_voertuig",
                    "massa_rijklaar",
                    "toegestane_maximum_massa_voertuig",
                    "maximum_massa_trekken_ongeremd",
                    "maximum_trekken_massa_geremd",
                    "catalogusprijs",
                    "bruto_bpm",
                    "europese_voertuigcategorie",
                    "zuinigheidsclassificatie",
                    "wam_verzekerd",
                    "openstaande_terugroepactie",
                    "export",
                    "taxi",
                    "tellerstandoordeel",
                    "brandstoffen"
                ],
                "properties": {
                    "kenteken": {
                        "type": "string",
                        "description": "Zonder streepjes, hoofdletters."
                    },
                    "voertuigsoort": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "merk": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "handelsbenaming": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Model zoals de fabrikant het noemt."
                    },
                    "inrichting": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "eerste_kleur": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "tweede_kleur": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "datum_eerste_toelating": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Eerste toelating op de weg, ook in het buitenland."
                    },
                    "datum_eerste_tenaamstelling_in_nederland": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "vervaldatum_apk": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Tot wanneer de APK geldig is."
                    },
                    "aantal_zitplaatsen": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "aantal_deuren": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "aantal_cilinders": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "cilinderinhoud": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In cm³."
                    },
                    "massa_ledig_voertuig": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In kg."
                    },
                    "massa_rijklaar": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In kg."
                    },
                    "toegestane_maximum_massa_voertuig": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In kg."
                    },
                    "maximum_massa_trekken_ongeremd": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In kg."
                    },
                    "maximum_trekken_massa_geremd": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In kg."
                    },
                    "catalogusprijs": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In euro."
                    },
                    "bruto_bpm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In euro."
                    },
                    "europese_voertuigcategorie": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Bijv. M1 (personenauto) of N1 (bestelauto)."
                    },
                    "zuinigheidsclassificatie": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "wam_verzekerd": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Is er een WA-verzekering geregistreerd?"
                    },
                    "openstaande_terugroepactie": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Staat er een terugroepactie open voor dit voertuig?"
                    },
                    "export": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Is het voertuig geëxporteerd?"
                    },
                    "taxi": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "tellerstandoordeel": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Oordeel van de RDW over de kilometerstand, bijv. Logisch."
                    },
                    "brandstoffen": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                                "brandstof",
                                "vermogen_kw",
                                "co2_gecombineerd_wltp",
                                "verbruik_gecombineerd_wltp",
                                "emissieniveau",
                                "hybride_klasse"
                            ],
                            "properties": {
                                "brandstof": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "vermogen_kw": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "co2_gecombineerd_wltp": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "In g/km."
                                },
                                "verbruik_gecombineerd_wltp": {
                                    "type": [
                                        "number",
                                        "null"
                                    ],
                                    "description": "In l/100 km."
                                },
                                "emissieniveau": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "hybride_klasse": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                }
                            }
                        }
                    }
                }
            },
            "Weer": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "locatie",
                    "station",
                    "gemeten",
                    "temperatuur",
                    "gevoelstemperatuur",
                    "dauwpunt",
                    "luchtvochtigheid",
                    "luchtdruk",
                    "wind",
                    "neerslag",
                    "zicht",
                    "bewolking",
                    "weer",
                    "waarschuwingen"
                ],
                "properties": {
                    "locatie": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "naam",
                            "postcode",
                            "gemeente",
                            "provincie",
                            "lat",
                            "lon"
                        ],
                        "description": "De plaats of postcode zoals wij die vonden (controleer bij plaatsnamen die vaker voorkomen).",
                        "properties": {
                            "naam": {
                                "type": "string",
                                "description": "Woonplaats."
                            },
                            "postcode": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Alleen bij /v1/weer/postcode/{postcode}."
                            },
                            "gemeente": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "provincie": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "lat": {
                                "type": "number"
                            },
                            "lon": {
                                "type": "number"
                            }
                        }
                    },
                    "station": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "id",
                            "naam",
                            "lat",
                            "lon",
                            "afstand_km"
                        ],
                        "description": "Het KNMI-station waar de metingen vandaan komen.",
                        "properties": {
                            "id": {
                                "type": "string",
                                "description": "WMO-nummer, bijv. 06260 (De Bilt)."
                            },
                            "naam": {
                                "type": "string"
                            },
                            "lat": {
                                "type": "number"
                            },
                            "lon": {
                                "type": "number"
                            },
                            "afstand_km": {
                                "type": "number",
                                "description": "Afstand tot de gevraagde plek."
                            }
                        }
                    },
                    "gemeten": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Tijd van de meting (elke 10 minuten)."
                    },
                    "temperatuur": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "In °C, op 1,5 m hoogte."
                    },
                    "gevoelstemperatuur": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "In °C: windchill bij 10 °C of kouder en wind, anders gelijk aan de temperatuur."
                    },
                    "dauwpunt": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "In °C."
                    },
                    "luchtvochtigheid": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Relatieve luchtvochtigheid in %."
                    },
                    "luchtdruk": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Op zeeniveau, in hPa."
                    },
                    "wind": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "snelheid",
                            "snelheid_kmh",
                            "beaufort",
                            "richting",
                            "richting_graden",
                            "windstoten"
                        ],
                        "properties": {
                            "snelheid": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Gemiddeld over 10 minuten, in m/s."
                            },
                            "snelheid_kmh": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "beaufort": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "0 tot en met 12."
                            },
                            "richting": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Waar de wind vandaan komt: N, NNO, NO, … (16 richtingen)."
                            },
                            "richting_graden": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "windstoten": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Hoogste windstoot in de afgelopen 10 minuten, in m/s."
                            }
                        }
                    },
                    "neerslag": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "intensiteit",
                            "laatste_uur"
                        ],
                        "properties": {
                            "intensiteit": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Nu, in mm per uur."
                            },
                            "laatste_uur": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Gevallen in het afgelopen uur, in mm."
                            }
                        }
                    },
                    "zicht": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In meter."
                    },
                    "bewolking": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "In achtsten (okta): 0 = onbewolkt, 8 = geheel bewolkt, 9 = lucht onzichtbaar (bijv. mist)."
                    },
                    "weer": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": false,
                        "required": [
                            "code",
                            "omschrijving"
                        ],
                        "description": "Het weertype; niet elk station meet dit.",
                        "properties": {
                            "code": {
                                "type": "integer",
                                "description": "WMO-codetabel 4680."
                            },
                            "omschrijving": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "examples": [
                                    "lichte regen"
                                ]
                            }
                        }
                    },
                    "waarschuwingen": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "description": "Waarschuwingen die nu of later op deze plek gelden (leeg = geen); null als ze tijdelijk niet beschikbaar zijn.",
                        "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                                "fenomeen",
                                "kleur",
                                "kop",
                                "omschrijving",
                                "begint",
                                "eindigt",
                                "gevolgen",
                                "advies"
                            ],
                            "properties": {
                                "fenomeen": {
                                    "type": "string"
                                },
                                "kleur": {
                                    "type": "string",
                                    "examples": [
                                        "geel",
                                        "oranje",
                                        "rood"
                                    ]
                                },
                                "kop": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "omschrijving": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "begint": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time"
                                },
                                "eindigt": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time"
                                },
                                "gevolgen": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "advies": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                }
                            }
                        }
                    }
                }
            },
            "Waarschuwing": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "fenomeen",
                    "fenomeen_code",
                    "kleur",
                    "ernst",
                    "type",
                    "kop",
                    "omschrijving",
                    "toelichting",
                    "gebied",
                    "begint",
                    "eindigt",
                    "kans",
                    "zekerheid",
                    "gevolgen",
                    "advies"
                ],
                "properties": {
                    "fenomeen": {
                        "type": "string",
                        "examples": [
                            "mist",
                            "onweer",
                            "windstoten",
                            "gladheid"
                        ]
                    },
                    "fenomeen_code": {
                        "type": "string",
                        "description": "Zoals het KNMI het noemt, bijv. fog."
                    },
                    "kleur": {
                        "type": "string",
                        "examples": [
                            "geel",
                            "oranje",
                            "rood"
                        ]
                    },
                    "ernst": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "examples": [
                            "matig",
                            "ernstig",
                            "extreem"
                        ]
                    },
                    "type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "examples": [
                            "waarschuwing"
                        ]
                    },
                    "kop": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "omschrijving": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "toelichting": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "gebied": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "In woorden, bijv. \"Noord-Nederland en delen van: Flevoland en Overijssel\"."
                    },
                    "begint": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "eindigt": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "kans": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Kans in procenten, bijv. \"60-90\"."
                    },
                    "zekerheid": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "examples": [
                            "waarschijnlijk"
                        ]
                    },
                    "gevolgen": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "advies": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "geometrie": {
                        "type": "object",
                        "description": "Alleen met geometrie=1. GeoJSON (Multi)Polygon met [lon, lat].",
                        "required": [
                            "type",
                            "coordinates"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "Polygon",
                                    "MultiPolygon"
                                ]
                            },
                            "coordinates": {
                                "type": "array"
                            }
                        }
                    }
                }
            },
            "StatusAntwoord": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                    "success",
                    "data"
                ],
                "properties": {
                    "success": {
                        "const": true
                    },
                    "data": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                            "status",
                            "versie",
                            "tijd",
                            "onderdelen"
                        ],
                        "properties": {
                            "status": {
                                "type": "string",
                                "enum": [
                                    "ok",
                                    "verstoord"
                                ]
                            },
                            "versie": {
                                "type": "string"
                            },
                            "tijd": {
                                "type": "string",
                                "format": "date-time"
                            },
                            "onderdelen": {
                                "type": "object",
                                "additionalProperties": false,
                                "required": [
                                    "database"
                                ],
                                "properties": {
                                    "database": {
                                        "type": "string",
                                        "enum": [
                                            "ok",
                                            "fout"
                                        ]
                                    },
                                    "bronnen": {
                                        "type": "object",
                                        "additionalProperties": {
                                            "type": "object",
                                            "additionalProperties": false,
                                            "required": [
                                                "status",
                                                "laatst_opgehaald"
                                            ],
                                            "properties": {
                                                "status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "ok",
                                                        "verstoord",
                                                        "storing",
                                                        "uitgeschakeld"
                                                    ]
                                                },
                                                "laatst_opgehaald": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "format": "date-time"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}