🇳🇱
Altum AI
StartPlatformMonitorAltum AIContact
Nederlands
Nederlands
  • Altum AI API documentatie
  • Platform
    • Maandabonnementen
    • Jaarabonnementen
    • Onbeperkt gebruik abonnementen
    • Kadaster Transactie API abonnement
    • Changelog
  • Updates
  • Ontwikkelaars
    • Voer de eerste API-call uit
    • Sandbox
    • OpenAPI specificaties
    • API status
    • Credit API
  • Altum AI website
  • Tarieven
  • Vastgoed AI
    • Authenticatie, invoer en resultaat
    • Veelgestelde vragen (FAQ)
  • API's
    • Woningwaarde API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Accuratesse Indicator
      • Huisnummers & toevoegingen
      • Woningtypes
      • Parameters
      • Resultaat interpretatie
      • Veelgestelde vragen (FAQ)
    • Woningwaarde+ API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Huisnummers, letters & toevoegingen
      • Energielabel en binnen- en buitenoppervlakte
      • Resultaat interpretatie
    • Vraagprijs API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Huisnummers, letters & toevoegingen
      • Energielabel en binnen- en buitenoppervlakte
      • Resultaat interpretatie
    • Verduurzaming API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Energielabel
      • Advies verbeteren
      • Voorbeeld API verzoeken
      • Resultaat interpretatie
      • Energiekosten
      • Maatregelen uitsluiten
      • Zoekcriteria
      • Maatregelen
      • Isolatie waardes
      • Comfort score
      • CO2
      • Dekking
      • Kostentabel invoer
      • Veelgestelde vragen (FAQ)
    • NTA 8800 Energielabel API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • EPC API
      • Changelog
      • API-sleutel Informatie
      • Authenticatie, invoer en resultaat
      • Resultaat interpretatie
    • Energielabel inzichten API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • WOZ API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
      • Veelgestelde vragen (FAQ)
      • PC6 gemiddelde WOZ waarde
    • Interactieve woningreferentie API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Visueel vergelijkbare woningen zoeken
      • Woningtypes
      • Vergelijkend zoeken functies
      • Resultaat interpretatie
    • Kadaster Transactie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Woningkenmerken API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Gebouw geometrie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Energie & klimaat API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Conditie score API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Foto Labelen API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Autosearch API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
    • Autosuggestie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Fuzzy Search Support
      • Resultaat interpretatie
    • Verhuisdata API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Locatie-gegevens API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Woningtypes
      • Resultaat interpretatie
    • Huurreferentie API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Herbouwwaarde API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Zonnepanelen dakenscan API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • WWS Punten API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Specificaties voor een zelfstandige woning versie 01-01-2024
      • Specificaties voor een zelfstandige woning versie 01-07-2024
      • Specificaties niet-zelfstandige woning versie 01-01-2024
      • Resultaat interpretatie
      • Specificaties voor een niet-zelfstandige woning versie 01-07-2024
      • Inputuitleg voor versie 01-07-2024
  • API error codes
    • 429
    • 422
    • 403
Powered by GitBook
On this page
  • Verstuur adresgegevens om waardes op te vragen
  • Ontvang WOZ-waardes met een BAGID verzoek
  • GRATIS Ping voor beschikbaarheid
  • Plaats objectgegevens om de beschikbaarheid van WOZ-waarden te ontvangen
  • Request body
  • Vraag aanvraag aan
  1. API's
  2. WOZ API

Authenticatie, invoer en resultaat

Verstuur adresgegevens om waardes op te vragen

POST https://api.altum.ai/woz

This endpoint allows you to get the latest WOZ values from our database. A POST request requires a body parameter(Address).

Headers

Name
Type
Description

Content-Type

string

application/json

x-api-key*

string

