Open Postcode

Appearance

Straatnaam zoeken bij postcode ​

Met de Open Postcode API kun je eenvoudig een straatnaam vinden op basis van een postcode. Geen registratie nodig, volledig gratis en altijd up-to-date.

Over deze pagina ​

Zoek direct de straatnaam die hoort bij een postcode en (optioneel) huisnummer. Deze pagina geeft concrete voorbeelden met de OpenPostcode API en implementatietips voor formulieren en UX.

Wanneer gebruik je dit? ​

  • Je hebt een postcode (en huisnummer) en wil de straatnaam automatisch invullen.
  • Je wilt gebruikers helpen bij het vinden van hun straat wanneer ze alleen de postcode weten.

Endpoint ​

GET /api/address?postcode={postcode}&huisnummer=

  • postcode (verplicht): genormaliseerd als 4 cijfers + 2 letters (bijv. 1017XN)
  • huisnummer (optioneel): huisnummer zoals 42; zonder huisnummer krijg je suggesties of foutmelding

Voorbeeld response ​

json
{
  "postcode": "1017XN",
  "huisnummer": "42",
  "straat": "Frederiksplein",
  "buurt": "Frederikspleinbuurt",
  "wijk": "De Weteringschans",
  "woonplaats": "Amsterdam",
  "gemeente": "Amsterdam",
  "provincie": "Noord-Holland",
  "latitude": 52.35999,
  "longitude": 4.898108
}

Voorbeelden ​

curl ​

bash
curl -s "https://openpostcode.nl/api/address?postcode=1017XN&huisnummer=42" | jq

JavaScript (fetch) ​

js
async function lookupAddress(postcode, huisnummer) {
  const url = `/api/address?postcode=${encodeURIComponent(postcode)}&huisnummer=${encodeURIComponent(huisnummer)}`
  const res = await fetch(url)
  const json = await res.json()
  if (!res.ok) throw new Error(json.error || 'Onbekende fout')
  return json
}

lookupAddress('1017XN', '42').then(console.log).catch(console.error)

Python (requests) ​

py
import requests

resp = requests.get('https://openpostcode.nl/api/address', params={'postcode': '1017XN', 'huisnummer': '42'})
data = resp.json()
print(data)

UX / implementatietips ​

  • Normaliseer altijd de postcode client-side: verwijder spaties en maak letters uppercase.
  • Als het huisnummer ontbreekt, gebruik de API zonder huisnummer om suggestions op te halen en vul een dropdown.
  • Toon kort antwoord bovenaan (straatnaam) en extra details onderaan (buurt, wijk, coördinaten) — dit helpt featured snippets.

Meer voorbeelden en integraties vind je in de API-documentatie.