--- title: "WOZ-gegevens op basis van BAG nummeraanduiding-id." method: GET path: "/Api/Nummeraanduiding/{id}" tags: ["Adressen"] --- # WOZ-gegevens op basis van BAG nummeraanduiding-id. `GET /Api/Nummeraanduiding/{id}` ## Request - Base URL: `https://woz-api.nl` - URL: `https://woz-api.nl/Api/Nummeraanduiding/{id}` - Auth: API key in header `X-Api-Key` Gebruik dit endpoint als je de BAG-id's al hebt, bijvoorbeeld uit een eerdere adres-lookup of uit een eigen BAG-import. Het slaat het opzoeken van het adres over, dus je bent niet afhankelijk van de schrijfwijze van een adres. Een nummeraanduiding is de brievenbus, een adresseerbaar object het verblijfsobject erachter; kies /Api/AdresseerbaarObject als je een verblijfsobject-id hebt. Dezelfde creditregels als /Api/Adres: 1 credit per uniek adres, 7 dagen herhalen zonder extra credit, en een fout of een antwoord zonder WOZ-waarden kost niets. ## Path parameters - `id` string, required ## Query parameters - `geometrie` boolean - `energielabel` boolean - `subsidietoets` boolean ## Response `200` Gevonden. Heeft het pand geen openbare WOZ-waarde, bijvoorbeeld omdat het geen woning is, dan is woz leeg en zegt wozStatus waarom (geen_woning of geen_waarde). Dat is een antwoord en geen storing: het kost geen credit en opnieuw proberen verandert niets. - WozApiResponse - `adres` string, nullable - `bag` BagInfo - `adresseerbaarobjectId` string, nullable - `nummeraanduidingId` string, nullable - `straatnaam` string, nullable - `huisnummer` integer - `postcode` string, nullable - `woonplaatsnaam` string, nullable - `bouwjaar` integer, nullable: Oorspronkelijk bouwjaar van het pand, uit de BAG. Ligt het verblijfsobject in meer panden, dan het oudste. Leeg als de BAG geen verblijfsobject kent, zoals bij een ligplaats. - `oppervlakte` integer, nullable: Gebruiksoppervlakte van het verblijfsobject in m2, uit de BAG. - `gebruiksdoelen` string[], nullable: Gebruiksdoelen van het verblijfsobject volgens de BAG, bijvoorbeeld "woonfunctie". - `pandIds` string[], nullable: BAG-identificaties van de panden waar het verblijfsobject in ligt. - `wozObject` WozObjectInfo: Het WOZ-object zelf, los van de vastgestelde waarden per peildatum. - `wozobjectnummer` integer, nullable: Uniek nummer van het WOZ-object in de LV-WOZ. - `grondoppervlakte` integer, nullable: Oppervlakte van de grond in m2, indien bekend. - `kadastraleObjecten` KadastraalObjectInfo[], nullable: Een WOZ-object kan op meerdere percelen liggen, daarom een lijst. - `kadastraleGemeenteCode` string, nullable: Code van de kadastrale gemeente, bijvoorbeeld "ASD00". - `kadastraleSectie` string, nullable: Sectieletter binnen de kadastrale gemeente, bijvoorbeeld "K". - `kadastraalPerceelNummer` string, nullable: Perceelnummer binnen de sectie. - `aanduiding` string, nullable: De drie delen samengevoegd, bijvoorbeeld "ASD00 K 1234". - `percelen` PerceelInfo[], nullable: Actuele percelen bij dit adres, met oppervlakte uit de Kadastrale Kaart. - `aanduiding` string, nullable: Kadastrale aanduiding, bijvoorbeeld "ASD04 F 1145". - `kadastraleGemeenteCode` string, nullable: AKR-code van de kadastrale gemeente, bijvoorbeeld "ASD04". - `kadastraleGemeente` string, nullable: Naam van de kadastrale gemeente, bijvoorbeeld "Amsterdam". - `kadastraleSectie` string, nullable - `perceelnummer` integer - `oppervlakteM2` integer, nullable: Kadastrale grootte van het perceel in m2. - `soortGrootte` string, nullable: "Vastgesteld" of "Voorlopig", zoals het Kadaster de grootte kwalificeert. - `perceelId` string, nullable: Lokale identificatie van het kadastrale object binnen NL.IMKAD.KadastraalObject. - `geometrie` unknown - `woz` WozWaarden[], nullable: Alle bekende peildata, oplopend gesorteerd: het eerste element is de oudste waarde en het laatste de nieuwste. Wil je alleen de actuele waarde, gebruik dan HuidigeWaarde. - `peildatum` string, nullable - `vastgesteldeWaarde` integer - `huidigeWaarde` WozWaarden - `peildatum` string, nullable - `vastgesteldeWaarde` integer - `wozStatus` string, nullable: Of er een WOZ-waarde is, en zo niet waarom. "gevonden": woz heeft waarden. "geen_woning": geen waarde, en volgens de BAG heeft het pand geen woonfunctie; alleen van woningen is de WOZ-waarde openbaar. "geen_waarde": geen waarde, terwijl de BAG een woonfunctie noemt of het gebruiksdoel niet bekend is. Beide lege standen zijn een antwoord en geen storing: opnieuw proberen verandert niets. Een storing geeft altijd een foutstatus (502 of 503), nooit een 200 met een lege woz. - `energielabel` EnergielabelInfo: Het geregistreerde energielabel van het adres, uit EP-Online van RVO. Alleen in de respons bij `?energielabel=true`. Kijk eerst naar WozApi.Models.ViewModels.EnergielabelInfo.Status: alleen bij "gevonden" zijn de andere velden gevuld. - `status` string, nullable: "gevonden", "geen_label" (er is voor dit adres geen label geregistreerd) of "niet_beschikbaar" (het label kon nu niet worden opgehaald; probeer het later opnieuw). - `klasse` string, nullable: De labelklasse, van "A++++" tot en met "G". - `registratiedatum` string, nullable: Datum waarop het label is geregistreerd (jjjj-mm-dd). - `geldigTot` string, nullable: Datum tot wanneer het label geldig is (jjjj-mm-dd). Ligt die in het verleden, dan is het label verlopen. - `gebouwtype` string, nullable: Het woningtype volgens het label, bijvoorbeeld een tussenwoning of een appartement. - `gebouwsubtype` string, nullable: Bij een appartement: de ligging in het gebouw. - `vereenvoudigd` boolean, nullable: True bij een vereenvoudigd energielabel, de methode van voor 2021. - `primaireFossieleEnergie` number, double, nullable: Primair fossiel energiegebruik in kWh per m2 per jaar, de maat onder de labelklasse sinds 2021. - `subsidietoets` SubsidietoetsInfo: Alleen bij `?subsidietoets=true`: de toets van deze woning aan de gemeentelijke regelingen met een WOZ-grens, zoals een isolatiesubsidie. Kijk eerst naar WozApi.Models.ViewModels.SubsidietoetsInfo.Status. Elke gemeente is nagelezen; de datum staat in WozApi.Models.ViewModels.SubsidietoetsInfo.Nagelezen. Wat de toets niet per adres kan weten (een inkomen, eigenaar en bewoner, een energieadvies) staat per regeling onder nogNaTeGaan. - `status` string, nullable: "getoetst": de gemeente heeft een of meer regelingen met een WOZ-grens, en die staan in regelingen. "geen_regeling": nagelezen, en de gemeente heeft nu geen regeling met een WOZ-grens. "niet_beschikbaar": de gemeente van dit adres kon nu niet worden bepaald; probeer het later opnieuw. - `gemeente` GemeenteInfo - `code` string, nullable: De CBS-code van de gemeente. - `naam` string, nullable - `nagelezen` string, nullable: Wanneer we de regelingen van deze gemeente voor het laatst nalazen (jjjj-mm-dd). - `toelichting` string, nullable: Een zin over wat we bij deze gemeente vonden, of waarom de toets niet beschikbaar is. - `regelingen` RegelingToetsInfo[], nullable: De regelingen met een WOZ-grens, de belangrijkste eerst; leeg als er geen zijn. - `naam` string, nullable - `hoofd` boolean: De belangrijkste regeling van de gemeente; precies een per gemeente. - `soort` string, nullable: "open"; "uitnodiging" (alleen wie een brief kreeg, of alleen in aangewezen wijken); "budget_op"; "gesloten"; "vve" (alleen voor VvE's); "hoger_bedrag" (de grens bepaalt alleen een hoger bedrag). - `uitkomst` string, nullable: "onder_grens": de WOZ-waarde valt onder (of op) een grens die voor iedereen geldt. "boven_grens": erboven. "peildatum_ontbreekt": er is geen WOZ-waarde op de peildatum van de regeling. "geen_waarde": er is voor dit adres geen WOZ-waarde. "geen_harde_grens": de grens sluit niemand uit en bepaalt alleen een bedrag of een andere eis; zie toelichting. "grens_onbekend": de regeling noemt een grens zonder bedrag, zoals het gemiddelde van de gemeente; zie de regeling. "buiten_gebied": de regeling geldt in een wijk of een paar postcodes, en dit adres ligt erbuiten. - `toelichting` string, nullable: Een zin die de uitkomst uitlegt, met grens, peildatum en waarde. - `grenzen` GrensToetsInfo[], nullable: De grenzen van de regeling, elk met de WOZ-waarde op zijn peildatum. - `euro` integer - `peildatum` string, nullable: De peildatum waarop de grens geldt (jjjj-mm-dd); leeg als de regeling er geen noemt. - `wozWaarde` integer, nullable: De WOZ-waarde van dit adres op die peildatum; leeg als die er niet is. - `onderGrens` boolean, nullable: Of de waarde onder of op de grens valt; leeg als er geen waarde is. - `telt` boolean: Of deze grens voor iedereen geldt. Noemt een regeling twee grenzen, dan kiest de eigenaar vaak een van beide; een grens die alleen een hoger bedrag of een bijzondere groep betreft, telt niet. - `voorwaarden` VoorwaardeToetsInfo[], nullable: Voorwaarden die de toets zelf kon nagaan, zoals bouwjaar en energielabel. - `tekst` string, nullable - `waarde` string, nullable: Wat deze woning heeft. - `voldoet` boolean - `nogNaTeGaan` string[], nullable: Voorwaarden die per adres niet te toetsen zijn en die de aanvrager zelf nagaat. - `bedrag` string, nullable: Het bedrag voor de bewoner, kort. - `bedragen` BedragToetsInfo[], nullable: Het bedrag per doelgroep (iedereen, laag inkomen, doe-het-zelf), zoals de regeling ze onderscheidt; leeg als de regeling geen bedrag noemt. Welke doelgroep geldt, hangt vaak af van het inkomen: dat staat dan in WozApi.Models.ViewModels.BedragToetsInfo.Voorwaarde en onder nogNaTeGaan. - `doelgroep` string, nullable - `maxEuro` integer, nullable: Het maximale bedrag in euro's; weg als de regeling het niet noemt. - `percentage` integer, nullable: Het percentage van de kosten; weg als de regeling het niet noemt. - `voorwaarde` string, nullable - `gebied` string[], nullable: De postcodes waar de regeling geldt, bij een regeling voor een wijk; weg als hij voor de hele gemeente geldt. - `gewijzigd` string, nullable: De laatste dag waarop grens, bedrag of status van deze regeling veranderde, als we dat bijhouden. - `status` string, nullable: Open, Gesloten, Budget op of Op uitnodiging. - `looptijd` string, nullable: Tot wanneer en zolang er budget is, zoals de gemeente het zegt. - `bron` string, nullable: De pagina van de gemeente over de regeling. - `regelingUrl` string, nullable: De officiele tekst van de regeling, als die er is. - `nagelezen` string, nullable - `aanvragen` AanvragenToetsInfo: Wanneer je een regeling aanvraagt, met de zin uit de regeling of van de gemeente als bewijs. - `moment` string, nullable: "vooraf": aanvragen voordat het werk begint; begin pas na het besluit. Sommige regelingen vragen een getekende offerte bij de aanvraag, andere verbieden tekenen vooraf; zie tekst. "achteraf": eerst het werk, dan aanvragen met de factuur. "beide": de regeling kent twee routes; welke geldt, staat in tekst. "onbekend": de regeling zegt het niet duidelijk; vraag het de gemeente voordat er een offerte getekend wordt. - `voor` string, nullable: Een stap die voor het werk moet, ook als je achteraf aanvraagt, zoals een woningcode aanvragen; weg als die er niet is. - `na` string, nullable: Een stap na het werk, zoals gereedmelden met de factuur; weg als die er niet is. - `tekst` string, nullable: Wat dat in deze gemeente betekent, in gewone woorden; leeg bij onbekend. - `citaat` string, nullable: De zin uit de regeling of van de pagina van de gemeente waar het op rust. - `bron` string, nullable: Waar dat citaat staat. - `nagelezen` string, nullable: Wanneer we dit nalazen (jjjj-mm-dd). - `maatregelen` MaatregelenToetsInfo: Welke isolatie een regeling betaalt, met de zin uit de regeling of van de gemeente als bewijs. - `betaalt` string[], nullable: De maatregelen die de gemeente betaalt, voor deze woning: dak (ook zoldervloer), spouwmuur, gevel (binnen of buiten), vloer (ook bodem) en glas. Leeg: de regeling betaalt geen isolatie, zie tekst. Hangt het af van de WOZ-waarde, dan staat hier wat geldt bij de waarde op de peildatum van de regeling. - `viaGemeente` string[], nullable: Wat de gemeente alleen betaalt via haar eigen bedrijf of route (een intermediair, een aanbesteed isolatiebedrijf); met een ander bedrijf krijgt de bewoner daarvoor alleen de ISDE. Weg als alles ook met een eigen bedrijf kan. - `tekst` string, nullable: Wat dat betekent, in gewone woorden, met de voorwaarde die ertoe doet. - `citaat` string, nullable: De zin uit de regeling of van de pagina van de gemeente waar het op rust. - `bron` string, nullable: Waar dat citaat staat. - `isde` IsdeToetsInfo: Hoe de ISDE en het bedrag van de regeling samengaan, met de zin uit de regeling. - `regel` string, nullable - `citaat` string, nullable: De zin uit de regeling of van de pagina van de gemeente. - `bron` string, nullable: Waar dat citaat staat. - `tegoed` TegoedInfo: Het tegoed van een proefsleutel of van een account dat een AI-assistent aanmaakte. - `soort` string, nullable: "proef" zolang de sleutel aan geen account hangt, "credits" als hij van een account is. - `limiet` integer, nullable: Unieke adressen die deze proef in totaal mag; leeg bij credits. - `gebruikt` integer, nullable: Unieke adressen die al gebruikt zijn; leeg bij credits. - `resterend` integer: Wat er nog kan: adressen in de proef, of credits op het account. - `verlooptOp` string, date-time, nullable: Wanneer een proefsleutel zonder account vervalt. ## Other responses - `400`: Het id ontbreekt of heeft niet de vorm van een BAG-id. - `401`: Geen sleutel (SleutelOntbreekt), of een ongeldige of verlopen sleutel. - `402`: Creditsaldo is leeg (InsufficientCredits), of de gratis proef is op (ProefVerbruikt). - `403`: Een OAuth-token zonder de scope woz.lookup (ScopeOntbreekt). - `404`: Dit id is niet gevonden. Een gevonden adres zonder openbare WOZ-waarde geeft een 200 met een lege woz, geen 404. - `503`: Service Unavailable --- [API](https://skmtc.dev/woz-api/apis/wozapi.md) · [All operations](https://skmtc.dev/woz-api/apis/wozapi/llms.txt) · [OpenAPI document](https://skmtc.dev/woz-api/apis/wozapi/revisions/0b2d268e221d?raw)