Het Dataplatform van gemeente Amsterdam gaat het gebruik van een API key bij het gebruik van API's verplicht stellen. Hiermee wil het Dataplatform inzicht krijgen wie gebruik maakt van haar APIs, zodat het Dataplatform kan communiceren over updates en wijzigingen in de API's. Eventuele wijzigingen in de API's kunnen dan tijdig geïmplementeerd worden in uw systemen. Dit gaat gelden voor alle zogenaamde 'DSO API's' van het Dataplatform van gemeente Amsterdam.

Het gebruik van een API key bij de aanroep van een API van het Dataplatform van gemeente Amsterdam is vanaf half september optioneel. In overleg met de dataorganisatie wordt een deadline vastgesteld voor het moment vanaf wanneer de API keys verplicht worden. U kunt de API's van het Dataplatform dan niet meer gebruiken zonder een API key mee te geven.

Dit heeft gevolgen voor uw systemen!

Vraag tijdig een API key aan om uw systemen hierop aan te passen. U kunt met dit formulier een API key aanvragen.

woz

De Basisregistratie waarde onroerende zaken (WOZ) bevat de waardering van alle onroerende zaken in Nederland ten behoeve van onder meer belastingheffing.

ID:
woz
Versie:
default
Autorisatie:
Geen; dit is openbare data.
Licentie:
-
Eigenaar:
Gemeente Amsterdam, afdeling Basisinformatie
Uitgever:
Datateam Basis- en Kernregistraties
Productie:
Belastingen
Bronhouder:
gebruik.basisinformatie@amsterdam.nl

Endpoints

REST OpenAPI:
/v1/woz

Tabellen

Objecten

Autorisatie:
Geen; dit is openbare data.
REST URI:
/v1/woz/objecten
CSV-export:
/v1/woz/objecten?_format=csv
GeoJSON-export:
/v1/woz/objecten?_format=geojson

De volgende velden zijn beschikbaar:

Veld ID Veldnaam Type Identifier Omschrijving
id None String ☑
volgnummer Object volgnummer Integer ☑ Uniek volgnummer van de toestand van het object
registratiedatum Object registratie datum Datetime De datum waarop de toestand van het object is geregistreerd
wozobjectnummer WOZ object ID String ☑ De unieke identificatie van een WOZ-object
gebruik WOZ object gebruik Object Nadere aanduiding van het feitelijk gebruik van een WOZ-object zoals dat ten grondslag heeft gelegen aan de waardebepaling en voor zover relevant voor de afnemers, uitgedrukt in een code
gebruik.gebruikCode WOZ object gebruik code Integer
gebruik.gebruikOmschrijving WOZ object gebruik omschrijving String
soortObject WOZ object soort Object Aanduiding van het soort WOZ-object ten behoeve van een correcte bepaling van de waarde
soortObject.soortObjectCode WOZ object soort code Integer
soortObject.soortObjectOmschrijving WOZ object soort omschrijving String
beginGeldigheid WOZ object geldigheid begindatumtijd Date De ingangsdatum en -tijd van een periode waarin één of meer gegevens die worden bijgehouden over een WOZ-object, een wijziging hebben ondergaan
eindGeldigheid WOZ object geldigheid einddatumtijd Date De einddatum en -tijd van een periode waarin er geen wijzigingen hebben plaatsgevonden in de gegevens die worden bijgehouden over een WOZ-object
bevatBrkKadastraalobject Bevat kadastraal objecten Array Relatie naar kadastraal object
bevatBrkKadastraalobject.identificatie None String
bevatBrkKadastraalobject.volgnummer None Integer
bevatBrkKadastraalobject.beginGeldigheid None Date
bevatBrkKadastraalobject.eindGeldigheid None Date
bestaatUitWozDeelobjecten Bestaat uit deelobjecten Array Relatie naar de deelobjecten
bestaatUitWozDeelobjecten.wozdeelobjectnummer None String
bestaatUitWozDeelobjecten.volgnummer None Integer
bestaatUitWozDeelobjecten.beginGeldigheid None Date
bestaatUitWozDeelobjecten.eindGeldigheid None Date

