Introductie - 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 & Perceel Voor professionals [ Kaart ontwerper DXF/DWG export ](/functies/kaart-ontwerper) [ PerceelRapport Locatie factsheet ](/functies/perceel-rapport) [ Maatvoering Maten & erfgrenzen ](/functies/maatvoeringsrapport) [ Projecten Werkruimte & 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 Introductie =========== Op deze pagina 1. De Inzicht-API geeft een oordeel per Nederlands adres: marktwaarde, BAG-kenmerken, WOZ, energielabel, woningtype en invloeden. Dezelfde sleutel, dezelfde teller, dezelfde webhooks. REST of MCP. Deze pagina’s zijn de rondleiding. Het veld-voor-veld-contract is de machineleesbare [OpenAPI-spec](https://percelio.nl/openapi.json). Sleutels maak je in je [accountinstellingen](https://percelio.nl/settings) (inloggen vereist). Deze documentatie is openbaar. Eén sleutel, één teller ----------------------- Elke aanroep is authenticatie met één persoonlijke sleutel, en **het tegoed hangt aan het account, niet aan de sleutel**. Twee sleutels delen dus één saldo. Er is geen `{account}` in de URL — de sleutel zelf bepaalt wie je bent. Een inzicht-sleutel begint met `pct_` en draagt het recht `inzicht:lezen`. De Beheer-API (`/api/v1/projecten` en verder) is een ander product, met eigen sleutels. Een inzicht-sleutel leest geen projecten. Adres in, oordeel uit --------------------- Dit is geen dataset en geen export. Je stuurt één adres, je krijgt één antwoord. Geen Kadaster-koopsommen, geen vergelijkbare woningen, geen PDF. Wat we al hebben, geven we terug; wat we niet hebben, is `null` of een bewuste fout — nooit een verzonnen getal. Quickstart: whoami in twee minuten ---------------------------------- **1. Maak een sleutel.** In Percelio, open [Instellingen](https://percelio.nl/settings) en maak een Inzicht-sleutel. De sleutel is **één keer** te kopiëren. Hij ziet eruit als `pct_…`. **2. Stuur hem als bearer.** ``` curl https://percelio.nl/api/v1/whoami \ -H "Authorization: Bearer pct_…" ``` **3. Lees het antwoord.** Een enkel resource zit in `data`: ``` { "data": { "naam": "productie", "familie": "inzicht", "voorvoegsel": "pct_ab12", "rechten": ["inzicht:lezen"], "bereik": "account", "verloopt_op": "2027-09-16T12:00:00+02:00", "saldo": { "credits": 1000, "eenheid_cent": 5, "tegoed_cent": 5000 } }, "meta": { "schema": "percelio/api", "schema_versie": "1.0" } } ``` Dat is de hele lus: authenticeren, aanroepen, `data` lezen. Whoami kost geen credits, zodat je ook kunt kijken als het tegoed op is. Daarna een woning: `POST /api/v1/inzicht/waarde` met een `adres`-object. Zie [Marktwaarde](https://percelio.nl/developers/waarde). Conventies in het kort ---------------------- - **JSON overal.** Een resource is `{ "data": { … }, "meta": { … } }`. Een fout is `{ "fout": "…" }`, in het Nederlands. - **REST-adres is genest** (`{"adres": {"postcode", "huisnummer"}}`). MCP-argumenten liggen plat (`postcode`, `huisnummer`). - **Marktwaarde is een geheel getal in euro’s** — `412000`, geen string, geen centen. Kosten in `meta.gefactureerd_cent` zijn wél centen. - **Datums** zijn `Y-m-d`. Tijdstempels zijn ISO-8601 met offset (`2027-09-16T12:00:00+02:00`). - **Credits.** Eén credit is vijf eurocent. Waarde kost 18, een lookup 1. Zie [Teller](https://percelio.nl/developers/teller). - **Creates zijn idempotent** — header `Idempotency-Key`, 24 uur, per voorziening. - **Rate limit** 60 requests/minuut per sleutel, 30 voor invloeden en MCP. Dat is 429, niet 402. Wat niet in de API zit ---------------------- Vooraf gezegd, zodat je er niet omheen ontwerpt: - **Geen vergelijkbare woningen** en geen Kadaster-koopsommen. Alleen het getal, de band en een betrouwbaarheidslabel. - **Geen live Kadaster- of EP-Online-call** in de request. We geven wat we al hebben. - **Geen perceel, bestemming of vergunningvrij** in v1. Het pad blijft `/api/v1/inzicht/…`. - **Geen geometrie** bij invloeden, en niet de 27 project-analyses. - **Geen Beheer-API** met deze sleutel. Projecten, taken, dossiers: andere familie, andere sleutel. - **Label en woningtype zitten niet op MCP** in v1. REST heeft ze wel. Waarheen nu ----------- - [Authenticatie](https://percelio.nl/developers/authenticatie) — de bearer-header, whoami, rechten. - [Teller](https://percelio.nl/developers/teller) — credits, idempotency, 402 versus 429. - [Fouten](https://percelio.nl/developers/fouten) — elke foutvorm die je terugkrijgt. - [Marktwaarde](https://percelio.nl/developers/waarde) en de andere voorzieningen — request en response. - [MCP](https://percelio.nl/developers/mcp) — dezelfde catalogus voor agents. - [Webhooks](https://percelio.nl/developers/webhooks) — events ontvangen en de handtekening controleren. - [OpenAPI](https://percelio.nl/developers/openapi) — het contract, of de [interactieve spec](https://percelio.nl/developers/spec). [ Volgende Authenticatie ](https://percelio.nl/developers/authenticatie) 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