REST API

Postcode API

Nederlandse adressen opzoeken op basis van postcode en huisnummer. Snel, betrouwbaar en eenvoudig te integreren.

API key aanvragen

Beschikbaar via postcode.portica.nl

Wat kan de API?

Vier endpoints voor alle adresgerelateerde functionaliteit.

GET /api/postcode/{postcode}

Adres opzoeken

Geeft straat, stad, gemeente, provincie en GPS-coördinaten terug op basis van postcode en huisnummer.

GET /api/postcode/{postcode}/validate

Adres valideren

Controleert of een postcode (en optioneel huisnummer) bestaat. Altijd HTTP 200 — ideaal voor formuliervalidatie.

GET /api/distance

Afstand berekenen

Berekent de afstand in kilometers tussen twee postcodes. Handig voor bezorgkosten, reistijd of routeplanning.

GET /api/postcode/search

Zoeken op straat

Postcode achterhalen via straatnaam en woonplaats. Geeft één of meerdere overeenkomende resultaten.

Cache

Resultaten 30 dagen gecached — razendsnel bij herhaalde lookups

IP-lock

API key automatisch gekoppeld aan jouw server-IP

NL data

Alle Nederlandse postcodes, dagelijks bijgewerkt

Voorbeeld

Eén HTTP-aanroep geeft een volledig adres terug.

Aanroep

GET /api/postcode/1234AB?huisnummer=10&apiKey=wku_...

Response — HTTP 200

{
  "postcode":     "1234AB",
  "huisnummer":   10,
  "toevoeging":   null,
  "street":       "Voorbeeldstraat",
  "city":         "Amsterdam",
  "municipality": "Amsterdam",
  "province":     "Noord-Holland",
  "latitude":     52.3702,
  "longitude":    4.8952
}

Integratie voorbeelden

JavaScript

const res = await fetch(
  `https://postcode.portica.nl/api/postcode/1234AB
   ?huisnummer=10&apiKey=wku_...`
);
const data = await res.json();

var url =
  "https://postcode.portica.nl/api/postcode/1234AB"
  + "?huisnummer=10&apiKey=wku_...";
var json = await http.GetStringAsync(url);

PHP

$url = "https://postcode.portica.nl/api/postcode"
     . "/1234AB?huisnummer=10&apiKey=wku_...";
$data = json_decode(file_get_contents($url));

Python

import requests
r = requests.get(
  "https://postcode.portica.nl/api/postcode/1234AB",
  params={"huisnummer": 10, "apiKey": "wku_..."}
)

Code	Betekenis
200	Aanroep geslaagd — adres gevonden of validatieresultaat
200	Meerdere huisnummers gevonden — response bevat `suggestions`
401	Ongeldige, ontbrekende of IP-gebonden API key
404	Adres niet gevonden