Philippines Address Lookup API for Laravel.

Fund package maintenance!

v11.0.0 2024-04-15 14:00 UTC


Philippines Address Lookup for Laravel

Latest Version on Packagist Continuous Integration Static Analysis Quality Score Total Downloads Software License

A package for providing Philippines Address lookup API with Laravel.


$ composer require yajra/laravel-address

Register service provider (Optional on Laravel 5.5+)


Publish config (Optional)

$ php artisan vendor:publish

Available Config

address.prefix To change the API base route.

address.middleware Route middleware.

Required Setup (Migration and Seeder)

  • Run the address migration.
php artisan migrate
  • Run the address seeder.
php artisan db:seed Yajra\\Address\\Seeders\\AddressSeeder


The default prefix for the api routes is /api/address. The default can be updated via config address.php file.

  • Get All Regions /api/address/regions.
  • Get All Provinces /api/address/provinces.
  • Get Provinces By Region /api/address/provinces/{regionId}.
  • Get Cities By Province /api/address/cities/{provinceId}.
  • Get Barangays By City /api/address/barangays/{cityId}.

Usage / Examples

Add address migration

Add address migration using $table->address(). This will add the following fields:

  • street
  • barangay_id
  • city_id
  • province_id
  • region_id

Include built-in form (Requires jQuery)

On your view, include @include('address::form', ['model' => $modelWithAddress])

Add scripts section on your master layout.

Before the end of body tag, include @stack('scripts').

-- Contents Here ---

<script src="/vendor/jquery.js"></script>

Model with Address Integration

Just use Yajra\Address\HasAddress trait on your model to load address models relationship.

use Yajra\Address\HasAddress;

class User extends Model {
    use HasAddress;

Change log

Please see CHANGELOG for more information what has changed recently.


Please see CONTRIBUTING and CONDUCT for details.


If you discover any security related issues, please email aqangeles@gmail.com instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.