Adresvalidatie & postcode API voor Nederland

Elk verkeerd adres kost geld: een retour, een belletje naar support, een dubbele verzending. De goedkoopste manier om die fouten te voorkomen is ze nooit te laten ontstaan, en daarvoor heb je adresvalidatie nodig. Met één aanroep naar een postcode API controleer je of een adres echt bestaat, vul je ontbrekende velden aan en sla je een schoon, gestructureerd adres op.

In deze gids leggen we uit wat adresvalidatie precies doet, wanneer je het nodig hebt, en hoe het zich verhoudt tot adresverificatie en autocomplete. Daarna laten we zien hoe je de Pro6PP postcode API in een paar regels code koppelt.

Wat is een postcode API en wanneer heb je er een nodig?

Een postcode API is een webservice die op basis van een postcode en huisnummer het volledige adres teruggeeft: straatnaam, woonplaats, gemeente en vaak extra gegevens zoals coördinaten of buurtinformatie. In plaats van dat een klant het hele adres uittypt, vult de API de rest automatisch en correct aan.

Je hebt een postcode API nodig zodra adressen ergens je systeem binnenkomen en moeten kloppen. De typische gevallen:

Webshops en checkout: minder afgebroken bestellingen en minder mislukte bezorgingen.
CRM en klantdata: adressen schoon binnenkrijgen in plaats van ze achteraf opschonen.
Logistiek en planning: betrouwbare adressen en coördinaten voor route- en servicegebieden.
Onboarding en formulieren: snellere invoer, minder typefouten, hogere conversie.

Het gemeenschappelijke patroon: je wilt de vraag "wat is de postcode van dit adres", of juist andersom welk adres bij een postcode hoort, automatisch beantwoorden in plaats van het aan de gebruiker over te laten. Wil je eerst weten hoe dat zoeken en valideren in Nederland precies in zijn werk gaat, dan loopt onze complete gids over adres zoeken en valideren het stap voor stap met je door.

Adresvalidatie, adresverificatie en autocomplete: de verschillen

Deze drie termen worden door elkaar gebruikt, maar ze doen niet hetzelfde:

Adresvalidatie toetst of een adres geldig en bestaand is: hoort deze combinatie van postcode, huisnummer, straat en plaats echt bij elkaar? Een postcode die niet bij de straat past, valt direct door de mand.
Adresverificatie gaat een stap verder en bevestigt dat het adres ook daadwerkelijk in gebruik of leverbaar is, vaak gekoppeld aan een officiële bron.
Adres autocomplete is de invoerlaag: terwijl de klant typt, suggereert en completeert de API het adres, zodat er minder te corrigeren valt.

In de praktijk combineer je ze. Autocomplete voorkomt fouten tijdens het typen, validatie controleert het resultaat, en verificatie geeft de zekerheid die je voor verzending of facturatie nodig hebt. Hoe je die laatste stap concreet in je bestelproces inbouwt, laten we zien in adresverificatie in de checkout.

Wat een goede postcode API levert

Niet elke API is gelijk. Let bij de keuze op:

Nauwkeurigheid en bron: werkt de API op officiële, actuele adresdata (in Nederland de BAG)?
Dekking: alleen NL, of ook België, Duitsland en Frankrijk voor internationale klanten?
Snelheid: een API die de checkout vertraagt, kost juist conversie.
Verrijking: naast straat en plaats ook coördinaten, gemeente, buurt of bouwjaar.
Eenvoudige integratie: duidelijke documentatie en een gratis sleutel om mee te testen.

De Pro6PP API: dekking, nauwkeurigheid en BAG-bron

Pro6PP biedt geen breed én oppervlakkig aanbod, maar juist de grootste diepgang per land. Voor Nederland werkt de API op de officiële Basisregistratie Adressen en Gebouwen (BAG), met extra data per adres zoals coördinaten, gemeente, wijk, buurt en bouwjaar. Welke van die velden je echt nodig hebt verschilt per toepassing; we zetten ze op een rij in adresgegevens en verrijking. Naast Nederland is er dekking voor onder andere België, Duitsland en Frankrijk, zodat je met dezelfde integratie ook internationale adressen valideert.

