--- title: "WOZ-gegevens op basis van een volledig adres, bv. \"Kalverstraat 1, 1012NX Amsterdam\"." method: GET path: "/Api/Adres" tags: ["Adressen"] --- # WOZ-gegevens op basis van een volledig adres, bv. "Kalverstraat 1, 1012NX Amsterdam". `GET /Api/Adres` ## Request - Base URL: `https://woz-api.nl` - URL: `https://woz-api.nl/Api/Adres` - Auth: API key in header `X-Api-Key` Kost 1 credit per uniek adres. Hetzelfde adres binnen 7 dagen opnieuw opvragen kost geen extra credit; dat is een kortingsregel en geen cache, de request wordt wel echt uitgevoerd. Een opvraging die op een fout eindigt (4xx of 5xx) kost geen credit, en een antwoord zonder WOZ-waarden (een lege woz, bijvoorbeeld een pand zonder openbare WOZ-waarde) ook niet. Zonder account vraag je een gratis proefsleutel aan met POST /Api/Proef (5 unieke adressen, 10 met het e-mailadres van de gebruiker). Met een key van een account gelden je credits en volgt 402 als je saldo leeg is, met een betaallink in detail.betaalUrl. Het resterende saldo of proeftegoed staat in de response-header X-Credits-Remaining. ## Query parameters - `adres` string, required - `geometrie` boolean - `energielabel` boolean - `subsidietoets` boolean ## Response `200` Het adres is gevonden. Bevat WOZ-waarden per peildatum, BAG-gegevens, WOZ-object en percelen. 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`: Parameter 'adres' ontbreekt of is onbruikbaar. - `401`: Geen sleutel (SleutelOntbreekt, vraag een proefsleutel aan met POST /Api/Proef), of een ongeldige of verlopen sleutel. - `402`: Creditsaldo is leeg (InsufficientCredits, met detail.betaalUrl), of de gratis proef is op (ProefVerbruikt). - `403`: Een OAuth-token zonder de scope woz.lookup (ScopeOntbreekt). - `404`: Dit adres is niet gevonden (AddressNotFound). Een gevonden adres zonder openbare WOZ-waarde geeft een 200 met een lege woz, geen 404. - `502`: Bad Gateway - `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)