{"openapi":"3.0.2","info":{"title":"KadastraleKaart.com API v2","version":"2.0.0-preview","contact":{"name":"Support","url":"https://kadastralekaart.com/support"},"description":"API v2 is in ontwikkeling en groepeert endpoints per informatieproduct in plaats van per databron:\néén sectie per product (Eigendomsinformatie, Hypotheekinformatie, Optop), elk met zijn eigen\n`/percelen/{perceel_id}/...`-endpoint. Daarnaast is er een Zoeken API om eerst het juiste\n`perceel_id` of `adres_id` te vinden. De onderliggende producten bestaan nog niet — elk endpoint\nhieronder geeft voorlopig placeholderdata terug.\n\n# Authenticatie\n\nElk verzoek heeft een `X-Api-Key`-header nodig. In v1 ging dit via een `apiKey`-queryparameter —\nv2 gebruikt in plaats daarvan een header.\n\n```bash\ncurl -H \"X-Api-Key: YOUR_API_KEY\" \"https://kadastralekaart.com/public/v2/percelen/ASD40-C-123/eigendomsinformatie\"\n```\n\n# Support\n\n[Support](https://kadastralekaart.com/support)\n\n# Prijzen\n\n[Prijzen](https://kadastralekaart.com/upgrade/prijzen)\n\n# Demo inplannen\n\n[Demo inplannen](https://kadastralekaart.com/demo)"},"servers":[{"url":"/public/v2"}],"tags":[{"name":"Eigendomsinformatie API","description":"Weet direct wie u moet benaderen. Eén call geeft de actuele eigenaar van een perceel of adres, met aankoopdatum en koopsom — zonder dat u per dossier een uittreksel hoeft op te vragen. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Hypotheekinformatie API","description":"Zie hoe een object gefinancierd is voordat u een bod of dossier onderbouwt: hypotheekhouder, hypotheekbedrag en vestigingsdatum, direct in uw eigen systeem. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Indicatie Eigenaar API","description":"Filter duizenden percelen vóórdat u betaalt voor volledige eigendomsinformatie. U ziet met wat voor type eigenaar u te maken heeft en zoekt alleen de kansrijke dossiers verder uit. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Voorkeursrecht API","description":"Voorkom dat u tijd steekt in locaties die u niet kunt verwerven. Zie per perceel — of in één keer voor een hele gemeente — waar een voorkeursrecht is gevestigd. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Optop API","description":"Vind verdichtingskansen zonder eerst een quickscan te laten doen. U ziet hoeveel bouwvolume er boven een pand beschikbaar is, en waarom niet als dat er niet is. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Perceelbedekking API","description":"Beoordeel een locatie op verharding, bebouwing en groen zonder de luchtfoto handmatig na te meten. Bruikbaar voor klimaatadaptatie, waterberging en zonpotentie. Let op: op dit endpoint zijn kosten van toepassing."},{"name":"Kaartmateriaal API","description":"Lever uw klant een kaartbeeld van professionele kwaliteit zonder zelf een kaartlaag te bouwen: luchtfoto, kadastrale kaart en de markering van het perceel, in één afbeelding."},{"name":"Zoeken API","description":"Hier begint elke integratie. Zoek op postcode, adres of kadastrale aanduiding en krijg het `perceel_id` of `adres_id` waarmee u alle andere endpoints bevraagt."},{"name":"Perceelkenmerken API","description":"Het fundament onder uw eigen applicatie: oppervlakte, ligging en geometrie van een perceel, landelijk dekkend en dagelijks bijgewerkt."},{"name":"MCP-server API","description":"Koppel een MCP-compatibele AI-assistent rechtstreeks aan de KadastraleKaart-data, zonder zelf tooldefinities te schrijven. In ontwikkeling — het endpoint geeft voorlopig een 501 terug."},{"name":"Agent skill API","description":"Een kant-en-klare skill die uw agent vertelt wanneer hij welk endpoint moet aanroepen, inclusief voorbeelden."},{"name":"Adreskenmerken API","description":"Alles wat de BAG over een adres weet, al gekoppeld aan het perceel waar het op ligt. Eén call in plaats van drie bronnen aan elkaar knopen."}],"x-tagGroups":[{"name":"Zoeken","tags":["Zoeken API"]},{"name":"Eigendom & Financieel","tags":["Eigendomsinformatie API","Hypotheekinformatie API","Indicatie Eigenaar API"]},{"name":"Ruimtelijk & Juridisch","tags":["Voorkeursrecht API","Optop API","Perceelbedekking API"]},{"name":"Kaartmateriaal","tags":["Kaartmateriaal API"]},{"name":"Perceeldata","tags":["Perceelkenmerken API"]},{"name":"Adresdata","tags":["Adreskenmerken API"]},{"name":"AI-integraties","tags":["MCP-server API","Agent skill API"]}],"paths":{"/adressen/{adres_id}":{"get":{"operationId":"getAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Adreskenmerken API"],"summary":"Vraag de kenmerken van een adres op","description":"Het fundament van een adres: de basisgegevens en positie (GeoJSON in WGS84), het pand waarin het ligt, het perceel waar het op staat, en een overzicht van de informatieproducten die voor adressen bestaan — inclusief of elk product nu beschikbaar is. Dit endpoint is gratis: er wordt niets besteld of gefactureerd.\n","parameters":[{"$ref":"#/components/parameters/adres_id"}],"responses":{"200":{"description":"De kenmerken van het adres. `gebouw` is `null` als het adres niet aan een pand gekoppeld is.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdresDetail"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"}}}},"/adressen/{adres_id}/eigendomsinformatie":{"get":{"operationId":"getEigendomsinformatieVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Eigendomsinformatie API"],"summary":"Vraag eigendomsinformatie op voor een adres","description":"Geeft de actuele eigendomssituatie van dit adres zoals bekend bij het Kadaster: zakelijk gerechtigden, tenaamstellingen, de onderliggende stukken en de koopsom.\nWelk kadastraal object bevraagd wordt hangt af van het adres. Staat het adres op een appartementsrecht — een woning in een gesplitst gebouw — dan gaat de eigendomsinformatie over dát appartementsrecht, en dus over de eigenaar van deze woning. Staat het adres niet op een appartementsrecht, dan gaat het over het perceel waar het adres op staat. `perceel` in de response vertelt welke van de twee het is: een appartementsrecht heeft een `kadastraleAanduiding` met een appartementsindex erachter (`ASD40-C-123-A-1`).\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `adres_id`.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De eigendomssituatie van het appartementsrecht of het perceel van dit adres, ingedeeld op soort recht: `eigenaren` (recht van eigendom), `erfpachters` (recht van erfpacht) en `andereGerechtigden` voor alle overige zakelijke rechten. Elke gerechtigde staat er één keer per aandeel in, met de stukken waarmee hij het recht verkreeg.\nDaarnaast: `perceel` met de kadastrale gegevens, `koopsom`, `aantekeningen` (beslagen, kwalitatieve verplichtingen, Wvg-koopovereenkomsten), `appartementsrechtSplitsingen` en `peilmoment` — tot welk moment de gegevens bijgewerkt zijn. Roep het endpoint aan met `test=true` voor een gevulde voorbeeldresponse.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EigendomsinformatieAdres"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen/{adres_id}/hypotheekinformatie":{"get":{"operationId":"getHypotheekinformatieVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Hypotheekinformatie API"],"summary":"Vraag hypotheekinformatie op voor een adres","description":"Geeft de hypotheken die op dit adres rusten zoals bekend bij het Kadaster: per hypotheek het bedrag waarvoor hij is ingeschreven, de hypotheekhouder en het onderliggende stuk.\nWelk kadastraal object bevraagd wordt hangt af van het adres, net als bij `/adressen/{adres_id}/eigendomsinformatie`. Staat het adres op een appartementsrecht — een woning in een gesplitst gebouw — dan gaan de hypotheken over dát appartementsrecht, en dus over de hypotheek op deze woning. Staat het adres niet op een appartementsrecht, dan gaat het over het perceel waar het adres op staat. `perceel` in de response vertelt welke van de twee het is: een appartementsrecht heeft een `kadastraleAanduiding` met een appartementsindex erachter (`ASD40-C-123-A-1`).\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `adres_id`.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De hypotheeksituatie van het appartementsrecht of het perceel van dit adres. `hypotheken` is leeg als er geen hypotheek op rust. Daarnaast: `perceel` met de kadastrale gegevens en `peilmoment` — tot welk moment de gegevens bijgewerkt zijn. Roep het endpoint aan met `test=true` voor een gevulde voorbeeldresponse.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HypotheekinformatieAdres"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen/{adres_id}/perceelbedekking":{"get":{"operationId":"getPerceelbedekkingVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Perceelbedekking API"],"summary":"Vraag perceelbedekking op voor een adres","description":"Geeft de fysieke bedekking van het perceel waar dit adres op staat, volgens de Basisregistratie Grootschalige Topografie (BGT): welk deel bebouwing, verharding, groen, water of onverhard is, zowel op hoofdcategorie als op BGT-detailtype. Hetzelfde antwoord als `/percelen/{perceel_id}/perceelbedekking` voor het perceel van dit adres.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `adres_id`.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De perceelbedekking van het perceel van dit adres, ingedeeld op `bedekkingHoofdcategorie` (vijf categorieën) en `bedekkingDetail` (elf BGT-detailtypen). Beide lijsten bevatten altijd alle categorieën resp. typen, ook als een categorie of type niet op het perceel voorkomt — dan met een oppervlakte en percentage van 0 en een lege geometrie.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerceelbedekkingAdres"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen/{adres_id}/optopanalyse":{"get":{"operationId":"getOptopanalyseVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Optop API"],"summary":"Vraag een optopanalyse op voor een adres","description":"Geeft dezelfde optopanalyse als `/percelen/{perceel_id}/optopanalyse` voor het perceel waar dit adres op staat: een samenvatting op perceelniveau, de 2D-geometrie van het perceel, per pand op het perceel de belangrijkste kenmerken, geometrie en het theoretisch optop-volume, en de bouwvlakken waarop de planologische bouw- en goothoogte zijn gebaseerd. Bevat ook de basisgegevens van het adres zelf.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `adres_id`.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De optopanalyse van het perceel van dit adres, plus de basisgegevens van het adres zelf.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptopanalyseAdres"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen/{adres_id}/indicatie-eigenaar":{"get":{"operationId":"getIndicatieEigenaarVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Indicatie Eigenaar API"],"summary":"Vraag een indicatie van de eigenaar op voor een adres","description":"Geeft een indicatie van het type eigenaar van het perceel waar dit adres op staat, op de beschikbare peildata, plus of er sinds 2020 een kadastrale transactie op dat perceel heeft plaatsgevonden. Bevat ook de basisgegevens van het adres zelf.\nLet op: is het perceel kadastraal gesplitst in appartementsrechten, dan is dit de indicatie eigenaar van het hele perceel — niet van het specifieke appartementsrecht van dit adres.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `adres_id`.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De indicatie eigenaar van het perceel van dit adres, plus de basisgegevens van het adres zelf.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndicatieEigenaarAdres"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen/{adres_id}/kaartmateriaal":{"get":{"operationId":"getKaartmateriaalVoorAdres","security":[{"apiKeyAuthentication":[]}],"tags":["Kaartmateriaal API"],"summary":"Vraag kaartmateriaal op voor een adres","description":"Geeft een kant-en-klare kaartafbeelding van het perceel waar dit adres op staat: de actuele luchtfoto als ondergrond, daarover de kadastrale kaart en bovenop de markering van dat perceel. De afbeelding is altijd tweemaal zo breed als hoog.\nDe kaart gaat over het hele perceel, niet over het adres alleen — staan er meer adressen op het perceel, dan geven die dus dezelfde afbeelding.\nAnders dan de meeste `/adressen/...`-endpoints geeft dit endpoint geen JSON terug maar de afbeelding zelf, in het formaat dat `formaat` aangeeft — en dus, anders dan bij de andere `/adressen/{adres_id}/...`-endpoints, ook geen adresgegevens (`adresId`, `straatnaam`, ...) erbij.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd de kaart van hetzelfde voorbeeldperceel terug (`ASD40-C-123`), ongeacht het opgegeven `adres_id`. `formaat`, `breedte`, `alleenRand` en `marge` werken onder `test=true` gewoon.\n","parameters":[{"$ref":"#/components/parameters/adres_id"},{"$ref":"#/components/parameters/formaat"},{"$ref":"#/components/parameters/breedte"},{"$ref":"#/components/parameters/alleenRand"},{"$ref":"#/components/parameters/marge"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De kaartafbeelding.","content":{"image/webp":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/mcp":{"get":{"security":[{"apiKeyAuthentication":[]}],"tags":["MCP-server API"],"summary":"Verbind een AI-assistent rechtstreeks met de KadastraleKaart-data","description":"Nog niet live — dit endpoint kondigt de MCP-server aan die op dit pad komt te staan en geeft voorlopig een 501 terug. Straks koppelt u hier een MCP-compatibele assistent aan, zonder zelf tooldefinities te schrijven.\n","responses":{"501":{"description":"Nog niet geïmplementeerd","content":{"application/json":{"schema":{"type":"object"},"example":{"resource":"mcp","description":"MCP-server voor de KadastraleKaart API.","status":"placeholder","message":"Dit endpoint is nog niet geïmplementeerd — v2 is in ontwikkeling."}}}}}}},"/skill":{"get":{"security":[{"apiKeyAuthentication":[]}],"tags":["Agent skill API"],"summary":"Haal de kant-en-klare agent skill op","description":"Geeft een kant-en-klare skill in het SKILL.md-formaat (YAML-frontmatter + markdown) terug: instructies en voorbeelden die een AI-agent vertellen wanneer hij welk endpoint van deze API moet aanroepen, inclusief het onderscheid tussen gratis kenmerken-endpoints en betaalde informatieproducten. Sla de response rechtstreeks op als `SKILL.md` in een skill-compatibele agent, of laad hem als systeeminstructie.\n","responses":{"200":{"description":"De agent skill, als platte tekst in SKILL.md-formaat.","content":{"text/markdown":{"schema":{"type":"string"},"example":"---\nname: kadastralekaart-api\ndescription: 'Zoek Nederlandse kadastrale en BAG-gegevens op via de publieke KadastraleKaart.com API v2.'\n---\n\n# KadastraleKaart API v2\n...\n"}}}}}},"/gemeenten/{gemeentecode}/voorkeursrecht":{"get":{"operationId":"getVoorkeursrechtVoorGemeente","security":[{"apiKeyAuthentication":[]}],"tags":["Voorkeursrecht API"],"summary":"Vraag alle percelen met voorkeursrecht op binnen een gemeente","description":"Geeft alle voorkeursrechten (Wet voorkeursrecht gemeenten) op percelen binnen een gemeente, als één platte lijst — een perceel met meerdere voorkeursrechten levert meerdere entries op, elk met zijn eigen `perceelId`.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht de opgegeven `gemeentecode`.\n","parameters":[{"$ref":"#/components/parameters/gemeentecode"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De voorkeursrechten binnen de gemeente. Een lege lijst betekent dat het Kadaster er geen kent.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GemeenteVoorkeursrecht"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}":{"get":{"operationId":"getPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Perceelkenmerken API"],"summary":"Vraag de kenmerken van een perceel op","description":"Het fundament van een perceel: kadastrale identiteit, oppervlakte en geometrie (GeoJSON in WGS84), de adressen en panden die erop staan, en een overzicht van alle informatieproducten die voor percelen bestaan — inclusief of elk product specifiek voor dít perceel beschikbaar is. Dit endpoint is gratis: er wordt niets besteld of gefactureerd.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"}],"responses":{"200":{"description":"De kenmerken van het perceel. `adressen` en `gebouwen` zijn leeg als het perceel geen adressen resp. panden heeft — nooit weggelaten.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerceelDetail"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"}}}},"/percelen/{perceel_id}/eigendomsinformatie":{"get":{"operationId":"getEigendomsinformatieVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Eigendomsinformatie API"],"summary":"Vraag eigendomsinformatie op voor een perceel","description":"Geeft de actuele eigendomssituatie van een perceel zoals bekend bij het Kadaster: zakelijk gerechtigden, tenaamstellingen, de onderliggende stukken en de koopsom.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De eigendomssituatie van het perceel, ingedeeld op soort recht: `eigenaren` (recht van eigendom), `erfpachters` (recht van erfpacht) en `andereGerechtigden` voor alle overige zakelijke rechten. Elke gerechtigde staat er één keer per aandeel in, met de stukken waarmee hij het recht verkreeg.\nDaarnaast: `perceel` met de kadastrale gegevens, `koopsom`, `aantekeningen` (beslagen, kwalitatieve verplichtingen, Wvg-koopovereenkomsten), `appartementsrechtSplitsingen` en `peilmoment` — tot welk moment de gegevens bijgewerkt zijn. Roep het endpoint aan met `test=true` voor een gevulde voorbeeldresponse.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Eigendomsinformatie"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/hypotheekinformatie":{"get":{"operationId":"getHypotheekinformatieVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Hypotheekinformatie API"],"summary":"Vraag hypotheekinformatie op voor een perceel","description":"Geeft de hypotheken die op een perceel rusten zoals bekend bij het Kadaster: per hypotheek het bedrag waarvoor hij is ingeschreven, de hypotheekhouder en het onderliggende stuk.\nLet op: is het perceel kadastraal gesplitst in appartementsrechten, dan zijn dit de hypotheken op het grondperceel — niet die op de losse appartementen. Gebruik `/adressen/{adres_id}/hypotheekinformatie` om de hypotheek van één woning op te vragen.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De hypotheeksituatie van het perceel. `hypotheken` is leeg als er geen hypotheek op rust. Elke entry heeft het bedrag waarvoor de hypotheek is ingeschreven — dat is de inschrijving, niet de restschuld — plus de hypotheekhouders en het stuk waarmee hij is gevestigd. Daarnaast: `perceel` met de kadastrale gegevens en `peilmoment`, tot welk moment de gegevens bijgewerkt zijn. Roep het endpoint aan met `test=true` voor een gevulde voorbeeldresponse.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hypotheekinformatie"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/optopanalyse":{"get":{"operationId":"getOptopanalyseVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Optop API"],"summary":"Vraag een optopanalyse op voor een perceel","description":"Geeft een optopanalyse van een perceel: een samenvatting op perceelniveau (bebouwingspercentage, uitbreidingsvolume, stedenbouwkundige indices en de planologisch maximale bouw- en goothoogte), de 2D-geometrie van het perceel, per pand op het perceel de belangrijkste kenmerken, geometrie en het theoretisch optop-volume, en de bouwvlakken uit het bestemmingsplan waarop de planologische bouw- en goothoogte zijn gebaseerd.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De optopanalyse van het perceel: `samenvatting` op perceelniveau, `gebouwen` met één entry per pand (inclusief geometrie) en `bouwvlakken` met de onderliggende bestemmingsplan-vlakken en hun bouw-/goothoogtewaarden. Een perceel zonder panden levert een lege `gebouwen`-lijst en een `aantalGebouwen` van 0 op.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Optopanalyse"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/voorkeursrecht":{"get":{"operationId":"getVoorkeursrechtVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Voorkeursrecht API"],"summary":"Vraag voorkeursrecht-informatie op voor een perceel","description":"Geeft de voorkeursrechten (Wet voorkeursrecht gemeenten) die op een perceel rusten of hebben gerust: per voorkeursrecht de start- en einddatum, de bijbehorende besluitdocumenten en een status die is afgeleid van die data.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De voorkeursrechten van het perceel. Een lege lijst betekent dat het Kadaster er geen kent.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Voorkeursrecht"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/indicatie-eigenaar":{"get":{"operationId":"getIndicatieEigenaarVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Indicatie Eigenaar API"],"summary":"Vraag een indicatie van de eigenaar op voor een perceel","description":"Geeft een indicatie van het type eigenaar van een perceel (bijvoorbeeld een natuurlijk persoon, een bedrijf of een publiekrechtelijke partij) op de beschikbare peildata, plus of er sinds 2020 een kadastrale transactie op het perceel heeft plaatsgevonden.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De indicatie eigenaar van het perceel: `eigendomstypeIndicatie` per beschikbare peildatum, en `gewijzigdSinds2020`/`laatsteWijziging` op basis van de laatst bekende kadastrale transactie.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndicatieEigenaar"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/perceelbedekking":{"get":{"operationId":"getPerceelbedekkingVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Perceelbedekking API"],"summary":"Vraag perceelbedekking op voor een perceel","description":"Geeft de fysieke bedekking van een perceel volgens de Basisregistratie Grootschalige Topografie (BGT): welk deel bebouwing, verharding, groen, water of onverhard is, zowel op hoofdcategorie als op BGT-detailtype.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd dezelfde voorbeeldresponse terug, ongeacht het opgegeven `perceel_id`.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De perceelbedekking, ingedeeld op `bedekkingHoofdcategorie` (vijf categorieën) en `bedekkingDetail` (elf BGT-detailtypen). Beide lijsten bevatten altijd alle categorieën resp. typen, ook als een categorie of type niet op het perceel voorkomt — dan met een oppervlakte en percentage van 0 en een lege geometrie.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Perceelbedekking"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen/{perceel_id}/kaartmateriaal":{"get":{"operationId":"getKaartmateriaalVoorPerceel","security":[{"apiKeyAuthentication":[]}],"tags":["Kaartmateriaal API"],"summary":"Vraag kaartmateriaal op voor een perceel","description":"Geeft een kant-en-klare kaartafbeelding van het perceel terug: de actuele luchtfoto als ondergrond, daarover de kadastrale kaart en bovenop de markering van dít perceel. De afbeelding is altijd tweemaal zo breed als hoog.\nAnders dan de meeste `/percelen/...`-endpoints geeft dit endpoint geen JSON terug maar de afbeelding zelf, in het formaat dat `formaat` aangeeft.\nLet op: op dit endpoint zijn kosten van toepassing — elke aanroep levert een bestelling op die op uw account wordt gefactureerd. Gebruik `test=true` om de vorm van de response te bekijken zonder kosten; dat geeft altijd de kaart van hetzelfde voorbeeldperceel terug (`ASD40-C-123`), ongeacht het opgegeven `perceel_id`. `formaat`, `breedte`, `alleenRand` en `marge` werken onder `test=true` gewoon.\n","parameters":[{"$ref":"#/components/parameters/perceel_id"},{"$ref":"#/components/parameters/formaat"},{"$ref":"#/components/parameters/breedte"},{"$ref":"#/components/parameters/alleenRand"},{"$ref":"#/components/parameters/marge"},{"$ref":"#/components/parameters/test"}],"responses":{"200":{"description":"De kaartafbeelding.","content":{"image/webp":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"}}}},"/percelen":{"get":{"operationId":"zoekPercelen","security":[{"apiKeyAuthentication":[]}],"tags":["Zoeken API"],"summary":"Zoek percelen","description":"Doorzoekt alle percelen op vrije tekst en geeft resultaten terug, elk met een relevantiescore. `perceelId` uit een resultaat is direct te gebruiken bij de andere `/percelen/{perceel_id}/...`-endpoints.\n","parameters":[{"$ref":"#/components/parameters/q"}],"responses":{"200":{"description":"Gevonden percelen, gesorteerd op score (hoog naar laag). Een leeg `resultaten` betekent geen match.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PercelenZoeken"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"}}}},"/adressen":{"get":{"operationId":"zoekAdressen","security":[{"apiKeyAuthentication":[]}],"tags":["Zoeken API"],"summary":"Zoek adressen","description":"Doorzoekt alle adressen op vrije tekst en geeft resultaten terug, elk met een relevantiescore. `adresId` uit een resultaat is direct te gebruiken bij de andere `/adressen/{adres_id}/...`-endpoints.\n","parameters":[{"$ref":"#/components/parameters/q"}],"responses":{"200":{"description":"Gevonden adressen, gesorteerd op score (hoog naar laag). Een leeg `resultaten` betekent geen match.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdressenZoeken"}}}},"400":{"$ref":"#/components/responses/400"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"}}}}},"components":{"securitySchemes":{"apiKeyAuthentication":{"type":"apiKey","name":"X-Api-Key","in":"header"}},"responses":{"400":{"description":"Een pad- of queryparameter is onbruikbaar, of een bestelregel wees de aanvraag af. `message` is altijd één leesbare regel. Bij parametervalidatie staat elke fout ook los onder `details`, met `field` erbij als de fout bij een specifieke parameter hoort.\n","content":{"application/json":{"schema":{"type":"object"},"example":{"code":400,"error":"bad_request_error","message":"perceel_id moet {kadastralegemeentecode}-{sectie}-{perceelnummer}, {kadastralegemeentenaam}-{sectie}-{perceelnummer} of een lokaalid zijn — bijvoorbeeld ASD40-C-123, Amsterdam-C-123 of 11010156070000.","details":[{"message":"perceel_id moet {kadastralegemeentecode}-{sectie}-{perceelnummer}, {kadastralegemeentenaam}-{sectie}-{perceelnummer} of een lokaalid zijn — bijvoorbeeld ASD40-C-123, Amsterdam-C-123 of 11010156070000."}]}}}},"403":{"description":"De `X-Api-Key`-header mist, is geen geldige sleutel, is verlopen of nog niet actief, hoort bij v1 van de API, of de organisatie heeft geen API-abonnement.\nEen sleutel werkt op één versie: sleutels die vóór de introductie van v2 zijn aangemaakt op v1, sleutels die daarna zijn aangemaakt op v2. Maak in de klantomgeving een nieuwe sleutel aan om v2 te gebruiken.\n","content":{"application/json":{"schema":{"type":"object"},"example":{"code":403,"error":"Forbidden","message":"API-key is niet geldig."}}}},"404":{"description":"Het opgevraagde object bestaat niet (`PerceelNotFoundError`), of het product zit niet in het abonnement van deze organisatie (`ProductNotFoundError`). `error` maakt het verschil.\n","content":{"application/json":{"schema":{"type":"object"},"example":{"code":404,"error":"PerceelNotFoundError","message":"Er is geen perceel met perceel_id 'ASD40-C-999'. De identifier zelf is goed opgebouwd, dus een perceel met deze gegevens bestaat niet — controleer de gemeente, sectie en het perceelnummer."}}}},"429":{"description":"De inbegrepen opvragingen van de bundel zijn voor deze maand op en de bundel rekent geen extra opvragingen af. Een grotere bundel of een nieuwe kalendermaand geeft weer toegang; op een bundel mét een tarief voor extra opvragingen komt deze status niet voor.\n","content":{"application/json":{"schema":{"type":"object"},"example":{"code":429,"error":"TooManyRequests","message":"De 50000 inbegrepen opvragingen van uw bundel zijn deze maand verbruikt. Kies een grotere bundel op https://kadastralekaart.com/api om verder te gaan."}}}}},"parameters":{"perceel_id":{"name":"perceel_id","description":"Identifier van het perceel. Drie vormen worden geaccepteerd: * `{kadastralegemeentecode}-{sectie}-{perceelnummer}` — bijvoorbeeld `ASD40-C-123`. * `{kadastralegemeentenaam}-{sectie}-{perceelnummer}` — bijvoorbeeld `Amsterdam-C-123`.\n  Namen met een streepje erin (`Berkel-Enschot-C-123`) werken ook.\n* `lokaalid` — de kadastrale objectidentificatie, bijvoorbeeld `11010156070000`.\n","in":"path","required":true,"schema":{"type":"string"},"example":"ASD40-C-123"},"adres_id":{"name":"adres_id","description":"Adres-ID (Nummeraanduidingidentificatie) uit de BAG. Dit is een string van 16 tekens — let op dat er geen voorloopnullen wegvallen.\n","in":"path","required":true,"schema":{"type":"string"},"example":"0344200000077001"},"test":{"name":"test","description":"Zet op `true` om een vaste voorbeeldresponse te krijgen zonder dat er iets besteld of gefactureerd wordt. Handig tijdens het bouwen van een integratie. Staat in deze documentatie standaard aan, zodat uitproberen nooit per ongeluk een bestelling aanmaakt.\n","in":"query","required":false,"schema":{"type":"boolean","default":true},"examples":{"default":{"value":true,"x-disabled":false}}},"q":{"name":"q","description":"Zoekterm, bijvoorbeeld een postcode, straatnaam of adres.","in":"query","required":true,"schema":{"type":"string"},"example":"Dorpstraat 1"},"gemeentecode":{"name":"gemeentecode","description":"CBS/BAG-gemeentecode van de (bestuurlijke) gemeente — niet de kadastrale gemeentecode uit `perceel_id`, die een veel kleiner gebied aanduidt.\n","in":"path","required":true,"schema":{"type":"string"},"example":"GM0363"},"formaat":{"name":"formaat","description":"Het bestandsformaat van de kaartafbeelding.","in":"query","required":false,"schema":{"type":"string","enum":["webp","jpeg","png"],"default":"webp"},"examples":{"default":{"value":"webp","x-disabled":false}}},"breedte":{"name":"breedte","description":"Breedte van de kaartafbeelding in pixels. De hoogte is altijd de helft daarvan.\n","in":"query","required":false,"schema":{"type":"integer","minimum":10,"maximum":3000,"default":1200},"examples":{"default":{"value":1200,"x-disabled":false}}},"alleenRand":{"name":"alleenRand","description":"Zet op `true` om het perceel alleen met een rand te markeren in plaats van met een gearceerde vlakvulling.\n","in":"query","required":false,"schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":false}}},"marge":{"name":"marge","description":"Extra ruimte rond het perceel voordat de bbox vierkant wordt gemaakt, als deel van de perceelafmeting per zijde — `0.1` is 10% extra aan elke kant. Vierkant maken kan op de kortste as nog extra ruimte toevoegen.\n","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":0.5,"default":0},"examples":{"default":{"value":0,"x-disabled":false}}}},"schemas":{"Aandeel":{"type":"object","properties":{"teller":{"type":"number","description":"Teller van het aandeel in het recht.","example":1},"noemer":{"type":"number","description":"Noemer van het aandeel in het recht.","example":2}},"required":["teller","noemer"]},"Koopsom":{"type":"object","properties":{"bedrag":{"type":"number","nullable":true,"description":"Het bedrag waarvoor het perceel het laatst is overgedragen. `null` als het Kadaster geen koopsom levert — bijvoorbeeld bij een overdracht van vóór 1993, een erfenis of een schenking.","example":254500},"valuta":{"type":"string","nullable":true,"description":"Valutacode van het bedrag. In de praktijk altijd EUR.","example":"EUR"},"koopjaar":{"type":"number","nullable":true,"description":"Het jaar waarin de koop is gesloten.","example":2020},"indicatieMeerObjecten":{"type":"boolean","nullable":true,"description":"True als de koopsom betrekking heeft op méér dan alleen dit perceel. Het bedrag is dan niet toe te rekenen aan dit perceel alleen.","example":false}},"required":["bedrag","valuta","koopjaar","indicatieMeerObjecten"]},"Perceel":{"type":"object","properties":{"lokaalId":{"type":"string","nullable":true,"description":"Kadastrale objectidentificatie. Bruikbaar als `perceel_id` in de andere endpoints.","example":"11010156070000"},"kadastraleAanduiding":{"type":"string","nullable":true,"description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee u dit endpoint bevraagt.","example":"ZDT00-T-1560"},"kadastraleGemeentecode":{"type":"string","nullable":true,"description":"De numerieke gemeentecode van het Kadaster. Let op: dit is een ander codestelsel dan de vijftekencode in `kadastraleAanduiding` — gebruik die laatste om dit perceel opnieuw op te vragen.","example":"1182"},"kadastraleGemeentenaam":{"type":"string","nullable":true,"description":"Kadastrale gemeentenaam.","example":"Zundert"},"sectie":{"type":"string","nullable":true,"description":"Kadastrale sectie.","example":"T"},"perceelnummer":{"type":"number","nullable":true,"description":"Perceelnummer.","example":1560},"oppervlakte":{"type":"number","nullable":true,"description":"Kadastrale grootte in vierkante meters.","example":368},"soortGrootte":{"type":"string","nullable":true,"description":"`Vastgesteld` als de grootte is ingemeten, `Voorlopig` als hij nog niet definitief is — bij een voorlopige grootte kan de oppervlakte nog wijzigen.","example":"Vastgesteld"},"aardCultuur":{"type":"string","nullable":true,"description":"Het cultuurgebruik van het perceel, bebouwd of onbebouwd.","example":"Wonen"},"plaatscoordinaten":{"type":"array","nullable":true,"items":{"type":"number"},"description":"Het plaatsingspunt van het perceel als `[x, y]` in Rijksdriehoekscoördinaten (EPSG:28992).","example":[101767.607,382658.929]}},"required":["lokaalId","kadastraleAanduiding","kadastraleGemeentecode","kadastraleGemeentenaam","sectie","perceelnummer","oppervlakte","soortGrootte","aardCultuur","plaatscoordinaten"]},"Peilmoment":{"type":"object","properties":{"kadastraal":{"type":"string","nullable":true,"description":"Tot welk moment de kadastrale registratie is bijgewerkt.","example":"2021-01-15T14:59:00+01:00"},"hypothecair":{"type":"string","nullable":true,"description":"Tot welk moment de hypothecaire registratie is bijgewerkt.","example":"2021-01-07T14:59:00+01:00"},"signaleringKadastraal":{"type":"string","nullable":true,"description":"Tot welk moment nog niet verwerkte kadastrale stukken zijn gesignaleerd.","example":"2021-01-15T14:59:00+01:00"},"signaleringHypothecair":{"type":"string","nullable":true,"description":"Tot welk moment nog niet verwerkte hypothecaire stukken zijn gesignaleerd.","example":"2021-01-15T14:59:00+01:00"},"signaleringBeslagen":{"type":"string","nullable":true,"description":"Tot welk moment nog niet verwerkte beslagen zijn gesignaleerd.","example":"2021-01-15T14:59:00+01:00"},"samengesteldOp":{"type":"string","nullable":true,"description":"Het moment waarop het Kadaster dit bericht heeft samengesteld.","example":"2023-11-06T18:01:15.518+01:00"}},"required":["kadastraal","hypothecair","signaleringKadastraal","signaleringHypothecair","signaleringBeslagen","samengesteldOp"]},"Stuk":{"type":"object","properties":{"aard":{"type":"string","nullable":true,"description":"Waar het stuk in voorziet.","example":"Overdracht (eigendom en/of beperkt recht)"},"register":{"type":"string","nullable":true,"description":"Het register waarin het stuk is ingeschreven.","example":"Hyp4"},"deel":{"type":"string","nullable":true,"description":"Deel van de inschrijving.","example":"76944"},"nummer":{"type":"string","nullable":true,"description":"Nummer van de inschrijving.","example":"54"},"ingeschrevenOp":{"type":"string","nullable":true,"description":"Datum waarop het stuk ter inschrijving is aangeboden.","example":"2019-12-04"},"ondertekendOp":{"type":"string","nullable":true,"description":"Datum waarop het stuk is ondertekend.","example":"2019-12-03"}},"required":["aard","register","deel","nummer","ingeschrevenOp","ondertekendOp"]},"Aantekening":{"type":"object","properties":{"aard":{"type":"string","nullable":true,"description":"Waar de aantekening over gaat. Denk aan beslagen, een kwalitatieve verplichting of een koopovereenkomst op grond van de Wvg.","example":"Kwalitatieve verplichting"},"omschrijving":{"type":"string","nullable":true,"description":"Vrije toelichting van het Kadaster. Alleen gevuld bij aantekeningen die er een hebben.","example":"OORSPRONKELIJK GEVESTIGD BIJ: 4 11316 52"},"betreftGedeelteVanPerceel":{"type":"boolean","nullable":true,"description":"True als de aantekening maar op een deel van het perceel rust, niet op het geheel.","example":false},"einddatum":{"type":"string","nullable":true,"description":"De datum waarop de aantekening vervalt, als die bekend is.","example":"2019-10-17T00:00:00+02:00"},"stuk":{"allOf":[{"$ref":"#/components/schemas/Stuk"},{"nullable":true,"description":"Het stuk waarop de aantekening is gebaseerd."}]}},"required":["aard","omschrijving","betreftGedeelteVanPerceel","einddatum","stuk"]},"GerechtigdeAdres":{"type":"object","properties":{"straatnaam":{"type":"string","nullable":true,"description":"Straatnaam, of `Postbus`.","example":"Kalverstraat"},"huisnummer":{"type":"number","nullable":true,"description":"Huisnummer, of het postbusnummer.","example":1},"huisletter":{"type":"string","nullable":true,"description":"Huisletter.","example":"A"},"huisnummertoevoeging":{"type":"string","nullable":true,"description":"Huisnummertoevoeging.","example":"bis"},"postcode":{"type":"string","nullable":true,"description":"Postcode.","example":"1012NX"},"woonplaats":{"type":"string","nullable":true,"description":"Woonplaats.","example":"Amsterdam"},"land":{"type":"string","nullable":true,"description":"Land. Bij een binnenlands adres altijd Nederland.","example":"Nederland"}},"required":["straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaats","land"]},"Gerechtigde":{"type":"object","properties":{"recht":{"type":"string","nullable":true,"description":"Het zakelijk recht dat deze partij op het perceel heeft.","example":"Eigendom (recht van)"},"rechtCode":{"type":"string","nullable":true,"description":"Kadastercode van het zakelijk recht. `2` is eigendom, `3` erfpacht.","example":"2"},"aandeel":{"allOf":[{"$ref":"#/components/schemas/Aandeel"},{"nullable":true,"description":"Het aandeel van deze partij in het recht. `null` als het Kadaster geen aandeel levert."}]},"burgerlijkeStaat":{"type":"string","nullable":true,"description":"Burgerlijke staat van de gerechtigde op het moment dat hij het recht verkreeg.","example":"Gehuwd"},"natuurlijkPersoon":{"type":"boolean","description":"True voor een mens, false voor een rechtspersoon (bv, stichting, gemeente, ...). Bepaalt welke velden hieronder gevuld zijn.","example":true},"naam":{"type":"string","description":"De naam om te tonen: de volledige naam bij een natuurlijk persoon, de statutaire naam bij een rechtspersoon.","example":"Jan Janssen"},"voornamen":{"type":"string","nullable":true,"description":"Voornamen.","example":"Jan"},"voorvoegsel":{"type":"string","nullable":true,"description":"Voorvoegsel van de geslachtsnaam.","example":"van"},"geslachtsnaam":{"type":"string","nullable":true,"description":"Geslachtsnaam.","example":"Janssen"},"geslacht":{"type":"string","nullable":true,"description":"Geslachtsaanduiding.","example":"Man"},"geboortedatum":{"type":"string","nullable":true,"description":"Geboortedatum.","example":"1975-03-15"},"geboorteplaats":{"type":"string","nullable":true,"description":"Geboorteplaats.","example":"Amsterdam"},"geboorteland":{"type":"string","nullable":true,"description":"Geboorteland.","example":"Nederland"},"overleden":{"type":"boolean","nullable":true,"description":"True als het Kadaster de persoon als overleden heeft geregistreerd.","example":false},"statutaireNaam":{"type":"string","nullable":true,"description":"Statutaire naam.","example":"Janssen B.V."},"kvkNummer":{"type":"string","nullable":true,"description":"KvK-nummer.","example":"12345678"},"rechtsvorm":{"type":"string","nullable":true,"description":"Rechtsvorm.","example":"Besloten vennootschap met gewone structuur"},"adres":{"allOf":[{"$ref":"#/components/schemas/GerechtigdeAdres"},{"nullable":true,"description":"Het bij het Kadaster bekende woon- of postadres van de gerechtigde."}]},"verkregenBij":{"type":"array","items":{"$ref":"#/components/schemas/Stuk"},"description":"De stukken waarmee deze partij het recht heeft verkregen. Met `register`, `deel` en `nummer` kunt u de akte bij het Kadaster opvragen."}},"required":["recht","rechtCode","aandeel","burgerlijkeStaat","natuurlijkPersoon","naam","voornamen","voorvoegsel","geslachtsnaam","geslacht","geboortedatum","geboorteplaats","geboorteland","overleden","statutaireNaam","kvkNummer","rechtsvorm","adres","verkregenBij"]},"VerenigingVanEigenaren":{"type":"object","properties":{"naam":{"type":"string","description":"Statutaire naam van de VvE.","example":"VvE Kalverstraat 1-9"},"kvkNummer":{"type":"string","nullable":true,"description":"KvK-nummer van de VvE.","example":"12345678"},"rechtsvorm":{"type":"string","nullable":true,"description":"Rechtsvorm van de VvE.","example":"Vereniging van eigenaars"},"adres":{"allOf":[{"$ref":"#/components/schemas/GerechtigdeAdres"},{"nullable":true,"description":"Het bij het Kadaster bekende adres van de VvE."}]}},"required":["naam","kvkNummer","rechtsvorm","adres"]},"AppartementsrechtSplitsing":{"type":"object","properties":{"type":{"type":"string","nullable":true,"description":"Het soort splitsing — een hoofdsplitsing, of een ondersplitsing daarbinnen.","example":"Hoofdsplitsing"},"verenigingVanEigenaren":{"allOf":[{"$ref":"#/components/schemas/VerenigingVanEigenaren"},{"nullable":true,"description":"De VvE die bij deze splitsing hoort, als het Kadaster die levert."}]}},"required":["type","verenigingVanEigenaren"]},"Eigendomsinformatie":{"type":"object","properties":{"perceel":{"allOf":[{"$ref":"#/components/schemas/Perceel"},{"nullable":true,"description":"Het perceel waar deze eigendomsinformatie over gaat, zoals het Kadaster het teruggeeft."}]},"peilmoment":{"allOf":[{"$ref":"#/components/schemas/Peilmoment"},{"description":"Tot welk moment de geleverde gegevens bijgewerkt zijn. Eigendomsinformatie is een momentopname: wat na deze tijdstippen bij het Kadaster is ingeschreven, staat er niet in."}]},"koopsom":{"allOf":[{"$ref":"#/components/schemas/Koopsom"},{"nullable":true,"description":"De laatst bekende koopsom van het perceel. `null` als het Kadaster er geen levert."}]},"eigenaren":{"type":"array","items":{"$ref":"#/components/schemas/Gerechtigde"},"description":"De partijen met het recht van eigendom (kadastercode `2`). Meerdere entries betekent gedeeld eigendom; tel de `aandeel`-velden op om te zien hoe."},"erfpachters":{"type":"array","items":{"$ref":"#/components/schemas/Gerechtigde"},"description":"De partijen met het recht van erfpacht (kadastercode `3`). Is deze lijst gevuld, dan gebruikt de erfpachter het perceel terwijl `eigenaren` de bloot eigenaar is."},"andereGerechtigden":{"type":"array","items":{"$ref":"#/components/schemas/Gerechtigde"},"description":"Alle overige zakelijke rechten op het perceel — opstal, vruchtgebruik, gebruik en bewoning, en de zeldzamere varianten. Kijk naar `recht` per entry om te zien waar het om gaat."},"appartementsrechtSplitsingen":{"type":"array","items":{"$ref":"#/components/schemas/AppartementsrechtSplitsing"},"description":"Is deze lijst niet leeg, dan is het perceel gesplitst in appartementsrechten. Lees `eigenaren` dan met zorg: dat is de eigenaar van het grondperceel, niet van de losse appartementen — die staan alleen in de eigendomsinformatie van het appartementsrecht zelf."},"aantekeningen":{"type":"array","items":{"$ref":"#/components/schemas/Aantekening"},"description":"Aantekeningen die op het perceel rusten: beslagen, kwalitatieve verplichtingen, koopovereenkomsten op grond van de Wvg, en dergelijke. Een lege lijst betekent dat het Kadaster er geen kent."}},"required":["perceel","peilmoment","koopsom","eigenaren","erfpachters","andereGerechtigden","appartementsrechtSplitsingen","aantekeningen"]},"EigendomsinformatieAdres":{"allOf":[{"$ref":"#/components/schemas/Eigendomsinformatie"},{"type":"object","properties":{"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam"]}]},"Hypotheekhouder":{"type":"object","properties":{"natuurlijkPersoon":{"type":"boolean","description":"True voor een mens, false voor een rechtspersoon. In de praktijk is een hypotheekhouder bijna altijd een bank en dus een rechtspersoon; een onderhandse lening tussen particulieren komt voor. Bepaalt welke velden hieronder gevuld zijn.","example":false},"naam":{"type":"string","description":"De naam om te tonen: de statutaire naam bij een rechtspersoon, de volledige naam bij een natuurlijk persoon.","example":"Hypotheek Bank Nederland N.V."},"voornamen":{"type":"string","nullable":true,"description":"Voornamen.","example":null},"voorvoegsel":{"type":"string","nullable":true,"description":"Voorvoegsel van de geslachtsnaam.","example":null},"geslachtsnaam":{"type":"string","nullable":true,"description":"Geslachtsnaam.","example":null},"geslacht":{"type":"string","nullable":true,"description":"Geslachtsaanduiding.","example":null},"geboortedatum":{"type":"string","nullable":true,"description":"Geboortedatum.","example":null},"geboorteplaats":{"type":"string","nullable":true,"description":"Geboorteplaats.","example":null},"geboorteland":{"type":"string","nullable":true,"description":"Geboorteland.","example":null},"overleden":{"type":"boolean","nullable":true,"description":"True als het Kadaster de persoon als overleden heeft geregistreerd.","example":null},"statutaireNaam":{"type":"string","nullable":true,"description":"Statutaire naam.","example":"Hypotheek Bank Nederland N.V."},"kvkNummer":{"type":"string","nullable":true,"description":"KvK-nummer.","example":"87654321"},"rechtsvorm":{"type":"string","nullable":true,"description":"Rechtsvorm.","example":"Naamloze vennootschap"},"adres":{"allOf":[{"$ref":"#/components/schemas/GerechtigdeAdres"},{"nullable":true,"description":"Het bij het Kadaster bekende woon- of postadres van de hypotheekhouder."}]}},"required":["natuurlijkPersoon","naam","voornamen","voorvoegsel","geslachtsnaam","geslacht","geboortedatum","geboorteplaats","geboorteland","overleden","statutaireNaam","kvkNummer","rechtsvorm","adres"]},"Hypotheek":{"type":"object","properties":{"type":{"type":"string","nullable":true,"description":"Het soort zekerheidsstelling zoals het Kadaster het levert. Bij dit product in de praktijk altijd `ZekerheidsstellingHypothecair`.","example":"ZekerheidsstellingHypothecair"},"aard":{"type":"string","nullable":true,"description":"Waar het onderliggende stuk in voorziet — waarmee de hypotheek is gevestigd of gewijzigd.","example":"Hypotheek"},"betrokkenRecht":{"type":"string","nullable":true,"description":"Het recht waarop de hypotheek rust. Meestal `Eigendom`; bij een erfpachtwoning rust de hypotheek op het recht van erfpacht.","example":"Eigendom"},"bedrag":{"type":"number","nullable":true,"description":"Het bedrag waarvoor de hypotheek is ingeschreven. Let op: dit is de inschrijving, niet de restschuld — hoeveel er nog openstaat registreert het Kadaster niet.","example":468499},"valuta":{"type":"string","nullable":true,"description":"Valutacode van het bedrag. In de praktijk altijd EUR.","example":"EUR"},"gekozenWoonplaats":{"type":"string","nullable":true,"description":"De woonplaats die de hypotheekhouder in de akte heeft gekozen voor correspondentie.","example":"A ROMIJN ROTTERDAM"},"hypotheekhouders":{"type":"array","items":{"$ref":"#/components/schemas/Hypotheekhouder"},"description":"De partijen die deze hypotheek houden — degenen aan wie het onderpand is verhypothekeerd. Meestal precies één bank."},"stuk":{"allOf":[{"$ref":"#/components/schemas/Stuk"},{"nullable":true,"description":"Het ingeschreven stuk waarmee de hypotheek is gevestigd. Met `register`, `deel` en `nummer` kunt u de akte bij het Kadaster opvragen."}]}},"required":["type","aard","betrokkenRecht","bedrag","valuta","gekozenWoonplaats","hypotheekhouders","stuk"]},"Hypotheekinformatie":{"type":"object","properties":{"perceel":{"allOf":[{"$ref":"#/components/schemas/Perceel"},{"nullable":true,"description":"Het kadastrale object waar deze hypotheekinformatie over gaat, zoals het Kadaster het teruggeeft."}]},"peilmoment":{"allOf":[{"$ref":"#/components/schemas/Peilmoment"},{"description":"Tot welk moment de geleverde gegevens bijgewerkt zijn. Hypotheekinformatie is een momentopname: wat na deze tijdstippen bij het Kadaster is ingeschreven, staat er niet in."}]},"hypotheken":{"type":"array","items":{"$ref":"#/components/schemas/Hypotheek"},"description":"De hypotheken die op het object rusten, met hun inschrijvingsbedrag en hypotheekhouder. Een lege lijst betekent dat het Kadaster er geen kent — het object is dan hypotheekvrij."}},"required":["perceel","peilmoment","hypotheken"]},"HypotheekinformatieAdres":{"allOf":[{"$ref":"#/components/schemas/Hypotheekinformatie"},{"type":"object","properties":{"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam"]}]},"Geometry":{"type":"object","properties":{"type":{"type":"string","description":"Het GeoJSON-geometrietype.","example":"MultiPolygon"},"coordinates":{"type":"array","items":{"nullable":true},"description":"De coördinaten, in de vorm die bij `type` hoort, in EPSG:4326 (WGS84).","example":[[[[4.8951,52.3702],[4.8955,52.3702],[4.8955,52.3705],[4.8951,52.3705],[4.8951,52.3702]]]]}},"required":["type","coordinates"]},"Adres":{"type":"object","properties":{"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"Het adrespunt.","example":{"type":"Point","coordinates":[4.895,52.37]}}]}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam","geometry"]},"PerceelbedekkingHoofdcategorie":{"type":"object","properties":{"categorie":{"type":"string","enum":["bebouwing","groen","onverhard","verharding","water"],"description":"De hoofdcategorie van bedekking. Komt altijd met alle vijf categorieën terug, ook als een categorie niet op het perceel voorkomt.","example":"bebouwing"},"oppervlakteM2":{"type":"number","description":"Oppervlakte van deze categorie binnen het perceel, in vierkante meters.","example":1424},"percentage":{"type":"number","description":"Aandeel van deze categorie in de totale perceeloppervlakte, in procenten.","example":36},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De vlakken van deze categorie binnen het perceel. `null` als de categorie niet voorkomt."}]}},"required":["categorie","oppervlakteM2","percentage","geometry"]},"PerceelbedekkingDetail":{"type":"object","properties":{"type":{"type":"string","enum":["pand","overig_bouwwerk","erf","wegdeel_auto","wegdeel_overig","gras","struiken","bos","zand","oever","water"],"description":"Het BGT-bedekkingstype. Komt altijd met alle elf typen terug, ook als een type niet op het perceel voorkomt.","example":"pand"},"oppervlakteM2":{"type":"number","description":"Oppervlakte van dit type binnen het perceel, in vierkante meters.","example":1424},"percentage":{"type":"number","description":"Aandeel van dit type in de totale perceeloppervlakte, in procenten.","example":36},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De vlakken van dit type binnen het perceel. `null` als het type niet voorkomt."}]}},"required":["type","oppervlakteM2","percentage","geometry"]},"Perceelbedekking":{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee dit endpoint is bevraagd.","example":"ASD40-C-123"},"bedekkingHoofdcategorie":{"type":"array","items":{"$ref":"#/components/schemas/PerceelbedekkingHoofdcategorie"},"description":"De perceelbedekking ingedeeld op hoofdcategorie. Bevat altijd alle vijf categorieën."},"bedekkingDetail":{"type":"array","items":{"$ref":"#/components/schemas/PerceelbedekkingDetail"},"description":"De perceelbedekking ingedeeld op BGT-detailtype. Bevat altijd alle elf typen."}},"required":["perceelId","bedekkingHoofdcategorie","bedekkingDetail"]},"PerceelbedekkingAdres":{"allOf":[{"$ref":"#/components/schemas/Perceelbedekking"},{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel waar dit adres op staat.","example":"ASD40-C-123"},"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam"]}]},"EigendomstypeIndicatie":{"type":"object","properties":{"datum":{"type":"string","description":"Peildatum van deze indicatie, in de vorm dd-mm-jjjj. Op dit moment zijn er peildata voor 2016 en 2020.","example":"31-12-2016"},"type":{"type":"string","description":"Het type eigenaar op deze peildatum.","example":"Natuurlijke personen en overige rechtspersonen"}},"required":["datum","type"]},"IndicatieEigenaar":{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee dit endpoint is bevraagd.","example":"ASD40-C-123"},"eigendomstypeIndicatie":{"type":"array","items":{"$ref":"#/components/schemas/EigendomstypeIndicatie"},"description":"Indicatie van het type eigenaar van het perceel op de beschikbare peildata."},"gewijzigdSinds2020":{"type":"boolean","description":"True als er sinds 1 januari 2020 een kadastrale transactie op het perceel heeft plaatsgevonden.","example":false},"laatsteWijziging":{"type":"string","nullable":true,"description":"Datum van de laatst bekende kadastrale transactie op het perceel. `null` als die niet bekend is.","example":"2016-11-30"}},"required":["perceelId","eigendomstypeIndicatie","gewijzigdSinds2020","laatsteWijziging"]},"IndicatieEigenaarAdres":{"allOf":[{"$ref":"#/components/schemas/IndicatieEigenaar"},{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel waar dit adres op staat.","example":"ASD40-C-123"},"eigendomstypeIndicatie":{"type":"array","items":{"$ref":"#/components/schemas/EigendomstypeIndicatie"},"description":"Indicatie van het type eigenaar van het perceel waar dit adres op staat, op de beschikbare peildata."},"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam"]}]},"VoorkeursrechtEntry":{"type":"object","properties":{"startdatum":{"type":"string","nullable":true,"description":"Datum waarop het voorkeursrecht is gevestigd.","example":"2022-03-01"},"einddatum":{"type":"string","nullable":true,"description":"Datum waarop het voorkeursrecht is vervallen. `null` als het (nog) niet vervallen is.","example":null},"documenten":{"type":"array","items":{"type":"string"},"description":"Links naar de bij dit voorkeursrecht behorende besluitdocumenten.","example":["https://www.amsterdam.nl/bestemmingsplannen/voorkeursrecht-2022-besluit.pdf"]},"status":{"type":"string","enum":["actief","toekomstig","vervallen"],"description":"Afgeleid van start- en einddatum: `actief` (gestart, nog niet vervallen), `toekomstig` (start pas in de toekomst) of `vervallen` (einddatum ligt in het verleden).","example":"actief"}},"required":["startdatum","einddatum","documenten","status"]},"Voorkeursrecht":{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee dit endpoint is bevraagd.","example":"ASD40-C-123"},"voorkeursrecht":{"type":"array","items":{"$ref":"#/components/schemas/VoorkeursrechtEntry"},"description":"De voorkeursrechten die op het perceel (hebben ge)rust(en). Leeg als het Kadaster er geen kent."}},"required":["perceelId","voorkeursrecht"]},"GemeenteVoorkeursrechtEntry":{"type":"object","properties":{"perceelId":{"type":"string","description":"Bruikbaar als perceel_id in de andere endpoints.","example":"ASD40-C-123"},"startdatum":{"type":"string","nullable":true,"description":"Datum waarop het voorkeursrecht is gevestigd.","example":"2022-03-01"},"einddatum":{"type":"string","nullable":true,"description":"Datum waarop het voorkeursrecht is vervallen. `null` als het (nog) niet vervallen is.","example":null},"status":{"type":"string","enum":["actief","toekomstig","vervallen"],"description":"Afgeleid van start- en einddatum: `actief` (gestart, nog niet vervallen), `toekomstig` (start pas in de toekomst) of `vervallen` (einddatum ligt in het verleden).","example":"actief"},"documenten":{"type":"array","items":{"type":"string"},"description":"Links naar de bij dit voorkeursrecht behorende besluitdocumenten.","example":["https://www.amsterdam.nl/bestemmingsplannen/voorkeursrecht-2022-besluit.pdf"]}},"required":["perceelId","startdatum","einddatum","status","documenten"]},"GemeenteVoorkeursrecht":{"type":"object","properties":{"gemeentecode":{"type":"string","description":"De kadastrale gemeentecode waarmee dit endpoint is bevraagd.","example":"GM0363"},"voorkeursrecht":{"type":"array","items":{"$ref":"#/components/schemas/GemeenteVoorkeursrechtEntry"},"description":"Alle voorkeursrechten binnen de gemeente, als platte lijst — een perceel met meerdere voorkeursrechten levert meerdere entries op. Leeg als wij er geen kennen."}},"required":["gemeentecode","voorkeursrecht"]},"Gebouw":{"type":"object","properties":{"identificatie":{"type":"string","description":"BAG-identificatie van het pand.","example":"0363100012072211"},"bouwjaar":{"type":"number","nullable":true,"example":1930},"pandstatus":{"type":"string","nullable":true,"example":"Pand in gebruik"},"gebouwtype":{"type":"string","nullable":true,"description":"Het woningtype van het pand, of — als dat niet bekend is (bijvoorbeeld bij een niet-woonfunctie) — de geconsolideerde gebruiksfunctie.","example":"Tussenwoning"},"gebruiksfunctie":{"type":"string","nullable":true,"example":"woonfunctie"},"grondoppervlakteM2":{"type":"number","nullable":true,"example":74.2},"aantalBouwlagen":{"type":"number","nullable":true,"example":3},"maxBouwhoogteFeitelijkM":{"type":"number","nullable":true,"description":"De feitelijke, gemeten maximale hoogte van het pand.","example":10.1},"hoogte70pMinusMaaiveldM":{"type":"number","nullable":true,"example":6.8},"b3HoogteMaaiveldM":{"type":"number","nullable":true,"example":9.7},"optopVolumeM3":{"type":"number","nullable":true,"description":"Het volume dat theoretisch nog kan worden toegevoegd bovenop het pand.","example":95.4},"volumeM3":{"type":"number","nullable":true,"example":612.5},"dakType":{"type":"string","nullable":true,"example":"plat dak"},"oppBuitenmuurM2":{"type":"number","nullable":true,"example":118.6},"beukmaatM":{"type":"number","nullable":true,"example":5.4},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De 2D-voetafdruk van het pand."}]}},"required":["identificatie","bouwjaar","pandstatus","gebouwtype","gebruiksfunctie","grondoppervlakteM2","aantalBouwlagen","maxBouwhoogteFeitelijkM","hoogte70pMinusMaaiveldM","b3HoogteMaaiveldM","optopVolumeM3","volumeM3","dakType","oppBuitenmuurM2","beukmaatM","geometry"]},"StedenbouwkundigeIndices":{"type":"object","properties":{"floorSpaceIndexFsi":{"type":"number","nullable":true,"description":"Floor Space Index (FSI): verhouding bruto vloeroppervlak tot perceeloppervlak.","example":1.8},"groundSpaceIndexGsi":{"type":"number","nullable":true,"description":"Ground Space Index (GSI): het bebouwingspercentage van het perceel.","example":0.43},"layersL":{"type":"number","nullable":true,"description":"Layers (L): gemiddeld aantal bouwlagen (FSI gedeeld door GSI).","example":3.2},"openSpaceRatioOsr":{"type":"number","nullable":true,"description":"Open Space Ratio (OSR): verhouding onbebouwde ruimte tot bruto vloeroppervlak.","example":0.32}},"required":["floorSpaceIndexFsi","groundSpaceIndexGsi","layersL","openSpaceRatioOsr"]},"OptopanalyseSamenvatting":{"type":"object","properties":{"aantalGebouwen":{"type":"number","description":"Aantal panden op het perceel.","example":2},"totaalOptopVolumeM3":{"type":"number","description":"Som van het optop-volume van alle panden op het perceel.","example":436},"uitbreidingsvolumePerceelM3":{"type":"number","nullable":true,"example":185.3},"percentageBebouwing":{"type":"number","nullable":true,"example":42.5},"stedenbouwkundigeIndices":{"$ref":"#/components/schemas/StedenbouwkundigeIndices"},"maximaleBouwhoogtePlanologischM":{"type":"number","nullable":true,"description":"De maximaal toegestane bouwhoogte volgens het geldende bestemmingsplan.","example":13.5},"maximaleGoothoogtePlanologischM":{"type":"number","nullable":true,"description":"De maximaal toegestane goothoogte volgens het geldende bestemmingsplan.","example":9.5}},"required":["aantalGebouwen","totaalOptopVolumeM3","uitbreidingsvolumePerceelM3","percentageBebouwing","stedenbouwkundigeIndices","maximaleBouwhoogtePlanologischM","maximaleGoothoogtePlanologischM"]},"Bouwvlak":{"type":"object","properties":{"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"description":"De geometrie van het bouwvlak uit het bestemmingsplan waar deze waarden op gebaseerd zijn."}]},"maximaleBouwhoogteM":{"type":"number","nullable":true,"description":"De maximale bouwhoogte die op dit bouwvlak van toepassing is. `null` als die er niet geldt.","example":13.5},"maximaleGoothoogteM":{"type":"number","nullable":true,"description":"De maximale goothoogte die op dit bouwvlak van toepassing is. `null` als die er niet geldt.","example":9.5}},"required":["geometry","maximaleBouwhoogteM","maximaleGoothoogteM"]},"Optopanalyse":{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee dit endpoint is bevraagd.","example":"ASD40-C-123"},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De 2D-geometrie van het perceel."}]},"samenvatting":{"$ref":"#/components/schemas/OptopanalyseSamenvatting"},"gebouwen":{"type":"array","items":{"$ref":"#/components/schemas/Gebouw"},"description":"Eén entry per pand op het perceel."},"bouwvlakken":{"type":"array","items":{"$ref":"#/components/schemas/Bouwvlak"},"description":"De bouwvlakken uit het bestemmingsplan waarop de maximale bouw- en goothoogte in `samenvatting` zijn gebaseerd — elk met zijn eigen geometrie en de waarde(n) die daar gelden. Leeg als er geen bouwvlakken met deze maatvoering over de panden van het perceel liggen."}},"required":["perceelId","geometry","samenvatting","gebouwen","bouwvlakken"]},"OptopanalyseAdres":{"allOf":[{"$ref":"#/components/schemas/Optopanalyse"},{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel waar dit adres op staat.","example":"ASD40-C-123"},"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam"]}]},"PerceelKenmerken":{"type":"object","properties":{"kadastraleAanduiding":{"type":"string","description":"De kadastrale aanduiding van het perceel, gelijk aan het top-level `perceelId`.","example":"ASD40-C-123"},"gemeentecode":{"type":"string","description":"De kadastrale gemeentecode — het eerste deel van `kadastraleAanduiding`.","example":"ASD40"},"sectie":{"type":"string","description":"Kadastrale sectie.","example":"C"},"perceelnummer":{"type":"number","description":"Perceelnummer.","example":123},"oppervlakteRegistratieM2":{"type":"number","nullable":true,"description":"De bij het Kadaster geregistreerde oppervlakte, in vierkante meters.","example":368},"oppervlakteBerekendM2":{"type":"number","nullable":true,"description":"De uit de perceelgeometrie berekende oppervlakte, in vierkante meters.","example":365.4},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De 2D-geometrie van het perceel."}]}},"required":["kadastraleAanduiding","gemeentecode","sectie","perceelnummer","oppervlakteRegistratieM2","oppervlakteBerekendM2","geometry"]},"PerceelDetailGebouw":{"type":"object","properties":{"id":{"type":"string","description":"BAG-identificatie van het pand.","example":"0363100012345678"},"bouwjaar":{"type":"number","nullable":true,"example":1932},"oppervlakteM2":{"type":"number","nullable":true,"description":"Grondoppervlakte van het pand.","example":87.2},"geometry":{"allOf":[{"$ref":"#/components/schemas/Geometry"},{"nullable":true,"description":"De 2D-voetafdruk van het pand."}]}},"required":["id","bouwjaar","oppervlakteM2","geometry"]},"InformatieProduct":{"type":"object","properties":{"product":{"type":"string","example":"eigendomsinformatie"},"endpoint":{"type":"string","description":"Het pad van het endpoint voor dit product, voor dit perceel.","example":"/percelen/ASD40-C-123/eigendomsinformatie"},"beschikbaarVoorPerceel":{"type":"boolean","description":"Of dit product nu voor dít perceel opgevraagd kan worden. `false` als het endpoint nog in ontwikkeling is.","example":true}},"required":["product","endpoint","beschikbaarVoorPerceel"]},"AdresInformatieProduct":{"type":"object","properties":{"product":{"type":"string","example":"perceelbedekking"},"endpoint":{"type":"string","description":"Het pad van het endpoint voor dit product, voor dit adres.","example":"/adressen/0344200000077001/perceelbedekking"},"beschikbaarVoorAdres":{"type":"boolean","description":"Of dit product nu voor dít adres opgevraagd kan worden. `false` als het endpoint nog in ontwikkeling is.","example":true}},"required":["product","endpoint","beschikbaarVoorAdres"]},"PerceelDetail":{"type":"object","properties":{"perceelId":{"type":"string","description":"De kadastrale aanduiding van het perceel, in dezelfde vorm als het `perceel_id` waarmee dit endpoint is bevraagd.","example":"ASD40-C-123"},"perceel":{"$ref":"#/components/schemas/PerceelKenmerken"},"adressen":{"type":"array","items":{"$ref":"#/components/schemas/Adres"},"description":"De adressen op dit perceel. Leeg als het perceel geen adressen heeft."},"gebouwen":{"type":"array","items":{"$ref":"#/components/schemas/PerceelDetailGebouw"},"description":"De panden op dit perceel. Leeg als het perceel geen panden heeft."},"informatieProducten":{"type":"array","items":{"$ref":"#/components/schemas/InformatieProduct"},"description":"Alle informatieproducten die (in de toekomst) voor een perceel beschikbaar zijn, met hun status."}},"required":["perceelId","perceel","adressen","gebouwen","informatieProducten"]},"AdresDetail":{"type":"object","properties":{"adresId":{"type":"string","description":"Nummeraanduidingidentificatie, in dezelfde vorm als het `adres_id` waarmee dit endpoint is bevraagd.","example":"0344200000077001"},"adres":{"$ref":"#/components/schemas/Adres"},"gebouw":{"allOf":[{"$ref":"#/components/schemas/PerceelDetailGebouw"},{"nullable":true,"description":"Het pand waarin dit adres ligt. `null` als het adres niet aan een pand gekoppeld is."}]},"perceel":{"$ref":"#/components/schemas/PerceelKenmerken"},"informatieProducten":{"type":"array","items":{"$ref":"#/components/schemas/AdresInformatieProduct"},"description":"Alle informatieproducten die (in de toekomst) voor een adres beschikbaar zijn, met hun status."}},"required":["adresId","adres","gebouw","perceel","informatieProducten"]},"PerceelZoekresultaat":{"type":"object","properties":{"perceelId":{"type":"string","description":"Bruikbaar als perceel_id in de andere endpoints.","example":"ASD40-C-123"},"kadastraleGemeentenaam":{"type":"string","example":"Amsterdam"},"kadastraleSectie":{"type":"string","example":"C"},"perceelnummer":{"type":"string","example":"1234"},"weergavenaam":{"type":"string","description":"Weergavenaam van het zoekresultaat.","example":"ASD40 C 123, Amsterdam"},"score":{"type":"number","description":"Relevantiescore van het zoekresultaat — hoger is een betere match.","example":14.23}},"required":["perceelId","kadastraleGemeentenaam","kadastraleSectie","perceelnummer","weergavenaam","score"]},"PercelenZoeken":{"type":"object","properties":{"q":{"type":"string","example":"Dorpstraat 1"},"resultaten":{"type":"array","items":{"$ref":"#/components/schemas/PerceelZoekresultaat"}}},"required":["q","resultaten"]},"AdresZoekresultaat":{"type":"object","properties":{"adresId":{"type":"string","description":"Nummeraanduidingidentificatie. Bruikbaar als `adres_id` bij de adres-endpoints.","example":"0344200000077001"},"weergavenaam":{"type":"string","description":"Het volledige adres op één regel.","example":"Dorpstraat 1, 1234AB Amsterdam"},"straatnaam":{"type":"string","example":"Dorpstraat"},"huisnummer":{"type":"number","example":1},"huisletter":{"type":"string","nullable":true,"example":null},"huisnummertoevoeging":{"type":"string","nullable":true,"example":null},"postcode":{"type":"string","example":"1234AB"},"woonplaatsnaam":{"type":"string","example":"Amsterdam"},"score":{"type":"number","description":"Relevantiescore van het zoekresultaat — hoger is een betere match.","example":14.23}},"required":["adresId","weergavenaam","straatnaam","huisnummer","huisletter","huisnummertoevoeging","postcode","woonplaatsnaam","score"]},"AdressenZoeken":{"type":"object","properties":{"q":{"type":"string","example":"Dorpstraat 1"},"resultaten":{"type":"array","items":{"$ref":"#/components/schemas/AdresZoekresultaat"}}},"required":["q","resultaten"]}}}}