Fouten - Inzicht-API - Percelio

 + + +

   [         Percelio  ](/)  Woning     [  Percelio +  Plus   Alles voor je woning in een abonnement: bod, verbouwen, verduurzamen en alle rapporten.  ](/percelio-plus)  of los te bestellen  [     BiedAdvies

Datagedreven biedstrategie voor kopers

 ](/functies/bied-advies) [     Waardebepaling

Woningwaarde-indicatie voor verkopers

 ](/functies/waardebepaling) [     VergunningRapport

Wat mag je vergunningvrij (ver)bouwen

 ](/functies/vergunning-rapport)

  Kaart &amp; Perceel      Voor professionals  [     Kaart ontwerper

DXF/DWG export

 ](/functies/kaart-ontwerper) [     PerceelRapport

Locatie factsheet

 ](/functies/perceel-rapport) [      Maatvoering

Maten &amp; erfgrenzen

 ](/functies/maatvoeringsrapport) [     Projecten

Werkruimte &amp; rapportage

 ](/functies/projecten)

 [Kadasterkaart DXF](/kadasterkaart-downloaden) [Architecten](/sectoren/architecten) [Aannemers](/sectoren/aannemers) [Ontwikkelaars](/sectoren/projectontwikkelaars) [Makelaars](/sectoren/makelaars) [Gemeenten](/sectoren/gemeenten)

 [Alle functies →](/functies)

 [Prijzen](/pricing) [Kenniscentrum](/kenniscentrum) [Contact](/contact)

 [Inloggen](/login) [ Gratis proberen ](/register)

 [  Percelio +  Plus   Alles over je woning in één dossier: bod, kosten en wat je mag bouwen.  ](/percelio-plus)  Voor mijn woning     [BiedAdvies](/functies/bied-advies) [Waardebepaling](/functies/waardebepaling) [VergunningRapport](/functies/vergunning-rapport) [Alle functies](/functies)

  Voor mijn werk     [Kaart ontwerper](/functies/kaart-ontwerper) [PerceelRapport](/functies/perceel-rapport) [Maatvoeringsrapport](/functies/maatvoeringsrapport) [Projecten](/functies/projecten) [Architecten, aannemers, ontwikkelaars](/sectoren)

 [Prijzen](/pricing) [Kenniscentrum](/kenniscentrum) [Contact](/contact)

 [ Gratis proberen ](/register) [Inloggen](/login)

       Documentatie  v1.0

  Inhoud

 Inzicht-API

Versie 1.0

 Start