De Autocomplete API vult tijdens het typen aan; de validatie controleert vervolgens of het adres klopt en verrijkt het met extra velden, allemaal in dezelfde aanroep en zonder de checkout te vertragen.

Gratis postcode API of betaald: wat is het verschil?

"Postcode API gratis" is een van de meest gezochte varianten, en terecht: voor een hobbyproject of een snelle test is een gratis postcode API prima. De vraag is wat er gebeurt zodra het serieus wordt. Gratis API's lopen vaak vast op vier punten:

Actualiteit van de bron: draait de API op de actuele BAG, of op een verouderde kopie? Een adres dat vorige maand is bijgebouwd, moet vandaag al kloppen.
Rate limits: gratis tiers knijpen het aantal aanroepen af. Dat merk je pas in de checkout op een drukke dag.
Dekking en velden: vaak alleen van postcode naar straat, zonder coördinaten, gemeente, bouwjaar of internationale landen.
Zekerheid: geen SLA, geen support, geen garantie dat de service er morgen nog is.

Bij Pro6PP begin je daarom met een gratis API-sleutel om mee te bouwen en te testen, en schaal je op naar een betaald plan zodra je volume groeit, op dezelfde BAG-bron en met dezelfde velden en endpoints. Zo betaal je pas voor betrouwbaarheid wanneer je die nodig hebt, zonder je integratie te hoeven herschrijven.

Integratievoorbeeld

Een adres ophalen op basis van postcode en huisnummer is één request. Met cURL:

curl "https://api.pro6pp.nl/v2/autocomplete/nl?authKey=JOUW_SLEUTEL&postalCode=5611AZ&streetNumber=11"

Of vanuit JavaScript:

const params = new URLSearchParams({
  authKey: process.env.PRO6PP_KEY,
  postalCode: '5611AZ',
  streetNumber: '11',
});

const res = await fetch(`https://api.pro6pp.nl/v2/autocomplete/nl?${params}`);
const address = await res.json();
// address.street, address.settlement, address.municipality, address.lat, address.lng

Je valideert de postcode en het huisnummer, vult straat en plaats aan en slaat een schoon, gestructureerd adres op, klaar voor verzending, facturatie of analyse.

Veelgestelde vragen

Wat is het verschil tussen een postcode API en adresvalidatie?

Een postcode API is de service die adresdata teruggeeft; adresvalidatie is wat je ermee doet, namelijk controleren of een adres echt bestaat en klopt. De Pro6PP API levert beide in één aanroep.

Op welke bron werkt de Pro6PP postcode API voor Nederland?

Op de officiële Basisregistratie Adressen en Gebouwen (BAG), met extra verrijking per adres zoals coördinaten, gemeente, wijk en bouwjaar.

Vertraagt adresvalidatie mijn checkout?

Nee, mits je het realtime via de API doet. De aanvulling gebeurt terwijl de klant typt, dus de klant merkt er niets van behalve dat het formulier sneller invult.

Is er een gratis postcode API?

Ja, je kunt met een gratis API-sleutel beginnen om te bouwen en te testen. Voor productie met hoger volume, een SLA en gegarandeerde actualiteit van de BAG-bron stap je over op een betaald plan met dezelfde endpoints, zodat je integratie hetzelfde blijft.

Is er een API om de postcode bij een adres te zoeken?

Ja. Geef straat, huisnummer en plaats op en de API geeft de bijbehorende postcode terug, de omgekeerde richting van het voorbeeld hierboven. Zo automatiseer je ook reverse lookups in plaats van ze handmatig op te zoeken.

Kan ik de API eerst gratis testen?

Ja. Je maakt een account aan, haalt een sleutel op en test direct tegen de documentatie voordat je live gaat.

Aan de slag

Een postcode API verdient zichzelf terug op het moment dat de eerste foute bestelling níet retour komt. Begin klein: koppel autocomplete aan één formulier, meet het effect en breid daarna uit.