PHPackages                             matthewbdaly/laravel-postcodes - 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. matthewbdaly/laravel-postcodes

ActiveLibrary[API Development](/categories/api)

matthewbdaly/laravel-postcodes
==============================

A Laravel and Lumen integration for matthewbdaly/postcode-client to enable postcode lookups with Ideal Postcodes

0.0.2(8y ago)136MITPHP

Since Nov 28Pushed 8y ago1 watchersCompare

[ Source](https://github.com/matthewbdaly/laravel-postcodes)[ Packagist](https://packagist.org/packages/matthewbdaly/laravel-postcodes)[ RSS](/packages/matthewbdaly-laravel-postcodes/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (9)Versions (3)Used By (0)

laravel-postcodes
=================

[](#laravel-postcodes)

Laravel Postcode lookup integration [![Build Status](https://camo.githubusercontent.com/fafd1cf19ae311c053a1612eec2f0233290753d65ba96306db64abf4ad739e99/68747470733a2f2f7472617669732d63692e6f72672f6d6174746865776264616c792f6c61726176656c2d706f7374636f6465732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/matthewbdaly/laravel-postcodes)[![Coverage Status](https://camo.githubusercontent.com/11d5bf3864ea5b922d41bf2e58a88682aaaa1126ee53de843d4910591fc3132d/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d6174746865776264616c792f6c61726176656c2d706f7374636f6465732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/matthewbdaly/laravel-postcodes?branch=master)

UK postcode lookup service provider for Laravel and Lumen. Uses [Postcode Client](https://github.com/matthewbdaly/postcode-client) to enable lookups using Ideal Postcodes.

Note that this service provider caches lookups indefinitely, since they don't change too often, but you may want to clear the cache from time to time. To do this, flush the `postcodes` tag.

Installation for Laravel
------------------------

[](#installation-for-laravel)

This package is only intended for Laravel 5.5 and up. Install it with the following command:

```
$ composer require matthewbdaly/laravel-postcodes
```

Then publish the config file:

```
$ php artisan vendor:publish
```

And add your API key to the `.env` file:

```
IDEAL_POSTCODES_API_KEY=foo
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

2

Last Release

3086d ago

### Community

Maintainers

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

---

Top Contributors

[![matthewbdaly](https://avatars.githubusercontent.com/u/450801?v=4)](https://github.com/matthewbdaly "matthewbdaly (19 commits)")

---

Tags

laravellaravel-postcodeslumenpostcodelaravellumenpostcode

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/matthewbdaly-laravel-postcodes/health.svg)

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

###  Alternatives

[mollie/laravel-mollie

Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[wxm/pdd-sdk

拼多多 SDK 封装, 调用简单、语义化增强。支持 Laravel/Lumen。

154.7k](/packages/wxm-pdd-sdk)

PHPackages © 2026

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