Test jouw applicatie gratis met de Nederland Postcode API. Geen creditcard vereist!

Veelgestelde vragen

Hier vind je antwoorden op de meest gestelde vragen over onze Nederlandse postcode API.

Wat doet de Nederlandse Postcode API?
Met de Nederlandse Postcode API kun je eenvoudig adressen op basis van Nederlandse postcodes en huisnummers opzoeken. Dit is ideaal voor adresvalidatie, het automatisch invullen van formulieren en het verbeteren van de gebruikerservaring in je website of applicatie.
Kan ik de API gratis gebruiken?
Ja. Met een gratis account kun je de API kosteloos gebruiken om te testen en te integreren. Zodra alles goed werkt, kun je overstappen op een betaald abonnement.
Wat zijn projecten?
rojecten helpen je het API-gebruik te structureren. Je kunt per website of applicatie een apart project aanmaken, zodat verbruik en statistieken overzichtelijk per project worden bijgehouden.
Wat is een API-token?
Een API-token is een unieke sleutel waarmee je toegang krijgt tot de Nederlandse Postcode API. Het token is gekoppeld aan je account en project en wordt gebruikt om API-verzoeken te authenticeren en te registreren.
Kan ik meerdere API-tokens aanmaken per project?
Ja, per project kun je meerdere API-tokens aanmaken. Dit is handig wanneer je bijvoorbeeld aparte tokens wilt gebruiken voor test-, staging- en productieomgevingen of voor meerdere ontwikkelaars.
Wat is het verschil tussen een test- en live API-token?
Met een test API-token kun je de API gratis uitproberen. Een live API-token is gekoppeld aan een betaald abonnement en bedoeld voor productiegebruik. Het test API-token geeft dezelfde structuur en response, maar is beperkt tot een klein aantal postcodes, zoals 1015CN en 1118BN.
Wat is de rate limit van de API?
Elke API-token heeft een eigen rate limit, afhankelijk van het gekozen abonnement. Dit wordt uitgedrukt in het aantal verzoeken per seconde of minuut. Bij overschrijding ontvang je een foutmelding met statuscode 429 (Too Many Requests). Na een korte wachttijd kun je weer nieuwe verzoeken doen.
Abonnement opzeggen?
Je kunt je abonnement op elk moment opzeggen via je accountinstellingen. Na opzegging behoud je toegang tot de betaalde functies tot het einde van de lopende factureringsperiode.
Welke betaalmethoden worden ondersteund?
Voor betalingen maken we gebruik van Mollie. Ondersteunde betaalmethoden zijn iDEAL, creditcard en Bancontact.
Wat als ik mijn API-token ben kwijtgeraakt?
Op de projectpagina kun je eenvoudig een nieuw API-token genereren. Oude tokens kun je daar ook intrekken zodat ze niet meer gebruikt kunnen worden.
Waar vind ik mijn test API-token?
Wanneer je een project aanmaakt, wordt er automatisch een test API-token voor je gegenereerd.
Waar kan ik mijn verbruik zien?
Op de projectoverzichtspagina zie je per project het totaal aantal API-aanroepen en het actuele verbruik per endpoint.
Waar komt de data vandaan?
De data is afkomstig uit officiële bronnen zoals het Kadaster, de Basisregistratie Adressen en Gebouwen (BAG) en het Centraal Bureau voor de Statistiek (CBS).
Hoe actueel zijn de adressen?
De adresgegevens worden dagelijks bijgewerkt zodat je beschikt over zo actueel mogelijke data.
Worden zakelijke adressen ondersteund?
Ja, de Nederlandse Postcode API ondersteunt zowel particuliere als zakelijke adressen.
Kan ik de postcode database downloaden?
Ja, je kunt in plaats van de API ook de volledige postcode database downloaden om deze offline te gebruiken of in je eigen systeem te importeren.
Wat is de uptime van de API?
De API heeft een uptime van 99,99%. We monitoren de dienstverlening continu en plannen onderhoud zoveel mogelijk buiten kantooruren om impact voor gebruikers te minimaliseren.
Wat is de responstijd van de API?
De responstijd van een API-aanroep is doorgaans rond de 50 milliseconden, afhankelijk van de serverbelasting en endpoint.
Welk API endpoint moet ik gebruiken?
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om adressen op te zoeken. Een postcode en huisnummer zijn verplicht, huisnummertoevoeging is optioneel.
Energielabel opzoeken via de API?
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/energy-label gebruiken om energielabels van een adres op te halen. Een postcode en huisnummer zijn verplicht, huisnummertoevoeging is optioneel.
Hoevaak worden de energielabels bijgewerkt?
De energielabels worden dagelijks bijgewerkt om de meest actuele informatie te garanderen. Aan de hand van het totaalbestand en de dagelijkse mutaties zorgen we ervoor dat de data up-to-date blijft.
Krijg ik ook de coördinaten van een adres?
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om coördinaten van een adres op te halen door attributes[]=coordinates toe te voegen aan je API-aanvraag.
Kan ik ook de naam van de wijk opvragen?
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om de naam van de wijk op te halen door attributes[]=district toe te voegen aan je API-aanvraag.
Waarom krijg ik meerdere resultaten terug voor een adres?
Zoeken met alleen postcode en huisnummer kan meerdere resultaten opleveren. Door een huisnummertoevoeging toe te voegen krijg je een specifiek resultaat. Bij appartementen of bedrijfsverzamelgebouwen kunnen meerdere adressen hetzelfde huisnummer delen (bijvoorbeeld 10A, 10B, etc.).
De postcode bestaat maar ik krijg geen resultaten, hoe kan dat?
Als je een 200-status ontvangt maar geen resultaten ziet, gebruik je waarschijnlijk een test API-token. Test tokens geven alleen data terug voor een beperkt aantal postcodes.
Wat als ik bijna mijn limiet bereik?
Wanneer je 80% en 90% van je maandelijkse limiet bereikt, ontvang je automatisch een e-mailmelding. Zo heb je voldoende tijd om je verbruik te controleren of je abonnement aan te passen.
Kan ik de database ook offline gebruiken?
Je kunt de adressen valideren via onze API, maar je kunt ook de gehele database downloaden met meer dan 9 miljoen adressenom deze offline te gebruiken of in je eigen systeem te importeren.
Is er ook een PHP package beschikbaar?
Ja, we bieden een PHP package aan die we zelf ook gebruiken. Je vindt deze op GitHub.
Is er ook een Laravel package beschikbaar?
Ja, we bieden een Laravel package aan die we zelf ook gebruiken. Deze is te vinden op GitHub.
Kan ik ook een factuur ontvangen?
Ja, stuur ons een e-mail met je factuurgegevens en we zorgen ervoor dat je een factuur ontvangt voor je betalingen. We zijn bezig met het automatiseren van dit proces.
Kan ik ook maandelijks betalen?
Standaard zijn onze abonnementen op jaarbasis. Neem contact met ons op als je een maandelijks abonnement wilt afsluiten.
Kan ik 1 abonnement voor meerdere websites gebruiken?
Ja, met één abonnement kun je meerdere projecten aanmaken voor verschillende websites en/of applicaties. Het totale verbruik van al je projecten wordt bij elkaar opgeteld.