Laravel package for using the Ideal Postcodes API at https://ideal-postcodes.co.uk/

dev-master 2017-01-28 14:28 UTC

This package is auto-updated.

Last update: 2022-01-13 06:36:45 UTC


Build Status Coverage Status Dependency Status

Latest Stable Version Total Downloads

PHP Laravel 5 package for the Ideal Postcodes API.


  • PHP 5.5+
  • Laravel 5.x
  • Ideal Postcodes Account and API Key


Install by composer

You can find this library on Packagist.

To install ideal-postcodes-laravel with Composer, run the following command:

$ composer require squigg/ideal-postcodes-laravel


The package publishes a configuration file to your config directory where you can update the configuration for your app.

$ php artisan vendor:publish --tag=config

Add the IdealPostcodesServiceProvider and (if desired) the Facade alias to your app.php:

'providers' => [




'aliases' => [


    'IdealPostcodes' => 'Squigg\IdealPostcodes\Facades\IdealPostcodesFacade',


Add an IDEALPOSTCODES_API_KEY to your .env file with your Ideal Postcodes API key


Configuration File Settings

All available settings are documented within the config/ideal-postcodes.php configuration file.


Simply call the \IdealPostcodes Facade, or add a dependency in any constructor to IdealPostcodes

Change log

See changelog

Copyright © 2016 Steve Strugnell. Released under the MIT License <docs/license.rst>_.