Authenticatie - 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 Authenticatie ============= Op deze pagina 1. Elke aanroep naar de API is authenticatie met een Percelio Inzicht-sleutel, als HTTP bearer-token. De Authorization-header ----------------------- Stuur de sleutel in de `Authorization`-header, voorafgegaan door `Bearer`: ``` Authorization: Bearer pct_… ``` Geen querystring, geen cookie, geen OAuth-flow. De bearer-sleutel is het enige credential dat de API accepteert. Altijd over HTTPS, behandel hem als een wachtwoord. ``` curl https://percelio.nl/api/v1/whoami \ -H "Authorization: Bearer pct_…" ``` Een ontbrekende of ongeldige sleutel krijgt `401`: ``` {"fout": "Ongeldige of ontbrekende sleutel."} ``` Een sleutel maken ----------------- In Percelio, open [Instellingen](https://percelio.nl/settings) en maak een Inzicht-sleutel. De sleutel bestaat één keer: wij bewaren alleen de hash. Wie hem kwijt is, roteert hem — de oude stopt meteen, de nieuwe is één keer te kopiëren. Een account mag maximaal 10 geldige inzicht-sleutels tegelijk hebben. Roterende sleutels trekken de oude in, dus die tellen niet mee. Rechten ------- Een inzicht-sleutel draagt `inzicht:lezen`. Zonder dat recht is elke Inzicht-aanroep `403`. Een beheer-sleutel mag Inzicht niet, een inzicht-sleutel mag Beheer niet. Whoami vertelt welke familie je in handen hebt. Whoami ------ Het eerste dat je aanroept. Het antwoord zegt wat de sleutel mag, tot wanneer hij geldig is, en hoeveel credits er nog op het account staan. GET `/api/v1/whoami` ``` GET https://percelio.nl/api/v1/whoami Authorization: Bearer pct_… ``` ``` { "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" } } ``` Whoami kost geen credits, zodat je ook kunt kijken als het tegoed op is. [ Vorige Introductie ](https://percelio.nl/developers) [ Volgende Teller ](https://percelio.nl/developers/teller) 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