hpolthof/postcode-tech

A library to easily lookup Dutch postcodes using postcode.tech

v2.0.0 2026-02-08 10:13 UTC

Requires

• php: ^8.1
• hpolthof/assert-return-value: ^1.11.0
• symfony/http-client: ^6.4 || ^7.0 || ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^v3.89
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^9.6

gpl-3.0-or-later

README

This is a wrapper around the postcode.tech Postcode API.

Installation

To install use composer

composer require hpolthof/postcode-tech

Requirements

You need an API key for this API to work. You can register for free and create an API Key.

Usage

Please see the example below for usage:

use Hpolthof\PostcodeTech\Exceptions\HttpException;
use Hpolthof\PostcodeTech\Exceptions\PostcodeNotFoundException;
use Hpolthof\PostcodeTech\Exceptions\ValidationException;
use Hpolthof\PostcodeTech\Postcode;

$apiKey = '';

try {
    $postcode = Postcode::search('1071BM', 29, $apiKey);
    echo $postcode->street(); // result: "Pieter Cornelisz. Hooftstraat"
    echo $postcode->city(); // result: "Amsterdam"
} catch (PostcodeNotFoundException $exception) {
    echo "Postcode was not found.";
} catch (ValidationException $exception) {
    echo "No valid lookup query was provided.";
} catch (HttpException $exception) {
    echo "Something else went wrong on the server side.";
} catch (Exception $exception) {
    echo "Something went wrong in this application. Crap!";
}

Disclaimer

This package can be used free of charge. Obviously this software comes as is, and there are no warranties or whatsoever.