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:
None
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:

Veldnaam Type Identifier Omschrijving
id String ☑
volgnummer Integer ☑ Uniek volgnummer van de toestand van het object
registratiedatum Datetime De datum waarop de toestand van het object is geregistreerd
wozobjectnummer String ☑ De unieke identificatie van een 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 Integer
gebruik.gebruikOmschrijving String
soortObject Object Aanduiding van het soort WOZ-object ten behoeve van een correcte bepaling van de waarde
soortObject.soortObjectCode Integer
soortObject.soortObjectOmschrijving String
beginGeldigheid Date De begindatum van een periode waarin één of meer gegevens die worden bijgehouden over een WOZ-object, een wijziging hebben ondergaan
eindGeldigheid Date De einddatum van een periode waarin één of meer gegevens die worden bijgehouden over een WOZ-object, een wijziging hebben ondergaan
bevatBrkKadastraalobject Array Relatie naar kadastraal object
bevatBrkKadastraalobject.identificatie String
bevatBrkKadastraalobject.volgnummer Integer
bevatBrkKadastraalobject.beginGeldigheid Date
bevatBrkKadastraalobject.eindGeldigheid Date
bestaatUitWozDeelobjecten Array Relatie naar de deelobjecten
bestaatUitWozDeelobjecten.wozdeelobjectnummer String
bestaatUitWozDeelobjecten.volgnummer Integer
bestaatUitWozDeelobjecten.beginGeldigheid Date
bestaatUitWozDeelobjecten.eindGeldigheid Date

De volgende query-parameters zijn te gebruiken:

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

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:

