# Woningwaarde+ API

Wanneer u naast een accurate woningwaarde ook geïnteresseerd bent in de achterliggende data, bijvoorbeeld omdat u zelf een rapport samen wilt stellen voor uw klanten of een diepere analyse wilt doen op de prijs, dan is deze API geschikt voor u. U krijgt niet alleen uitgebreide informatie over het object zelf, maar u krijgt ook toegang tot de drie best vergelijkbare woningen inclusief de meest recente transactieprijzen.

### Voor wie is het?

* U wilt diepere analyses doen op de waarde van een object
* U wilt data hebben om een rapport te vullen voor uw cliënten
* Toegang tot onderbouwing van de waarde is belangrijk voor u

### Wat moet ik weten?

* Het Matrixian AVM is gerenommeerd en wordt gebruikt door verschillende brancheorganisaties in de taxatie- en makelaarswereld
* Het model wordt continu beoordeeld en verbeterd zodat we nooit achterlopen op de markt en u zeker bent van betrouwbare informatie
* Locatie, locatie, locatie! Prijstrends, referentieverkopen en gebiedskenmerken worden allemaal meegenomen in het model

## GET /homevalue

> Returns the predicted market value and related information.

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"0.0.1"},"servers":[{"url":"https://api.matrixian.com/v1","description":"Matrixian API"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"{{API_KEY}}"}},"schemas":{"HomeValueInput":{"properties":{"postalCode":{"type":"string","title":"Postalcode","description":"Postal code"},"houseNumber":{"type":"integer","title":"Housenumber","description":"House number"},"houseLetter":{"title":"Houseletter","description":"House letter","type":"string","nullable":true},"houseNumberExt":{"title":"Housenumberext","description":"House number extension","type":"string","nullable":true},"buildType":{"description":"Type of dwelling","allOf":[{"$ref":"#/components/schemas/HouseType"}]},"buildYear":{"type":"integer","title":"Buildyear","description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year."},"useSurface":{"type":"integer","title":"Usesurface","description":"The usable surface area of a property object in m2."},"parcelSurface":{"title":"Parcelsurface","description":"The lot/parcel surface in m2.","type":"integer","nullable":true},"volume":{"title":"Volume","description":"Volume in m3.","type":"integer","nullable":true},"numberOfRooms":{"title":"Numberofrooms","description":"Number of rooms.","type":"integer","nullable":true},"energyLabel":{"description":"A label indicating how well the property object is insulated.","$ref":"#/components/schemas/EnergyLabel","nullable":true},"monument":{"title":"Monument","description":"Boolean indicating whether the house is a monument.","default":false,"type":"boolean","nullable":true},"valuationDate":{"type":"string","format":"date","title":"Valuationdate","description":"Valuation date","default":"2026-05-12"}},"type":"object","required":["postalCode","houseNumber","buildType","buildYear","useSurface"],"title":"HomeValueInput"},"HouseType":{"type":"string","enum":["Appartement","Galerijflat","Maisonnette","Portiekwoning","Portiekflat","Corridorflat","Bovenwoning","Benedenwoning","Tussenwoning","Geschakelde woning","Eindwoning","Hoekwoning","2-onder-1-kapwoning","Geschakelde 2-onder-1-kapwoning","Halfvrijstaande woning","Vrijstaande woning"],"title":"HouseType"},"EnergyLabel":{"type":"string","enum":["A+++++","A++++","A+++","A++","A+","A","B","C","D","E","F","G"],"title":"EnergyLabel"},"HomevalueResponse":{"properties":{"houseNumber":{"type":"integer","title":"Housenumber","description":"House number"},"houseNumberExt":{"title":"Housenumberext","description":"House number extension","type":"string","nullable":true},"postalCode":{"type":"string","title":"Postalcode","description":"Postal code"},"street":{"type":"string","title":"Street","description":"Street name"},"city":{"type":"string","title":"City","description":"City"},"municipality":{"type":"string","title":"Municipality","description":"Municipality name"},"state":{"type":"string","title":"State","description":"Province/state"},"country":{"type":"string","title":"Country","description":"Country"},"bagId":{"type":"string","title":"Bagid","description":"Identification number according to the BAG."},"energyLabel":{"title":"Energylabel","description":"A label indicating how well the property object is insulated.","type":"string","nullable":true},"rooms":{"title":"Rooms","description":"Number of rooms","type":"integer","nullable":true},"monument":{"title":"Monument","description":"Boolean indicating whether the house is a monument.","type":"boolean","nullable":true},"valueDate":{"type":"string","format":"date","title":"Valuedate","description":"Valuation date"},"indexedPrice":{"title":"Indexedprice","description":"The transaction price of the most recent historical sale, indexed to the valuation date.","type":"integer","nullable":true},"buildYear":{"title":"Buildyear","description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","type":"integer","nullable":true},"inputBuildYear":{"title":"Inputbuildyear","description":"Build year as inputted by the user.","type":"integer","nullable":true},"useSurface":{"title":"Usesurface","description":"The usable surface area of a property object in square meters.","type":"integer","nullable":true},"inputUseSurface":{"title":"Inputusesurface","description":"Use surface as inputted by the user.","type":"integer","nullable":true},"volume":{"title":"Volume","description":"Volume in cubic meters.","type":"integer","nullable":true},"parcelSurface":{"title":"Parcelsurface","description":"The lot/parcel surface in m2.","type":"integer","nullable":true},"inputParcelSurface":{"title":"Inputparcelsurface","description":"Parcel surface as inputted by the user.","type":"integer","nullable":true},"buildType":{"title":"Buildtype","description":"Dwelling type","type":"string","nullable":true},"inputBuildType":{"title":"Inputbuildtype","description":"Dwelling type as inputted by the user.","type":"string","nullable":true},"predictedValue":{"type":"integer","title":"Predictedvalue","description":"Automated valuation model (AVM) estimate of the property value."},"accuracy":{"title":"Accuracy","description":"Accuracy indicator of the valuation model (0–100).","type":"number","nullable":true},"confidenceClass":{"title":"Confidenceclass","description":"Confidence class of the valuation (5 = highest confidence, 0 = lowest confidence).","type":"integer","nullable":true},"histTransactionPrice":{"title":"Histtransactionprice","description":"Most recent historical transaction price of the property.","type":"integer","nullable":true},"histTransactionDate":{"title":"Histtransactiondate","description":"Date of the most recent historical transaction of the property.","type":"string","format":"date","nullable":true},"references":{"items":{"$ref":"#/components/schemas/ReferenceObjectModel"},"type":"array","title":"References","description":"List of comparable reference objects that support the valuation."},"weightedValue":{"type":"integer","title":"Weightedvalue","description":"Automated valuation model (AVM) estimate of the property value OR indexed transaction price or WOZ value when that's a better estimate."},"numZipAllTypes":{"title":"Numzipalltypes","description":"Number of transactions in the same postal code area across all dwelling types.","type":"integer","nullable":true},"medZipAllTypes":{"title":"Medzipalltypes","description":"Median transaction price in the same postal code area across all dwelling types.","type":"integer","nullable":true},"numZipSameType":{"title":"Numzipsametype","description":"Number of transactions in the same postal code area for the same dwelling type.","type":"integer","nullable":true},"medZipSameType":{"title":"Medzipsametype","description":"Median transaction price in the same postal code area for the same dwelling type.","type":"integer","nullable":true},"numStrAllTypes":{"title":"Numstralltypes","description":"Number of transactions on the same street across all dwelling types.","type":"integer","nullable":true},"medStrAllTypes":{"title":"Medstralltypes","description":"Median transaction price on the same street across all dwelling types.","type":"integer","nullable":true},"numStrSameType":{"title":"Numstrsametype","description":"Number of transactions on the same street for the same dwelling type.","type":"integer","nullable":true},"medStrSameType":{"title":"Medstrsametype","description":"Median transaction price on the same street for the same dwelling type.","type":"integer","nullable":true}},"type":"object","required":["houseNumber","postalCode","street","city","municipality","state","country","bagId","valueDate","predictedValue","references","weightedValue"],"title":"HomevalueResponse"},"ReferenceObjectModel":{"properties":{"amount":{"description":"Transaction price of the reference object.","title":"Amount","type":"integer"},"bagId":{"description":"Identification number according to the BAG.","title":"Bagid","type":"string"},"buildType":{"description":"Dwelling type","title":"Buildtype","type":"string"},"buildYear":{"description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","title":"Buildyear","type":"integer"},"buildYearCat":{"default":null,"description":"Build year category (construction period range).","title":"Buildyearcat","type":"string","nullable":true},"city":{"description":"City","title":"City","type":"string"},"date":{"format":"date","title":"Date","type":"string"},"distance":{"description":"Distance of the reference object from the valuation object in meter.","title":"Distance","type":"number"},"equality":{"default":null,"description":"Equality score reflecting the comparability of this reference object to the valuation object.","title":"Equality","type":"number","nullable":true},"houseNumber":{"description":"House number","title":"Housenumber","type":"integer"},"houseNumberExt":{"default":null,"description":"House number extension","title":"Housenumberext","type":"string","nullable":true},"indexedPrice":{"default":null,"description":"Transaction price of the reference object, indexed to the valuation date.","title":"Indexedprice","type":"integer","nullable":true},"monument":{"default":null,"description":"Boolean indicating whether the house is a monument.","title":"Monument","type":"boolean","nullable":true},"parcelSurface":{"default":null,"description":"The lot/parcel surface in m2.","title":"Parcelsurface","type":"integer","nullable":true},"postalCode":{"description":"Postal code","title":"Postalcode","type":"string"},"state":{"description":"State","title":"State","type":"string"},"street":{"description":"Street name","title":"Street","type":"string"},"useSurface":{"description":"The usable surface area of a property object in square meters.","title":"Usesurface","type":"integer"},"volume":{"default":null,"description":"Volume in m3.","title":"Volume","type":"integer","nullable":true}},"required":["amount","bagId","buildType","buildYear","city","date","distance","houseNumber","postalCode","state","street","useSurface"],"title":"ReferenceObjectModel","type":"object"},"ErrorObject":{"properties":{"code":{"type":"integer","title":"Code"},"message":{"type":"string","title":"Message"},"errors":{"items":{"$ref":"#/components/schemas/ErrorDetail"},"type":"array","title":"Errors"}},"type":"object","required":["code","message","errors"],"title":"ErrorObject"},"ErrorDetail":{"properties":{"reason":{"type":"string","title":"Reason"},"message":{"type":"string","title":"Message"}},"type":"object","required":["reason","message"],"title":"ErrorDetail"}}},"paths":{"/homevalue":{"get":{"description":"Returns the predicted market value and related information.","operationId":"homevalue","parameters":[{"description":"Postal code","required":true,"style":"form","explode":true,"schema":{"type":"string"},"name":"postalCode","in":"query"},{"description":"House number","required":true,"style":"form","explode":true,"schema":{"type":"integer"},"name":"houseNumber","in":"query"},{"description":"House letter","required":false,"style":"form","explode":true,"schema":{"type":"string"},"name":"houseLetter","in":"query"},{"description":"House number extension","required":false,"style":"form","explode":true,"schema":{"type":"string"},"name":"houseNumberExt","in":"query"},{"description":"Type of dwelling","required":true,"style":"form","explode":true,"schema":{"type":"string","enum":["Appartement","Galerijflat","Maisonnette","Portiekwoning","Portiekflat","Corridorflat","Bovenwoning","Benedenwoning","Tussenwoning","Geschakelde woning","Eindwoning","Hoekwoning","2-onder-1-kapwoning","Geschakelde 2-onder-1-kapwoning","Halfvrijstaande woning","Vrijstaande woning"]},"name":"buildType","in":"query"},{"description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","required":true,"style":"form","explode":true,"schema":{"type":"integer"},"name":"buildYear","in":"query"},{"description":"The usable surface area of a property object in m2.","required":true,"style":"form","explode":true,"schema":{"type":"integer"},"name":"useSurface","in":"query"},{"description":"The lot/parcel surface in m2.","required":false,"style":"form","explode":true,"schema":{"type":"integer"},"name":"parcelSurface","in":"query"},{"description":"Volume in m3.","required":false,"style":"form","explode":true,"schema":{"type":"integer"},"name":"volume","in":"query"},{"description":"Number of rooms.","required":false,"style":"form","explode":true,"schema":{"type":"integer"},"name":"numberOfRooms","in":"query"},{"description":"A label indicating how well the property object is insulated.","required":false,"style":"form","explode":true,"schema":{"type":"string","enum":["A+++++","A++++","A+++","A++","A+","A","B","C","D","E","F","G"]},"name":"energyLabel","in":"query"},{"description":"Boolean indicating whether the house is a monument.","required":false,"style":"form","explode":true,"schema":{"type":"boolean","default":false},"name":"monument","in":"query"},{"description":"Valuation date","required":false,"style":"form","explode":true,"schema":{"type":"string","format":"date","default":"2026-05-12"},"name":"valuationDate","in":"query"}],"responses":{"200":{"description":"HomevalueResponse","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/HomeValueInput"},"data":{"$ref":"#/components/schemas/HomevalueResponse"},"error":{"additionalProperties":{"type":"string"},"type":"object"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["data","status"]}}}},"400":{"description":"HTTP 400","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/HomeValueInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"401":{"description":"HTTP 401","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/HomeValueInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"403":{"description":"HTTP 403","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object","required":["message"]}}}},"404":{"description":"HTTP 404","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/HomeValueInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"500":{"description":"HTTP 500","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/HomeValueInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}}}}}}}
```

## The HomevalueResponse object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"0.0.1"},"components":{"schemas":{"HomevalueResponse":{"properties":{"houseNumber":{"type":"integer","title":"Housenumber","description":"House number"},"houseNumberExt":{"title":"Housenumberext","description":"House number extension","type":"string","nullable":true},"postalCode":{"type":"string","title":"Postalcode","description":"Postal code"},"street":{"type":"string","title":"Street","description":"Street name"},"city":{"type":"string","title":"City","description":"City"},"municipality":{"type":"string","title":"Municipality","description":"Municipality name"},"state":{"type":"string","title":"State","description":"Province/state"},"country":{"type":"string","title":"Country","description":"Country"},"bagId":{"type":"string","title":"Bagid","description":"Identification number according to the BAG."},"energyLabel":{"title":"Energylabel","description":"A label indicating how well the property object is insulated.","type":"string","nullable":true},"rooms":{"title":"Rooms","description":"Number of rooms","type":"integer","nullable":true},"monument":{"title":"Monument","description":"Boolean indicating whether the house is a monument.","type":"boolean","nullable":true},"valueDate":{"type":"string","format":"date","title":"Valuedate","description":"Valuation date"},"indexedPrice":{"title":"Indexedprice","description":"The transaction price of the most recent historical sale, indexed to the valuation date.","type":"integer","nullable":true},"buildYear":{"title":"Buildyear","description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","type":"integer","nullable":true},"inputBuildYear":{"title":"Inputbuildyear","description":"Build year as inputted by the user.","type":"integer","nullable":true},"useSurface":{"title":"Usesurface","description":"The usable surface area of a property object in square meters.","type":"integer","nullable":true},"inputUseSurface":{"title":"Inputusesurface","description":"Use surface as inputted by the user.","type":"integer","nullable":true},"volume":{"title":"Volume","description":"Volume in cubic meters.","type":"integer","nullable":true},"parcelSurface":{"title":"Parcelsurface","description":"The lot/parcel surface in m2.","type":"integer","nullable":true},"inputParcelSurface":{"title":"Inputparcelsurface","description":"Parcel surface as inputted by the user.","type":"integer","nullable":true},"buildType":{"title":"Buildtype","description":"Dwelling type","type":"string","nullable":true},"inputBuildType":{"title":"Inputbuildtype","description":"Dwelling type as inputted by the user.","type":"string","nullable":true},"predictedValue":{"type":"integer","title":"Predictedvalue","description":"Automated valuation model (AVM) estimate of the property value."},"accuracy":{"title":"Accuracy","description":"Accuracy indicator of the valuation model (0–100).","type":"number","nullable":true},"confidenceClass":{"title":"Confidenceclass","description":"Confidence class of the valuation (5 = highest confidence, 0 = lowest confidence).","type":"integer","nullable":true},"histTransactionPrice":{"title":"Histtransactionprice","description":"Most recent historical transaction price of the property.","type":"integer","nullable":true},"histTransactionDate":{"title":"Histtransactiondate","description":"Date of the most recent historical transaction of the property.","type":"string","format":"date","nullable":true},"references":{"items":{"$ref":"#/components/schemas/ReferenceObjectModel"},"type":"array","title":"References","description":"List of comparable reference objects that support the valuation."},"weightedValue":{"type":"integer","title":"Weightedvalue","description":"Automated valuation model (AVM) estimate of the property value OR indexed transaction price or WOZ value when that's a better estimate."},"numZipAllTypes":{"title":"Numzipalltypes","description":"Number of transactions in the same postal code area across all dwelling types.","type":"integer","nullable":true},"medZipAllTypes":{"title":"Medzipalltypes","description":"Median transaction price in the same postal code area across all dwelling types.","type":"integer","nullable":true},"numZipSameType":{"title":"Numzipsametype","description":"Number of transactions in the same postal code area for the same dwelling type.","type":"integer","nullable":true},"medZipSameType":{"title":"Medzipsametype","description":"Median transaction price in the same postal code area for the same dwelling type.","type":"integer","nullable":true},"numStrAllTypes":{"title":"Numstralltypes","description":"Number of transactions on the same street across all dwelling types.","type":"integer","nullable":true},"medStrAllTypes":{"title":"Medstralltypes","description":"Median transaction price on the same street across all dwelling types.","type":"integer","nullable":true},"numStrSameType":{"title":"Numstrsametype","description":"Number of transactions on the same street for the same dwelling type.","type":"integer","nullable":true},"medStrSameType":{"title":"Medstrsametype","description":"Median transaction price on the same street for the same dwelling type.","type":"integer","nullable":true}},"type":"object","required":["houseNumber","postalCode","street","city","municipality","state","country","bagId","valueDate","predictedValue","references","weightedValue"],"title":"HomevalueResponse"},"ReferenceObjectModel":{"properties":{"amount":{"description":"Transaction price of the reference object.","title":"Amount","type":"integer"},"bagId":{"description":"Identification number according to the BAG.","title":"Bagid","type":"string"},"buildType":{"description":"Dwelling type","title":"Buildtype","type":"string"},"buildYear":{"description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","title":"Buildyear","type":"integer"},"buildYearCat":{"default":null,"description":"Build year category (construction period range).","title":"Buildyearcat","type":"string","nullable":true},"city":{"description":"City","title":"City","type":"string"},"date":{"format":"date","title":"Date","type":"string"},"distance":{"description":"Distance of the reference object from the valuation object in meter.","title":"Distance","type":"number"},"equality":{"default":null,"description":"Equality score reflecting the comparability of this reference object to the valuation object.","title":"Equality","type":"number","nullable":true},"houseNumber":{"description":"House number","title":"Housenumber","type":"integer"},"houseNumberExt":{"default":null,"description":"House number extension","title":"Housenumberext","type":"string","nullable":true},"indexedPrice":{"default":null,"description":"Transaction price of the reference object, indexed to the valuation date.","title":"Indexedprice","type":"integer","nullable":true},"monument":{"default":null,"description":"Boolean indicating whether the house is a monument.","title":"Monument","type":"boolean","nullable":true},"parcelSurface":{"default":null,"description":"The lot/parcel surface in m2.","title":"Parcelsurface","type":"integer","nullable":true},"postalCode":{"description":"Postal code","title":"Postalcode","type":"string"},"state":{"description":"State","title":"State","type":"string"},"street":{"description":"Street name","title":"Street","type":"string"},"useSurface":{"description":"The usable surface area of a property object in square meters.","title":"Usesurface","type":"integer"},"volume":{"default":null,"description":"Volume in m3.","title":"Volume","type":"integer","nullable":true}},"required":["amount","bagId","buildType","buildYear","city","date","distance","houseNumber","postalCode","state","street","useSurface"],"title":"ReferenceObjectModel","type":"object"}}}}
```

