Marktwaarde

Adres in, geschatte marktwaarde uit. Optioneel een peildatum (bijvoorbeeld 1 januari 2026 voor een WOZ-vergelijking). Zonder peildatum rekenen we naar vandaag. Indicatief, geen taxatie.

Aanroep

curl https://percelio.nl/api/v1/inzicht/waarde \
  -H "Authorization: Bearer pct_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: woning-8011AB-12-2026-01-01" \
  -d '{
    "adres": {
      "postcode": "8011AB",
      "huisnummer": "12",
      "toevoeging": null
    },
    "peildatum": "2026-01-01"
  }'

Optioneel woonoppervlakte (integer, 20–2000) als je de BAG-waarde wilt overschrijven.

Antwoord

{
  "data": {
    "adres": {
      "weergave": "Diezerstraat 12, Zwolle",
      "postcode": "8011AB",
      "huisnummer": 12,
      "toevoeging": null
    },
    "marktwaarde": 412000,
    "min": 385000,
    "max": 440000,
    "betrouwbaarheid": "normaal",
    "peildatum": "2026-01-01",
    "valuta": "EUR"
  },
  "meta": {
    "schema": "percelio/inzicht",
    "schema_versie": "1.0",
    "voorziening": "waarde",
    "cached": false,
    "gefactureerd_cent": 90
  }
}

Het antwoord bevat geen vergelijkbare woningen en geen Kadaster-koopsommen: alleen het getal, de band en een betrouwbaarheidslabel.

Fouten

404 als het adres niet bestaat. 422 als we het adres wel kennen maar te weinig vergelijkbare verkopen hebben — dan komt er geen getal, bewust. Een 404 kost niets; een geslaagde schatting (en een 422 wegens onvoldoende data) wel.

MCP

Tool property_value. Argumenten plat: postcode, huisnummer, optioneel toevoeging, peildatum, woonoppervlakte. Zie MCP.