PHPackages                             sqits/laravel-postcode - 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. [API Development](/categories/api)
4. /
5. sqits/laravel-postcode

ActiveLibrary[API Development](/categories/api)

sqits/laravel-postcode
======================

Laravel wrapper for the postcode-nl api

v0.1.4(2y ago)0293MITPHPPHP ^8.0

Since Oct 11Pushed 2y ago1 watchersCompare

[ Source](https://github.com/sqits/laravel-postcode)[ Packagist](https://packagist.org/packages/sqits/laravel-postcode)[ RSS](/packages/sqits-laravel-postcode/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)Dependencies (3)Versions (6)Used By (0)

Laravel wrapper for postcode-nl api
===================================

[](#laravel-wrapper-for-postcode-nl-api)

Installation and usage
----------------------

[](#installation-and-usage)

This package requires PHP 7.2 and Laravel 5.8 or higher. Install the package by running the following command in your console;

```
composer require sqits/laravel-postcode
```

You can publish the config file with:

```
php artisan vendor:publish --provider="Sqits\Postcode\PostcodeServiceProvider" --tag="config"
```

This is the contents of the published config file:

```
 /*
     * Request options required for GuzzleHttp client.
     */
    'requestOptions' => [

        /*
         * URI
         *
         * Settings which api url the package should use. There are several endpoints available
         */
        'uri' => [
            'extension' => env('POSTCODENL_URI_EXTENSION', 'nl'),
        ],

        /*
         * Authentication
         *
         * Register an account with Postcode.nl to obtain a key and secret. See https://api.postcode.nl/#register for
         * further information.
         */
        'auth' => [
            env('POSTCODENL_KEY', null),
            env('POSTCODENL_SECRET', null)
        ],

        /*
         * Timeout (in seconds)
         *
         * By default, the client waits 10 seconds for a response. You may set a different timeout.
         */
        'timeout' => env('POSTCODENL_TIMEOUT', 10),

    ],

    /*
     * Enable routes
     *
     * This package comes with a set of routes, which are not loaded by default. In order to use them, set this
     * option to true.
     */
    'enableRoutes' => env('POSTCODENL_ENABLE_ROUTES', false),
```

### Using the JSON API

[](#using-the-json-api)

In order to use the API, enabled it in the configuration. When enabled, the following route is available:

```
route('postcode-nl::address', [$postcode, $houseNumber, $houseNumberAddition = null]);
```

or use the following URL (e.g. for AJAX calls):

```
/postcode-nl/address/{postcode}/{houseNumber}/{houseNumberAddition?}

```

Configuration
-------------

[](#configuration)

### Credentials (required)

[](#credentials-required)

The key and secret are used for authentication. Without them, you cannot use the service.

```
POSTCODENL_KEY=
POSTCODENL_SECRET=
```

### Enable routes (optional)

[](#enable-routes-optional)

This package comes with a ready to use JSON API, which is disabled by default. You can enable it like so:

```
POSTCODENL_ENABLE_ROUTES=true
```

### Timeout (in seconds, optional)

[](#timeout-in-seconds-optional)

By default, the client waits 10 seconds for a response. You may set a different timeout.

```
POSTCODENL_TIMEOUT=
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Security
--------

[](#security)

If you discover any security-related issues, please [email](mailto:info@sqits.nl) to  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Sqits](https://github.com/sqits)
- [Milan Jansen](https://github.com/MilanJn)
- [Ruud Schaaphuizen](https://github.com/rschaaphuizen)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.8% of commits — single point of failure

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 ~405 days

Total

5

Last Release

787d ago

PHP version history (2 changes)v0.1PHP ^7.2

v0.1.4PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/6abbf8d1640aa378a0c78b27895f9ffb9a0842639ed214dc5281e37af8eac4e8?d=identicon)[MilanJn](/maintainers/MilanJn)

---

Top Contributors

[![MilanJn](https://avatars.githubusercontent.com/u/54810394?v=4)](https://github.com/MilanJn "MilanJn (24 commits)")[![roderick-sqits](https://avatars.githubusercontent.com/u/102077241?v=4)](https://github.com/roderick-sqits "roderick-sqits (3 commits)")[![rschaaphuizen](https://avatars.githubusercontent.com/u/517647?v=4)](https://github.com/rschaaphuizen "rschaaphuizen (2 commits)")

---

Tags

laravelzipcodepostcodepostcode-nlnederlandpostcode nederland

### Embed Badge

![Health badge](/badges/sqits-laravel-postcode/health.svg)

```
[![Health](https://phpackages.com/badges/sqits-laravel-postcode/health.svg)](https://phpackages.com/packages/sqits-laravel-postcode)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[nickurt/laravel-postcodeapi

Universal PostcodeApi for Laravel 11.x/12.x/13.x

97221.2k](/packages/nickurt-laravel-postcodeapi)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[spinen/laravel-clickup

SPINEN's Laravel Package for ClickUp.

282.2k](/packages/spinen-laravel-clickup)

PHPackages © 2026

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