Unieke API-sleutel van Altum. Maak er een via Mopsus(https://mopsus.altum.ai)

Request Body

Name
Type
Description

postcode*

string

Postcode van het object

housenumber*

string

Huisnummer van het object

addition

string

Huisnummertoevoeging

index

boolean

Met 1 voegt u een ‘IndexedValue’ toe aan de laatst beschikbare WOZ-waarde geïndexeerd met de Kadasterindex naar de huidige maand. Standaard = 0

cache

boolean

Gebruik 0 om het ophalen uit de cache te overschrijven en een liveverzoek uit te voeren. Standaard = 1

{
	"Output": {
		"BagID": "499010002023718",
		"PostCode": "2771DS",
		"HouseNumber": "87",
		"HouseAddition": null,
		"HouseAddress": "2771DS-87-",
		"City": "Boskoop",
		"Street": "Zuidkade",
		"HouseType": "woonfunctie",
		"BuildYear": 1961,
		"OuterSurfaceArea": 1605,
		"Longitude": 4.65808526945334,
		"Latitude": 52.068393816655316,
		"WOZ-source_date": "2023-03-21",
		"wozvalue": [
			{
				"Date": "01-01-2022",
				"Value": "630000",
				"IndexedValue": "644942"
			},
			{
				"Date": "01-01-2021",
				"Value": "551000"
			},
			{
				"Date": "01-01-2020",
				"Value": "518000"
			},
			{
				"Date": "01-01-2019",
				"Value": "498000"
			},
			{
				"Date": "01-01-2018",
				"Value": "490000"
			},
			{
				"Date": "01-01-2017",
				"Value": "469000"
			},
			{
				"Date": "01-01-2016",
				"Value": "430000"
			}
		]
	}
}
{
  "detail": {
    "Output": "The combination of postcode, house number and house addition  does not exist or have no WOZ."
  }
}
{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}
{
	"message": "Internal server error"
}
{
  "detail": [
    {
      "loc": [
        "body",
        "postcode"
      ],
      "msg": "Unsupported postcode length, it should be six.",
      "type": "value_error"
    }
  ]
}
API key limit exceeded

Ontvang WOZ-waardes met een BAGID verzoek

GET https://api.altum.ai/woz?bag_id={bag_id}

This endpoint responds with the latest WOZ values from our database. The GET Method requires a query parameter(bag_id) with the value being the actual 16-character BAGID.

Query Parameters

Name
Type
Description

bag_id*

string

BAG-ID van 16 cijfers"0402010001567022"

Headers

Name
Type
Description

Content-Type

string

application/json

x-api-key*

string

API-sleutel van Altum. Maak er een via Mopsus(https://mopsus.altum.ai)

{
  "Output": {
    "BagID": "0622010000065935",
    "PostCode": "3136KZ",
    "HouseNumber": "832",
    "HouseAddition": null,
    "HouseAddress": "3136KZ-832-",
    "City": "Vlaardingen",
    "Street": "Aalscholverlaan",
    "HouseType": "woonfunctie",
    "BuildYear": 1969,
    "OuterSurfaceArea": 1412,
    "Longitude": 4.350730676835097,
    "Latitude": 51.93255387951979,
    "WOZ-source_date": "2020-12-22",
    "wozvalue": [
      {
        "Date": "01-01-2019",
        "Value": 157000
      },
      {
        "Date": "01-01-2018",
        "Value": 133000
      },
      {
        "Date": "01-01-2017",
        "Value": 122000
      },
      {
        "Date": "01-01-2016",
        "Value": 122000
      },
      {
        "Date": "01-01-2015",
        "Value": 122000
      },
      {
        "Date": "01-01-2014",
        "Value": 132000
      }
    ]
  }
}
{
	"detail": [
		{
			"loc": [
				"query",
				"bag_id"
			],
			"msg": "ensure this value has at least 16 characters",
			"type": "value_error.any_str.min_length",
			"ctx": {
				"limit_value": 16
			}
		}
	]
}
{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}
{
	"message": "Internal server error"
}
{
  "detail": [
    {
      "loc": [
        "body",
        "postcode"
      ],
      "msg": "Unsupported postcode length, it should be six.",
      "type": "value_error"
    }
  ]
}
API key limit exceeded

Voor POST verzoeken: stel cache in op 0 om nieuwe, realtime waarden op te halen uit de cache als bron. Let op: dit kan van invloed zijn op de laadtijd.

GRATIS Ping voor beschikbaarheid

Plaats objectgegevens om de beschikbaarheid van WOZ-waarden te ontvangen

POST https://api.altum.ai/woz/ping

Met dit eindpunt kunt u de beschikbaarheid van de nieuwste WOZ-waarden uit onze database opvragen. Voor een POST-verzoek is een bodyparameter (Adres) vereist.

Headers

Name
Type
Description

Content-Type

string

application/json

x-api-key*

string

API-sleutel van Altum. Maak er een via Mopsus(https://mopsus.altum.ai)

Request Body

Name
Type
Description

postcode*

string

Postcode van het object

housenumber*

string

Huisnummer van het object

addition

string

Huisnummertoevoeging

index

boolean

Met 1 voegt u een ‘IndexedValue’ toe aan de laatst beschikbare WOZ-waarde geïndexeerd met de Kadasterindex naar de huidige maand. Standaard = 0

cache

boolean

Gebruik 0 om het ophalen uit de cache te overschrijven en een liveverzoek uit te voeren. Standaard = 1

{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}
{
	"message": "Internal server error"
}
{ 
        "Output": "WOZ data for 1616EG-130- is available.", 
        "Latest Date": "01-01-2021" 
} 
{
  "detail": [
    {
      "loc": [
        "body",
        "postcode"
      ],
      "msg": "Unsupported postcode length, it should be six.",
      "type": "value_error"
    }
  ]
}

Request body

Voorbeeld verzoek

{
  "postcode": "2771DS",
  "housenumber": "87",
  "addition": "",
  "index": 1,
  "cache": 0
}

Vraag aanvraag aan

Voorbeeld verzoek

https://api.altum.ai/woz?bag_id=0402010001567022
PreviousChangelogNextAPI-sleutel Informatie

Last updated 6 months ago