# WOZ API

{% hint style="success" %}
WOZ API for requesting current WOZ values.
{% endhint %}

## Introduction

Every year, every municipality determines the value of houses, business premises, shops, and unbuilt plots. This value is called the WOZ(**Waardering Onroerende Zaken**) value. The municipality uses the WOZ value to determine the amount of taxes. With WOZ API, Altum AI creates a unique and simple modus operandi for retrieving WOZ Values ​​for homes and properties in the Netherlands. The source of the WOZ values is the official WOZ Website. This model will provide values for properties with either BAGID or House address as long their WOZ Values exist on the WOZ Website. The WOZ API also provides other details in its response like the Build Year, Coordinates, Purpose of property, etc.

## How to use

For the WOZ API to be able to deliver the WOZ value and object details, the object details such as the zip code and house number or BagID has to be present.  

Depending on the object and input, we generate a response. This response covers the details about the property such as the address, building type, building year, outer surface area, and other correlating information.

{% hint style="info" %}

### Index

Using `"index": 1`  in the request will add an indexed value, based on the Kadaster index, to the latest available WOZ value. Default = 0.
{% endhint %}

{% hint style="info" %}

### Cache

Using `"cache": 0` in the request will trigger a live API call overriding the cache. Default = 1.
{% endhint %}

## POST Method

![WOZ API POST Method Illustration](https://1172273446-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lw4gk5ARKsgVHFCdPZw%2F-MPP4TS5yhxIdIcc8Gdt%2F-MPP8bKp1WXU-RHx1E3L%2FWOZ-API%20-%20POST%20Method.png?alt=media\&token=b10eaa02-6d28-4418-b58b-176e3d4c5d5e)

## GET Method

![WOZ API GET Method Illustration](https://1172273446-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lw4gk5ARKsgVHFCdPZw%2F-MPP4TS5yhxIdIcc8Gdt%2F-MPP9MTthvRUY-hZ3xVj%2FWOZ-API-GET%20METHOD.png?alt=media\&token=7396c023-c3ea-4b10-99a3-b34e7af7b6e7)

## Up next:

{% content-ref url="woz-api/authentication-input-and-response" %}
[authentication-input-and-response](https://docs.altum.ai/english/property-data/woz-api/authentication-input-and-response)
{% endcontent-ref %}