De volgende query-parameters zijn te gebruiken:

Parameter Autorisatie Mogelijke waarden Werking
beginGeldigheid yyyy-mm-dd Test op exacte waarde (==)
beginGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
beginGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
beginGeldigheid[gt] Test op groter dan (>).
beginGeldigheid[lte] Test op kleiner dan of gelijk (<=).
beginGeldigheid[not] Test of waarde niet overeenkomt (!=).
beginGeldigheid[lt] Test op kleiner dan (<).
beginGeldigheid[gte] Test op groter dan of gelijk (>=).
bestaatUitWozDeelobjecten value1,value2 Test op exacte waarde (==)
bestaatUitWozDeelobjecten[contains] Kommagescheiden lijst Test of er een intersectie is met de waarde.
bestaatUitWozDeelobjecten[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
bestaatUitWozDeelobjecten[not] Test of waarde niet overeenkomt (!=).
bestaatUitWozDeelobjecten[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
bevatBrkKadastraalobject value1,value2 Test op exacte waarde (==)
bevatBrkKadastraalobject[contains] Kommagescheiden lijst Test of er een intersectie is met de waarde.
bevatBrkKadastraalobject[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
bevatBrkKadastraalobject[not] Test of waarde niet overeenkomt (!=).
bevatBrkKadastraalobject[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
eindGeldigheid yyyy-mm-dd Test op exacte waarde (==)
eindGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
eindGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
eindGeldigheid[gt] Test op groter dan (>).
eindGeldigheid[lte] Test op kleiner dan of gelijk (<=).
eindGeldigheid[not] Test of waarde niet overeenkomt (!=).
eindGeldigheid[lt] Test op kleiner dan (<).
eindGeldigheid[gte] Test op groter dan of gelijk (>=).
geldigOp yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]] Test op exacte waarde (==)
id Tekst Test op exacte waarde (==)
id[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
id[isempty] true | false Test of de waarde leeg is (== '' / != '')
id[not] Test of waarde niet overeenkomt (!=).
id[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
registratiedatum yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]] Test op exacte waarde (==)
registratiedatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
registratiedatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
registratiedatum[gt] Test op groter dan (>).
registratiedatum[lte] Test op kleiner dan of gelijk (<=).
registratiedatum[not] Test of waarde niet overeenkomt (!=).
registratiedatum[lt] Test op kleiner dan (<).
registratiedatum[gte] Test op groter dan of gelijk (>=).
volgnummer Geheel getal Test op exacte waarde (==)
volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
volgnummer[gt] Test op groter dan (>).
volgnummer[lte] Test op kleiner dan of gelijk (<=).
volgnummer[not] Test of waarde niet overeenkomt (!=).
volgnummer[lt] Test op kleiner dan (<).
volgnummer[gte] Test op groter dan of gelijk (>=).
wozobjectnummer Tekst Test op exacte waarde (==)
wozobjectnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wozobjectnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wozobjectnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
wozobjectnummer[not] Test of waarde niet overeenkomt (!=).
wozobjectnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.

Insluitbare relaties

De volgende velden kunnen ingesloten worden met ?_expandScope=...:

Relatie Tabel Omschrijving
bestaatUitWozDeelobjecten woz:deelobjecten
bevatBrkKadastraalobject brk2:kadastraleobjecten

Deelobjecten

Autorisatie:
Geen; dit is openbare data.
REST URI:
/v1/woz/deelobjecten
CSV-export:
/v1/woz/deelobjecten?_format=csv
GeoJSON-export:
/v1/woz/deelobjecten?_format=geojson

De volgende velden zijn beschikbaar:

Veld ID Veldnaam Type Identifier Omschrijving
id None String ☑
volgnummer Deelobject volgnummer Integer ☑ Uniek volgnummer van de toestand van het deelobject, gelijk aan volgnummer van WOZ-object
registratiedatum Deelobject registratie datum Datetime Begin geldigheid van een bepaalde combinatie van WOZ- en WOZ-plus-gegevens van een WOZ-object
wozdeelobjectnummer WOZ deelobject ID String ☑ De unieke identificatie van een WOZ-deelobject
deelnummer Deelobject nummer String Nummer van het deelobject binnen het WOZ-object
wozobjectnummer WOZ object ID String De unieke identificatie van een WOZ-object
soortObject Deelobject soort Object Aanduiding van het soort deelobject ten behoeve van een correcte bepaling van de waarde
soortObject.soortObjectCode Deelobject soort code Integer
soortObject.soortObjectOmschrijving Deelobject soort omschrijving String
beginGeldigheid Deelobject geldigheid begindatumtijd Date De ingangsdatum en -tijd van een periode waarin één of meer gegevens die worden bijgehouden over een WOZ-deelobject, een wijziging hebben ondergaan
eindGeldigheid Deelobject geldigheid einddatumtijd Date De einddatum en -tijd van een periode waarin er geen wijzigingen hebben plaatsgevonden in de gegevens die worden bijgehouden over een WOZ-deelobject
isVerbondenMetBagVerblijfsobject Verbonden met verblijfsobject Object (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagVerblijfsobject.identificatie None String (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagVerblijfsobject.volgnummer None Integer (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats Verbonden met ligplaats Object (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats.identificatie None String (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats.volgnummer None Integer (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats Verbonden met standplaats Object (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats.identificatie None String (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats.volgnummer None Integer (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
heeftBagPand Verbonden met pand Object (relatie) De unieke aanduiding van het pand dat deel uitmaakt van het WOZ-deelobject
heeftBagPand.identificatie None String (relatie) De unieke aanduiding van het pand dat deel uitmaakt van het WOZ-deelobject
heeftBagPand.volgnummer None Integer (relatie) De unieke aanduiding van het pand dat deel uitmaakt van het WOZ-deelobject

De volgende query-parameters zijn te gebruiken:

Parameter Autorisatie Mogelijke waarden Werking
beginGeldigheid yyyy-mm-dd Test op exacte waarde (==)
beginGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
beginGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
beginGeldigheid[gt] Test op groter dan (>).
beginGeldigheid[lte] Test op kleiner dan of gelijk (<=).
beginGeldigheid[not] Test of waarde niet overeenkomt (!=).
beginGeldigheid[lt] Test op kleiner dan (<).
beginGeldigheid[gte] Test op groter dan of gelijk (>=).
deelnummer Tekst Test op exacte waarde (==)
deelnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
deelnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
deelnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
deelnummer[not] Test of waarde niet overeenkomt (!=).
deelnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
eindGeldigheid yyyy-mm-dd Test op exacte waarde (==)
eindGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
eindGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
eindGeldigheid[gt] Test op groter dan (>).
eindGeldigheid[lte] Test op kleiner dan of gelijk (<=).
eindGeldigheid[not] Test of waarde niet overeenkomt (!=).
eindGeldigheid[lt] Test op kleiner dan (<).
eindGeldigheid[gte] Test op groter dan of gelijk (>=).
geldigOp yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]] Test op exacte waarde (==)
heeftBagPand.identificatie Tekst Test op exacte waarde (==)
heeftBagPand.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
heeftBagPand.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
heeftBagPand.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
heeftBagPand.identificatie[not] Test of waarde niet overeenkomt (!=).
heeftBagPand.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
heeftBagPand.volgnummer Geheel getal Test op exacte waarde (==)
heeftBagPand.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
heeftBagPand.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
heeftBagPand.volgnummer[gt] Test op groter dan (>).
heeftBagPand.volgnummer[lte] Test op kleiner dan of gelijk (<=).
heeftBagPand.volgnummer[not] Test of waarde niet overeenkomt (!=).
heeftBagPand.volgnummer[lt] Test op kleiner dan (<).
heeftBagPand.volgnummer[gte] Test op groter dan of gelijk (>=).
id Tekst Test op exacte waarde (==)
id[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
id[isempty] true | false Test of de waarde leeg is (== '' / != '')
id[not] Test of waarde niet overeenkomt (!=).
id[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagLigplaats.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagLigplaats.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagLigplaats.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagLigplaats.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagLigplaats.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagLigplaats.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagLigplaats.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagLigplaats.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagLigplaats.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagLigplaats.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagLigplaats.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagLigplaats.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagLigplaats.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagLigplaats.volgnummer[gte] Test op groter dan of gelijk (>=).
isVerbondenMetBagStandplaats.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagStandplaats.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagStandplaats.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagStandplaats.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagStandplaats.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagStandplaats.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagStandplaats.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagStandplaats.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagStandplaats.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagStandplaats.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagStandplaats.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagStandplaats.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagStandplaats.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagStandplaats.volgnummer[gte] Test op groter dan of gelijk (>=).
isVerbondenMetBagVerblijfsobject.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagVerblijfsobject.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagVerblijfsobject.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagVerblijfsobject.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagVerblijfsobject.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagVerblijfsobject.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagVerblijfsobject.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagVerblijfsobject.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagVerblijfsobject.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagVerblijfsobject.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagVerblijfsobject.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagVerblijfsobject.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagVerblijfsobject.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagVerblijfsobject.volgnummer[gte] Test op groter dan of gelijk (>=).
registratiedatum yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]] Test op exacte waarde (==)
registratiedatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
registratiedatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
registratiedatum[gt] Test op groter dan (>).
registratiedatum[lte] Test op kleiner dan of gelijk (<=).
registratiedatum[not] Test of waarde niet overeenkomt (!=).
registratiedatum[lt] Test op kleiner dan (<).
registratiedatum[gte] Test op groter dan of gelijk (>=).
volgnummer Geheel getal Test op exacte waarde (==)
volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
volgnummer[gt] Test op groter dan (>).
volgnummer[lte] Test op kleiner dan of gelijk (<=).
volgnummer[not] Test of waarde niet overeenkomt (!=).
volgnummer[lt] Test op kleiner dan (<).
volgnummer[gte] Test op groter dan of gelijk (>=).
wozdeelobjectnummer Tekst Test op exacte waarde (==)
wozdeelobjectnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wozdeelobjectnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wozdeelobjectnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
wozdeelobjectnummer[not] Test of waarde niet overeenkomt (!=).
wozdeelobjectnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
wozobjectnummer Tekst Test op exacte waarde (==)
wozobjectnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wozobjectnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wozobjectnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
wozobjectnummer[not] Test of waarde niet overeenkomt (!=).
wozobjectnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.

Insluitbare relaties

De volgende velden kunnen ingesloten worden met ?_expandScope=...:

Relatie Tabel Omschrijving
heeftBagPand bag:panden Een PAND is de kleinste bij de totstandkoming functioneel en bouwkundig-constructief zelfstandige eenheid die direct en duurzaam met de aarde is verbonden en betreedbaar en afsluitbaar is.
isVerbondenMetBagLigplaats bag:ligplaatsen Een LIGPLAATS is een door het bevoegde gemeentelijke orgaan als zodanig aangewezen plaats in het water die bestemd is voor het permanent afmeren van een voor woon-, bedrijfsmatige of recreatieve doeleinden geschikt drijvend object
isVerbondenMetBagStandplaats bag:standplaatsen
isVerbondenMetBagVerblijfsobject bag:verblijfsobjecten Een VERBLIJFSOBJECT is de kleinste binnen één of meer panden gelegen en voor woon -, bedrijfsmatige, of recreatieve doeleinden geschikte eenheid van gebruik die ontsloten wordt via een eigen afsluitbare toegang vanaf de openbare weg, een erf of een gedeelde verkeersruimte, onderwerp kan zijn van goederenrechtelijke rechtshandelingen en in functioneel opzicht zelfstandig is