Postcode API: Nederlands adres opzoeken

Laat bezoekers hun postcode en huisnummer invullen en vul straat en woonplaats vanuit je backend aan. De Postcode API ontsluit adressen uit de Basisregistratie Adressen en Gebouwen via PDOK.

Bron: BAG via PDOK · CC0. Bronnen en licenties

Wat kun je ermee?

  • Adresvelden aanvullen in een registratie- of bestelformulier.
  • Een bestaand adres vergelijken met de BAG-gegevens.
  • Coördinaten gebruiken voor een kaart of een locatiegebonden toepassing.
  • Adressen opslaan of koppelen met de vaste BAG-sleutel (nummeraanduiding_id), die gelijk blijft als een straat wordt hernummerd.

Handig bij het integreren

Je kunt een huisnummertoevoeging meegeven met ?toevoeging=. Bij meerdere adressen voor hetzelfde huisnummer kan die toevoeging nodig zijn. Nederlandse veldnamen en lat/lon maken het antwoord direct bruikbaar in je applicatie.

Je gebruikt één X-API-Key voor alle beschikbare bronnen. Antwoorden hebben dezelfde JSON-omhulling en vaste foutcodes. Met de limietheaders en het verbruik in je dashboard houd je bij hoeveel requests je nog hebt.

Goed om te weten

Een BAG-adres is geen bewijs dat iemand daar woont en is geen garantie dat een zending bezorgd kan worden. Houd rekening met de ophaaldatum van bufferdata.

NLAPI bewaart bronantwoorden in een buffer. Als de bron tijdelijk niet reageert kan een eerdere versie worden geleverd, zolang die nog bruikbaar is. Dat herken je aan meta.verouderd. Beschikbaarheid en actualiteit zijn niet gegarandeerd.

Endpoints en voorbeelden

Adres op postcode en huisnummer

GET /v1/postcode/{postcode}/{huisnummer}

Parameters, JSON en codevoorbeelden

Voorbeelden in curl, PHP, Node.js en Python. Importeer OpenAPI JSON in Postman, Insomnia of je coding agent.

Start gratis Bekijk pakketten

Combineer met andere Nederlandse data

Gebouwgegevens API: bouwjaar, oppervlakte en gebruiksdoel uit de BAGRDW API: voertuiggegevens op kentekenFeestdagen API voor NederlandSchoolvakanties API per regioKNMI weer API per plaats of postcode