## The ReferenceObjectModel object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"0.0.1"},"components":{"schemas":{"ReferenceObjectModel":{"properties":{"amount":{"description":"Transaction price of the reference object.","title":"Amount","type":"integer"},"bagId":{"description":"Identification number according to the BAG.","title":"Bagid","type":"string"},"buildType":{"description":"Dwelling type","title":"Buildtype","type":"string"},"buildYear":{"description":"Indication of the year in which the building will originally be delivered in, or is architecturally ready. Also known as construction year.","title":"Buildyear","type":"integer"},"buildYearCat":{"default":null,"description":"Build year category (construction period range).","title":"Buildyearcat","type":"string","nullable":true},"city":{"description":"City","title":"City","type":"string"},"date":{"format":"date","title":"Date","type":"string"},"distance":{"description":"Distance of the reference object from the valuation object in meter.","title":"Distance","type":"number"},"equality":{"default":null,"description":"Equality score reflecting the comparability of this reference object to the valuation object.","title":"Equality","type":"number","nullable":true},"houseNumber":{"description":"House number","title":"Housenumber","type":"integer"},"houseNumberExt":{"default":null,"description":"House number extension","title":"Housenumberext","type":"string","nullable":true},"indexedPrice":{"default":null,"description":"Transaction price of the reference object, indexed to the valuation date.","title":"Indexedprice","type":"integer","nullable":true},"monument":{"default":null,"description":"Boolean indicating whether the house is a monument.","title":"Monument","type":"boolean","nullable":true},"parcelSurface":{"default":null,"description":"The lot/parcel surface in m2.","title":"Parcelsurface","type":"integer","nullable":true},"postalCode":{"description":"Postal code","title":"Postalcode","type":"string"},"state":{"description":"State","title":"State","type":"string"},"street":{"description":"Street name","title":"Street","type":"string"},"useSurface":{"description":"The usable surface area of a property object in square meters.","title":"Usesurface","type":"integer"},"volume":{"default":null,"description":"Volume in m3.","title":"Volume","type":"integer","nullable":true}},"required":["amount","bagId","buildType","buildYear","city","date","distance","houseNumber","postalCode","state","street","useSurface"],"title":"ReferenceObjectModel","type":"object"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.matrixian.com/waarderen-en-taxeren/woningwaarde+-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.