PHPackages                             postcode-nl/api-magento2-module - 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. postcode-nl/api-magento2-module

ActiveMagento2-module[API Development](/categories/api)

postcode-nl/api-magento2-module
===============================

Postcode.eu Address Validation module for Magento 2. Adds autocompletion for addresses in multiple countries using official postal data.

4.0.0(1mo ago)12306.8k—6.9%17[8 issues](https://github.com/postcode-nl/PostcodeNl_Api_Magento2/issues)[2 PRs](https://github.com/postcode-nl/PostcodeNl_Api_Magento2/pulls)1BSD-2-ClausePHPPHP ^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4 || ^8.5

Since Nov 28Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/postcode-nl/PostcodeNl_Api_Magento2)[ Packagist](https://packagist.org/packages/postcode-nl/api-magento2-module)[ Docs](https://www.postcode.eu)[ RSS](/packages/postcode-nl-api-magento2-module/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (37)Used By (1)

[![Postcode.eu](media/postcode-eu-logo-gradient.svg)](media/postcode-eu-logo-gradient.svg)

International Address API module for Magento 2
----------------------------------------------

[](#international-address-api-module-for-magento-2)

Adds autocompletion for addresses to the checkout page. [Multiple countries](https://www.postcode.eu/products/address-api/international) are supported using official postal data via the [Postcode.eu](https://postcode.eu) API.

This module is maintained by [Postcode.eu](https://postcode.eu).

Postcode.eu account
-------------------

[](#postcodeeu-account)

A [Postcode.eu account](https://account.postcode.eu) is required. Testing is free. After testing you can choose to purchase a subscription.

Installation instructions
-------------------------

[](#installation-instructions)

1. Install this component using Composer:

```
$ composer require postcode-nl/api-magento2-module
```

2. Upgrade, compile &amp; clear cache:

```
$ php bin/magento setup:upgrade
$ php bin/magento setup:di:compile
$ php bin/magento cache:flush
```

Screenshots
-----------

[](#screenshots)

### International Address API

[](#international-address-api)

A single field for autocompletion:

[![](media/example-intl-api-be.png)](media/example-intl-api-be.png)[![](media/example-intl-api-de.png)](media/example-intl-api-de.png)

To allow users to skip the autocomplete field and manually enter an address, there's an option to add a link to manual address entry:

[![](media/example-intl-api-manual-entry-option.png)](media/example-intl-api-manual-entry-option.png)

### Dutch Postcode API

[](#dutch-postcode-api)

Get a Dutch address by postcode and house number. In this example asking the user to select from valid house number additions:

[![](media/example-nl-api-house-number-addition.png)](media/example-nl-api-house-number-addition.png)

A formatted address is shown when the postcode and house number combination is valid (this is the default output option):

[![](media/example-nl-api-formatted-output.png)](media/example-nl-api-formatted-output.png)

Other output options are:

- Hide address fields until postcode and house number combination is valid.
- Disable address fields until postcode and house number combination is valid.
- No change; address fields remain visible and editable.

GraphQL Support
---------------

[](#graphql-support)

Our module now supports GraphQL, allowing you to query address data via Magento's GraphQL API. This enables integration with headless Magento setups, progressive web applications (PWAs), and other front-end technologies that leverage GraphQL.

Compatibility
-------------

[](#compatibility)

Although we can't guarantee compatibility with other checkout modules, our module works well with most one-step-checkout modules. If you are having issues and think this may be caused by our module, please [contact Postcode.eu](mailto:tech@postcode.nl) and tell us which other module(s) and version(s) are used.

If you found the solution already and have some code to contribute, feel free to open a pull request in this repository.

Address API documentation
-------------------------

[](#address-api-documentation)

You can find our API documentation at .

Module Wiki
-----------

[](#module-wiki)

Instructions for additional configuration and customization can be found on the [wiki pages](https://github.com/postcode-nl/PostcodeNl_Api_Magento2/wiki).

FAQ and Knowledge Base
----------------------

[](#faq-and-knowledge-base)

- View Frequently Asked Questions at .
- For more questions and answers, see
- If the above didn't answer your question, [contact us](https://www.postcode.eu/contact).

License
-------

[](#license)

The code is available under the Simplified BSD License, see the included LICENSE file.

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance75

Regular maintenance activity

Popularity46

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity87

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 79.1% 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 ~66 days

Recently: every ~38 days

Total

36

Last Release

56d ago

Major Versions

1.0.3 → 2.0.02020-02-10

2.0.4 → 3.0.02021-03-31

3.7.1 → 4.0.02026-03-23

PHP version history (8 changes)1.0.0PHP 7.\*|~7.0.6

3.0.2PHP 7.\*

3.1.6.1PHP 7.\* || ^8.0 || ^8.1

3.1.7PHP ^7.4 || ^8.0 || ^8.1

3.1.10PHP ^7.4 || ^8.0 || ^8.1 || ^8.2

3.2.0PHP ^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3

3.5.0PHP ^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4

3.7.0PHP ^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4 || ^8.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/94ad1a9b5b839c987256dc488c5250ae447bc5401367f20aaf34b1c559213693?d=identicon)[Postcode.nl Tech](/maintainers/Postcode.nl%20Tech)

---

Top Contributors

[![JerrySmidt](https://avatars.githubusercontent.com/u/76106990?v=4)](https://github.com/JerrySmidt "JerrySmidt (204 commits)")[![JozefVerhoef](https://avatars.githubusercontent.com/u/6205086?v=4)](https://github.com/JozefVerhoef "JozefVerhoef (29 commits)")[![tmishutin](https://avatars.githubusercontent.com/u/11507459?v=4)](https://github.com/tmishutin "tmishutin (7 commits)")[![Paulsky](https://avatars.githubusercontent.com/u/9481318?v=4)](https://github.com/Paulsky "Paulsky (5 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (4 commits)")[![Nav-Appaiya](https://avatars.githubusercontent.com/u/9272210?v=4)](https://github.com/Nav-Appaiya "Nav-Appaiya (2 commits)")[![aadmathijssen](https://avatars.githubusercontent.com/u/3796971?v=4)](https://github.com/aadmathijssen "aadmathijssen (1 commits)")[![umizoomi](https://avatars.githubusercontent.com/u/4329209?v=4)](https://github.com/umizoomi "umizoomi (1 commits)")[![BastiaanGrutters](https://avatars.githubusercontent.com/u/5583611?v=4)](https://github.com/BastiaanGrutters "BastiaanGrutters (1 commits)")[![claudio-ferraro](https://avatars.githubusercontent.com/u/54107647?v=4)](https://github.com/claudio-ferraro "claudio-ferraro (1 commits)")[![FrankStappers](https://avatars.githubusercontent.com/u/7890079?v=4)](https://github.com/FrankStappers "FrankStappers (1 commits)")[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (1 commits)")[![SjonHortensius](https://avatars.githubusercontent.com/u/1684987?v=4)](https://github.com/SjonHortensius "SjonHortensius (1 commits)")

### Embed Badge

![Health badge](/badges/postcode-nl-api-magento2-module/health.svg)

```
[![Health](https://phpackages.com/badges/postcode-nl-api-magento2-module/health.svg)](https://phpackages.com/packages/postcode-nl-api-magento2-module)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[subscribepro/subscribepro-magento2-ext

Subscribe Pro Magento 2 Integration Extension

24157.3k](/packages/subscribepro-subscribepro-magento2-ext)[flekto/postcode

Postcode.eu International Address API module for Magento 2. Adds autocompletion for addresses in multiple countries using official postal data.

118.0k](/packages/flekto-postcode)[yireo/magento2-graph-ql-rate-limiting

Magento 2 module to add rate limiting to GraphQL resources

1419.8k](/packages/yireo-magento2-graph-ql-rate-limiting)

PHPackages © 2026

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