PHPackages                             chabter/laravel-dutch-postalcode-lookup - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. chabter/laravel-dutch-postalcode-lookup

ActiveLibrary[Utility & Helpers](/categories/utility)

chabter/laravel-dutch-postalcode-lookup
=======================================

Laravel wrapper to perform a Dutch postal code (postcode) lookup using the publicly available PDOK Locatieserver v3.

2.1.0(1y ago)146.7k1MITPHPPHP ^7.3|^8.0

Since Dec 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/cbytedigital/laravel-dutch-postalcode-lookup)[ Packagist](https://packagist.org/packages/chabter/laravel-dutch-postalcode-lookup)[ RSS](/packages/chabter-laravel-dutch-postalcode-lookup/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (8)Used By (0)

Laravel Dutch postal code (postcode) lookup
===========================================

[](#laravel-dutch-postal-code-postcode-lookup)

[![PHP from Packagist](https://camo.githubusercontent.com/94dc3e9bddc889ea4783e56e3e157b20a22ca962aba1556dcbd051a6b44a149b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f636861627465722f6c61726176656c2d64757463682d706f7374616c636f64652d6c6f6f6b75702e737667)](https://packagist.org/packages/chabter/laravel-dutch-postalcode-lookup)[![Latest Version on Packagist](https://camo.githubusercontent.com/b03777cb380722983a66c645d5d7d278ca2f400388f363ef82d819faea7234bc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636861627465722f6c61726176656c2d64757463682d706f7374616c636f64652d6c6f6f6b75702e737667)](https://packagist.org/packages/chabter/laravel-dutch-postalcode-lookup)[![Software License](https://camo.githubusercontent.com/31defcb558f617faee9d798eb0dcd334ebb42b3ca50b2481b3c62f0c80b3da8d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636861627465722f6c61726176656c2d64757463682d706f7374616c636f64652d6c6f6f6b75702e737667)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/8ce180b61aae34f697e822de8706ef4ab055c60e1fa2477e2d6f7bf2ea614b5f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636861627465722f6c61726176656c2d64757463682d706f7374616c636f64652d6c6f6f6b75702e737667)](https://packagist.org/packages/chabter/laravel-dutch-postalcode-lookup)

This package is a [Laravel](https://laravel.com) wrapper of [Nationaal Georegister provider for Geocoder PHP](https://github.com/swisnl/geocoder-php-nationaal-georegister-provider), which can be used to lookup a postal code to return the corresponding street and city.

The publicly available [PDOK Locatieserver v3 (Dutch)](https://www.pdok.nl/diensten#PDOK%20Locatieserver) is utilized to provide the necessary geodata.

Installation
------------

[](#installation)

Use composer to install this package:

```
$ composer require chabter/laravel-dutch-postalcode-lookup
```

Usage
-----

[](#usage)

Perform a lookup by postal code:

```
PostalCodeLookupService::lookup('1012JS');
```

Or perform a lookup by a postal code and house number combination:

```
PostalCodeLookupService::lookup('1012JS', 1);
```

The lookup method also supports using house number extensions as follows:

```
PostalCodeLookupService::lookup('1012JS', '5B');
```

### Response

[](#response)

The lookup method returns a `Chabter\PostalCodeLookup\Models\Address` model on success, for example:

```
$address->getPostalCode() => '1012JS';
$address->getHouseNumber() => 1; // or string including housenumber extension
$address->getStreet() => 'Dam';
$address->getCity() => 'Amsterdam';
$address->getCoordinates() => [ latitude: 0.0000, longitude: 0.0000 ];
```

Testing
-------

[](#testing)

Run the tests with:

```
$ composer test
```

Support
-------

[](#support)

VersionLaravel VersionPHP Version2.x8.x^7.3|^8.01.x7.x>=7.2Version 1.x will also work with Laravel 8 if Guzzle 6 is available (`^6.5|7.0` in composer.json).

Postcardware
------------

[](#postcardware)

This package is completely free to use. If it makes it to your production environment we would highly appreciate you sending us a postcard from your hometown! 👏🏼

Our address is: CBYTE Software B.V., Parallelweg 27, 5223AL 's-Hertogenbosch, Netherlands.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance48

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~395 days

Total

5

Last Release

384d ago

Major Versions

1.0.1 → 2.02021-02-20

PHP version history (2 changes)1.0.0PHP >=7.2

2.0PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/b08470e64109ccb0f059dc3881c9c52b750954a0bf388d13685f498399772f24?d=identicon)[cbytedigital](/maintainers/cbytedigital)

---

Top Contributors

[![magweter](https://avatars.githubusercontent.com/u/27769920?v=4)](https://github.com/magweter "magweter (3 commits)")[![robincbyte](https://avatars.githubusercontent.com/u/98814996?v=4)](https://github.com/robincbyte "robincbyte (2 commits)")[![gerkereitz](https://avatars.githubusercontent.com/u/58658920?v=4)](https://github.com/gerkereitz "gerkereitz (1 commits)")[![ksmits-cbyte](https://avatars.githubusercontent.com/u/189243019?v=4)](https://github.com/ksmits-cbyte "ksmits-cbyte (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/chabter-laravel-dutch-postalcode-lookup/health.svg)

```
[![Health](https://phpackages.com/badges/chabter-laravel-dutch-postalcode-lookup/health.svg)](https://phpackages.com/packages/chabter-laravel-dutch-postalcode-lookup)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin

DHL Parcel plugin for Magento 2

11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)