Postcode API voor Laravel

Adresvalidatie in je Laravel-applicatie zonder gedoe. Installeer onze officiële package via Composer en haal Nederlandse adressen op met een paar regels code.

Officiële Laravel package

We onderhouden een officiële Laravel package waarmee je de Nederland Postcode API direct in je applicatie gebruikt — met een expressieve facade, nette exceptions en configuratie via je .env. Je hoeft zelf geen HTTP-client of foutafhandeling te schrijven.

Installatie

Installeer de package via Composer:

composer require label84/laravel-nederland-postcode

Voeg vervolgens je API-token toe aan je .env-bestand:

NEDERLAND_POSTCODE_API_KEY="npa_live_xxx"

Een adres ophalen

use Label84\NederlandPostcode\Laravel\Facades\NederlandPostcode;

$address = NederlandPostcode::find(
    postcode: '1015CN',
    number: 10,
    addition: null,
    attributes: ['coordinates'],
);

Wordt er geen adres gevonden, dan krijg je een NoAddressFoundException; bij meerdere matches een MultipleAddressesFoundException. Zo houd je je validatielogica netjes en voorspelbaar.

Een volledige uitleg met alle methodes en foutafhandeling vind je in de blogpost over de Laravel package.

Liever zonder package?

De package is een gemak, geen vereiste. Je kunt de API ook direct aanroepen met de HTTP-client van Laravel:

use Illuminate\Support\Facades\Http;

$address = Http::withToken(config('services.nederlandpostcode.key'))
    ->get('https://api.nederlandpostcode.nl/v1/address', [
        'postcode' => '1015CN',
        'number' => 10,
    ])
    ->json();

Bekijk alle endpoints en velden in de API documentatie, of de prijzen — één vaste jaarprijs voor een onbeperkt aantal projecten.

Begin met een gratis account

Maak een account aan, genereer een test-token en doe je eerste API-aanroep binnen een paar minuten.