Teller - 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

Teller
======

 Op deze pagina

 1.

  Betaalde calls kosten credits. Eén credit is vijf eurocent, dezelfde credits als voor kaartexports. Twee sleutels delen één tegoed. Whoami kost niets.

Het tegoed
----------

 Geen credits, dan antwoordt de API `402`. Dat is geen 429: 429 is te snel, 402 is op. Whoami blijft werken, zodat je kunt zien dat het tegoed op is.

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

 Onder de 200 credits (€10) sturen we één keer het webhook-event `saldo.laag`, op 0 één keer `saldo.op`. Niet bij elke call daarna.

 Credits koop je onder [Billing](https://percelio.nl/billing). De bundel van €50 is 1.000 credits — 55 marktwaarde-calls, of een mix. Auto-opladen (optioneel) stort die bundel bij onder de 200 credits.

Kosten per call
---------------

- `whoami` — 0 credits
- `waarde` — 18 credits (€0,90)
- `invloeden` — 16 credits (€0,80)
- `adres`, `woz`, `label`, `woningtype` — 1 credit (€0,05)

 Een call onder de vijf cent kost 1 credit. `meta.gefactureerd_cent` is het afgeboekte bedrag.

Idempotency-Key
---------------

 Een herhaalde call met dezelfde `Idempotency-Key` (max. 24 uur, zelfde sleutel, zelfde voorziening) telt één keer en kost één keer. Eigen id, max. 128 tekens.

```
Idempotency-Key: 8f3c-jouw-eigen-id
```

 Een key geldt per voorziening. Dezelfde key op `adres` en `waarde` zijn twee calls. Zonder header telt elke aanroep.

 Een 404 (adres bestaat niet) kost niets. Een geslaagde schatting en een 422 wegens onvoldoende data wel.

Te snel
-------

 REST: 60 requests per minuut per sleutel, 30 voor invloeden. MCP: 30 per minuut. Daarboven `429`. Dat is de snelheidslimiet, niet het tegoed.

  [ Vorige Authenticatie ](https://percelio.nl/developers/authenticatie)

 [ Volgende Fouten ](https://percelio.nl/developers/fouten)

  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
