Ga naar hoofdinhoud

Aan de slag

Begin binnen enkele minuten met het ophalen van Nederlandse adresgegevens. Volg deze drie eenvoudige stappen.

// STEP_01Maak een account aan
1Maak een account aan

Registreer gratis om toegang te krijgen tot de API.

// STEP_02Maak een API-sleutel aan
2Maak een API-sleutel aan

Na het inloggen maakt u uw eerste API-sleutel aan:

  1. Ga naar API-sleutels in het dashboard
  2. Klik op 'Nieuwe sleutel aanmaken'
  3. Geef de sleutel een naam (bijv. 'Productie')
  4. Kopieer de sleutel - deze wordt maar één keer getoond!
// STEP_03Doe uw eerste verzoek
3Doe uw eerste verzoek

Gebruik uw API-sleutel om een adres op te zoeken:

cURL

curl -s "https://postcodetools.nl/api/v1/addresses/lookup?postcode=2514GL&number=78" \
  -H "Authorization: Bearer <api-key>" \
  -H "Accept: application/json" | jq .

Python

import requests

response = requests.get(
    "https://postcodetools.nl/api/v1/addresses/lookup",
    params={"postcode": "2514GL", "number": 78},
    headers={"Authorization": "Bearer <api-key>"}
)
address = response.json()["data"]
print(f"{address['straatnaam']} {address['huisnummer']}, {address['woonplaats_naam']}")

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://postcodetools.nl/api/v1/addresses/lookup', [
    'headers' => ['Authorization' => 'Bearer <api-key>'],
    'query' => ['postcode' => '2514GL', 'number' => 78],
]);
$address = json_decode($response->getBody(), true)['data'];
echo "{$address['straatnaam']} {$address['huisnummer']}, {$address['woonplaats_naam']}";

Verwachte uitvoer

{
  "data": {
    "nummeraanduiding_id": "0518200000123456",
    "type": "verblijfsobject",
    "huisnummer": 78,
    "huisletter": null,
    "huisnummertoevoeging": null,
    "postcode": "2514GL",
    "straatnaam": "Kneuterdijk",
    "woonplaats_naam": "'s-Gravenhage",
    "gemeente_naam": "'s-Gravenhage",
    "provincie_naam": "Zuid-Holland",
    "latitude": 52.0815,
    "longitude": 4.3118,
    "rd_x": 81548,
    "rd_y": 454640
    /* …other fields omitted for brevity */
  }
}
// NEXT_STEPSVolgende stappen