Veldnaam Type Identifier Omschrijving
id String ☑
volgnummer Integer ☑ Uniek volgnummer van de toestand van het deelobject, gelijk aan volgnummer van WOZ-object
registratiedatum Datetime De datum waarop de toestand van het deelobject is geregistreerd
wozdeelobjectnummer String ☑ De unieke identificatie van een WOZ-deelobject
deelnummer String Nummer van het deelobject binnen het WOZ-object
wozobjectnummer String De unieke identificatie van een WOZ-object, waar dit deelobject onderdeel van is
soortObject Object Aanduiding van het soort deelobject ten behoeve van een correcte bepaling van de waarde
soortObject.soortObjectCode Integer
soortObject.soortObjectOmschrijving String
beginGeldigheid Date De begindatum van een periode waarin één of meer gegevens die worden bijgehouden over een deelobject, een wijziging hebben ondergaan
eindGeldigheid Date De einddatum van een periode waarin één of meer gegevens die worden bijgehouden over een deelobject, een wijziging hebben ondergaan
isVerbondenMetBagVerblijfsobject Object (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagVerblijfsobject.identificatie String (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagVerblijfsobject.volgnummer Integer (relatie) De unieke aanduiding van het verblijfsobject dat deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats Object (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats.identificatie String (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagLigplaats.volgnummer Integer (relatie) De unieke aanduiding van de ligplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats Object (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats.identificatie String (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
isVerbondenMetBagStandplaats.volgnummer Integer (relatie) De unieke aanduiding van de standplaats die deel uitmaakt van het WOZ-deelobject
heeftBagPand Object (relatie) De unieke aanduiding van het pand dat deel uitmaakt van het WOZ-deelobject
heeftBagPand.identificatie String (relatie) De unieke aanduiding van het pand dat deel uitmaakt van het WOZ-deelobject
heeftBagPand.volgnummer 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[lt] Test op kleiner dan (<).
beginGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
beginGeldigheid[not] Test of waarde niet overeenkomt (!=).
beginGeldigheid[lte] Test op kleiner dan of gelijk (<=).
beginGeldigheid[gt] Test op groter dan (>).
beginGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
beginGeldigheid[gte] Test op groter dan of gelijk (>=).
deelnummer Tekst Test op exacte waarde (==)
deelnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
deelnummer[not] Test of waarde niet overeenkomt (!=).
deelnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
deelnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
deelnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
eindGeldigheid yyyy-mm-dd Test op exacte waarde (==)
eindGeldigheid[lt] Test op kleiner dan (<).
eindGeldigheid[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
eindGeldigheid[not] Test of waarde niet overeenkomt (!=).
eindGeldigheid[lte] Test op kleiner dan of gelijk (<=).
eindGeldigheid[gt] Test op groter dan (>).
eindGeldigheid[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
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[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
heeftBagPand.identificatie[not] Test of waarde niet overeenkomt (!=).
heeftBagPand.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
heeftBagPand.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
heeftBagPand.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
heeftBagPand.volgnummer Geheel getal Test op exacte waarde (==)
heeftBagPand.volgnummer[lt] Test op kleiner dan (<).
heeftBagPand.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
heeftBagPand.volgnummer[not] Test of waarde niet overeenkomt (!=).
heeftBagPand.volgnummer[lte] Test op kleiner dan of gelijk (<=).
heeftBagPand.volgnummer[gt] Test op groter dan (>).
heeftBagPand.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
heeftBagPand.volgnummer[gte] Test op groter dan of gelijk (>=).
id Tekst Test op exacte waarde (==)
id[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
id[not] Test of waarde niet overeenkomt (!=).
id[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
id[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagLigplaats.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagLigplaats.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagLigplaats.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagLigplaats.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagLigplaats.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagLigplaats.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagLigplaats.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagLigplaats.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagLigplaats.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagLigplaats.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagLigplaats.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagLigplaats.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagLigplaats.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagLigplaats.volgnummer[gte] Test op groter dan of gelijk (>=).
isVerbondenMetBagStandplaats.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagStandplaats.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagStandplaats.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagStandplaats.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagStandplaats.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagStandplaats.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagStandplaats.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagStandplaats.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagStandplaats.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagStandplaats.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagStandplaats.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagStandplaats.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagStandplaats.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagStandplaats.volgnummer[gte] Test op groter dan of gelijk (>=).
isVerbondenMetBagVerblijfsobject.identificatie Tekst Test op exacte waarde (==)
isVerbondenMetBagVerblijfsobject.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagVerblijfsobject.identificatie[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagVerblijfsobject.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
isVerbondenMetBagVerblijfsobject.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
isVerbondenMetBagVerblijfsobject.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
isVerbondenMetBagVerblijfsobject.volgnummer Geheel getal Test op exacte waarde (==)
isVerbondenMetBagVerblijfsobject.volgnummer[lt] Test op kleiner dan (<).
isVerbondenMetBagVerblijfsobject.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
isVerbondenMetBagVerblijfsobject.volgnummer[not] Test of waarde niet overeenkomt (!=).
isVerbondenMetBagVerblijfsobject.volgnummer[lte] Test op kleiner dan of gelijk (<=).
isVerbondenMetBagVerblijfsobject.volgnummer[gt] Test op groter dan (>).
isVerbondenMetBagVerblijfsobject.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
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[lt] Test op kleiner dan (<).
registratiedatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
registratiedatum[not] Test of waarde niet overeenkomt (!=).
registratiedatum[lte] Test op kleiner dan of gelijk (<=).
registratiedatum[gt] Test op groter dan (>).
registratiedatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
registratiedatum[gte] Test op groter dan of gelijk (>=).
volgnummer Geheel getal Test op exacte waarde (==)
volgnummer[lt] Test op kleiner dan (<).
volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
volgnummer[not] Test of waarde niet overeenkomt (!=).
volgnummer[lte] Test op kleiner dan of gelijk (<=).
volgnummer[gt] Test op groter dan (>).
volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
volgnummer[gte] Test op groter dan of gelijk (>=).
wozdeelobjectnummer Tekst Test op exacte waarde (==)
wozdeelobjectnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wozdeelobjectnummer[not] Test of waarde niet overeenkomt (!=).
wozdeelobjectnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
wozdeelobjectnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wozdeelobjectnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
wozobjectnummer Tekst Test op exacte waarde (==)
wozobjectnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wozobjectnummer[not] Test of waarde niet overeenkomt (!=).
wozobjectnummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
wozobjectnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wozobjectnummer[isempty] true | false Test of de waarde leeg is (== '' / != '')

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