- [ Introductie ](https://percelio.nl/developers)
- [ Authenticatie ](https://percelio.nl/developers/authenticatie)
- [ Teller ](https://percelio.nl/developers/teller)
- [ Fouten ](https://percelio.nl/developers/fouten)

 Voorzieningen

- [ Marktwaarde ](https://percelio.nl/developers/waarde)
- [ Adres ](https://percelio.nl/developers/adres)
- [ WOZ ](https://percelio.nl/developers/woz)
- [ Energielabel ](https://percelio.nl/developers/label)
- [ Woningtype ](https://percelio.nl/developers/woningtype)
- [ Invloeden ](https://percelio.nl/developers/invloeden)

 Integratie

- [ MCP ](https://percelio.nl/developers/mcp)
- [ Webhooks ](https://percelio.nl/developers/webhooks)
- [ OpenAPI ](https://percelio.nl/developers/openapi)

Contract

- [ Interactieve spec ](https://percelio.nl/developers/spec)
- [ openapi.json ](https://percelio.nl/openapi.json)

  Inzicht-API

Versie 1.0

 Start

- [ Introductie ](https://percelio.nl/developers)
- [ Authenticatie ](https://percelio.nl/developers/authenticatie)
- [ Teller ](https://percelio.nl/developers/teller)
- [ Fouten ](https://percelio.nl/developers/fouten)

 Voorzieningen

- [ Marktwaarde ](https://percelio.nl/developers/waarde)
- [ Adres ](https://percelio.nl/developers/adres)
- [ WOZ ](https://percelio.nl/developers/woz)
- [ Energielabel ](https://percelio.nl/developers/label)
- [ Woningtype ](https://percelio.nl/developers/woningtype)
- [ Invloeden ](https://percelio.nl/developers/invloeden)

 Integratie

- [ MCP ](https://percelio.nl/developers/mcp)
- [ Webhooks ](https://percelio.nl/developers/webhooks)
- [ OpenAPI ](https://percelio.nl/developers/openapi)

Contract

- [ Interactieve spec ](https://percelio.nl/developers/spec)
- [ openapi.json ](https://percelio.nl/openapi.json)

  Inzicht-API

Fouten
======

 Op deze pagina

 1.

  Elke fout is kort en Nederlands, in `{"fout": "…"}`. Geen Laravel-validatie-envelope, geen Engelse `message`.

Statuscodes
-----------

- `401` — geen of ongeldige sleutel
- `402` — tegoed op
- `403` — dit recht zit niet op de sleutel
- `404` — adres of bron niet gevonden
- `422` — ongeldige input, of te weinig data om te schatten
- `429` — te snel
- `503` — een bronsysteem is plat

De vorm
-------

```
{"fout": "Adres niet gevonden."}
```

 Bij `402` komt `saldo` mee, zodat je niet extra whoami hoeft te doen:

```
{
  "fout": "Tegoed op.",
  "saldo": {
    "credits": 0,
    "eenheid_cent": 5,
    "tegoed_cent": 0
  }
}
```

 Bij `422` op marktwaarde kan `betrouwbaarheid` meekomen: we kennen het adres, maar te weinig vergelijkbare verkopen — dan komt er bewust geen getal.

Wat credits kost
----------------

 Een 404 kost niets. Een 401, 403 of 429 ook niet: je hebt niets geleverd gekregen. Een 200 en een 422 wegens onvoldoende data wel. Zie [Teller](https://percelio.nl/developers/teller).

  [ Vorige Teller ](https://percelio.nl/developers/teller)

 [ Volgende Marktwaarde ](https://percelio.nl/developers/waarde)

  Klopt er iets niet of ontbreekt er iets?

  Op deze pagina

 1.

   [ Percelio ](/)Inzicht geeft vertrouwen.

 Nederlandse geodata en woningdata, direct bruikbaar. Voor particulieren en professionals.

- [    ](https://www.instagram.com/percelio_nl/)
- [    ](https://www.facebook.com/profile.php?id=61592996649897)
- [    ](https://www.linkedin.com/in/floriswijgergangs/)

  Gratis tools - [ETFAL-scan (bèta)](/etfal-scan)
- [WOZ-checker](/woz-checker)
- [Oppervlakte meten](/oppervlakte-meten)
- [Grenszoeker](/grens-zoeker)
- [Bestemmingsplan opzoeken](/bestemmingsplan-opzoeken)
- [Vergunningenkaart](/vergunningenkaart)
- [Warmteverliesberekening](/warmteverliesberekening)
- [Browserextensie](/browserextensie)

  Omgevings-checks - [Stikstof-check](/stikstof-check)
- [Spuitzone-check](/spuitzone-check)
- [Risicobronnen-check](/risicobronnen-check)
- [Veehouderij in de buurt](/veehouderij-in-buurt)
- [Hoogspanning-check](/hoogspanning-check)
- [Bodem-check](/bodem-verontreiniging-check)
- [Decibel-check](/decibel-check)
- [Bouwjaar + asbest-check](/bouwjaar-check)

  Producten - [Prijzen](/pricing)
- [BiedAdvies](/functies/bied-advies)
- [Waardebepaling](/functies/waardebepaling)
- [PerceelRapport](/functies/perceel-rapport)
- [VergunningRapport](/functies/vergunning-rapport)
- [Maatvoeringsrapport](/functies/maatvoeringsrapport)
- [WOZ-bezwaarrapport](/woz-bezwaarrapport)
- [Zonnedakrapport](/zonnedakrapport)
- [HuurCheck](/huurcheck)
- [Kaart ontwerper](/functies/kaart-ontwerper)
- [Kadasterkaart DXF](/kadasterkaart-downloaden)
- [Projecten](/functies/projecten)

  Voor wie - [Architecten](/sectoren/architecten)
- [Aannemers](/sectoren/aannemers)
- [Projectontwikkelaars](/sectoren/projectontwikkelaars)
- [Makelaars](/sectoren/makelaars)
- [Gemeenten](/sectoren/gemeenten)

  Veelgevraagd - [Bieden op een huis](/bieden-op-een-huis)
- [Wat is mijn huis waard?](/wat-is-mijn-huis-waard)
- [Woningwaarde berekenen](/woningwaarde-berekenen)
- [Woningen in Nederland](/nederland)

  Bedrijf - [Contact](/contact)
- [API](/developers)
- [Over ons](/over-ons)
- [Artikelen](/artikelen)
- [Kenniscentrum](/kenniscentrum)

  Integraties - [Alle integraties](/integraties)
- [AutoCAD](/integraties/autocad)
- [Revit](/integraties/revit)
- [BricsCAD](/integraties/bricscad)
- [ArchiCAD](/integraties/archicad)
- [QGIS](/integraties/qgis)

 © 2026 Percelio. Alle rechten voorbehouden. [Privacy](/privacy) [Voorwaarden](/terms)

52°22′N 4°53′E

 We meten graag welke advertentie mensen hier bracht, en kijken mee hoe de site gebruikt wordt om hem beter te maken. Daarvoor plaatsen Meta, Google en Microsoft een cookie. Inloggen en je voorkeuren werken zonder, dus nee zeggen kan gewoon. [Privacyverklaring](https://percelio.nl/privacy)

  Liever niet   Akkoord
