PHPackages                             jdavidbakr/address-verification - 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. jdavidbakr/address-verification

ActiveLibrary

jdavidbakr/address-verification
===============================

A service that performs address verification using the API at https://www.intelligentsearch.com/

2.1.2(5y ago)3875MITPHP

Since Sep 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/jdavidbakr/AddressVerification)[ Packagist](https://packagist.org/packages/jdavidbakr/address-verification)[ RSS](/packages/jdavidbakr-address-verification/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (5)Versions (9)Used By (0)

AddressVerification
===================

[](#addressverification)

[![Latest Version on Packagist](https://camo.githubusercontent.com/9f48756c86c957eafa5fc2d3f9779d6d650eeb2395af6cffff5bfbf987439669/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a646176696462616b722f616464726573732d766572696669636174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jdavidbakr/address-verification)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/a4867fa08da6ad379394ae0aa802f6cfb8cd098256774448b7967cb650961e3b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a646176696462616b722f616464726573732d766572696669636174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jdavidbakr/address-verification)

### Upgrading from version 1.x

[](#upgrading-from-version-1x)

The following changes happened between 1.x and 2.0:

- The config information is not added to the `config/services.php` file instead of having its own file
- The package now throws exceptions and events instead of expecting you to handle it.

### How to use

[](#how-to-use)

A Laravel Service that uses intelligentsearch.com to validate mailing addresses.

This class sends an address to  via their API and updates the address with the most relevant result. It is built to run within Laravel.

Note that in its current state it does not return multiple results.

#### To install:

[](#to-install)

```
composer require jdavidbakr/address-verification

```

The package is auto-discovered in Laravel.

Add the following section to `config/services.php`:

```
    'intelligentsearch'=>[
        'username'=>env('INTELLIGENTSEARCH_USERNAME'),
        'password'=>env('INTELLIGENTSEARCH_PASSWORD'),
        'cache_time'=>90, // in days.  Set to 0 to have no cache.
    ],

```

There will be a file now located at config/address-verification.php to set your intelligentsearch.com username and password.

#### To use:

[](#to-use)

Create an object of type \\jdavidbakr\\AddressVerification\\AddressRequest and fill in the appropriate values. Then call \\jdavidbakr\\AddressVerification\\AddressVerificationService::Verify($request) with the cerated request. You will receive back an object of type \\jdavidbakr\\AddressVerification\\AddressVerificationResponse.

```
$request = new \jdavidbakr\AddressVerification\AddressRequest;
$request->delivery_line_1 = '1600 Pennsylvania Ave NW';
$request->city_state_zip = 'Washington DC 20500';
try {
    $result = \jdavidbakr\AddressVerification\AddressVerificationService::Verify($request);
    // Alternatively use the facade:
    $result = AddressVerification::Verify($request);
} catch(\jdavidbakr\AddressVerification\VerificationFailedException $e) {
    // Handle what to do if the verification failed
}

```

The request defaults to ca\_codes of McRy which returns mixed case and enables street address parsing for no-match addresses.

You will receive an `AddressResponse` object if successful. The main properties you'll likely use in the response are:

- DeliveryLine1
- City
- State
- ZipAddon

#### Exceptions

[](#exceptions)

The following exceptions can be thrown (all namespaced to the package):

- `VerificationFailedException` - you should watch for this exception and decide how to handle it. Basically it means that you are not getting any data from the response.
- `MissingIntelligentSearchCredentialsException` - Fired if you haven't included credentials.

#### Events

[](#events)

- `AddressVerificationCompleted` - this is an event that is fired every time an address verification is completed. Use it to check the `SearchesLeft` attribute, if you want to send a notification that it's running low. It receives in its payload the `AddressResponse`.

```
public function handle($event)
{
    $searchesLeft = $event->response->SearchesLeft;
    if($searchesLeft < 1000) {
        Bugsnag::notifyError('LowIntelligentSearchQueries', 'IntelligentSearch queries are low', function($report) use($searchesLeft) {
            $report->setSeverity('warning');
            $report->setMetaData([
                'remaining'=>$searchesLeft
            ]);
        });
    }
}

```

View the [IntelligentSearch documentation](https://www.intelligentsearch.com/CorrectAddressWS/Documentation/CorrectAddress%20WebServices.pdf) for details about what all the returned fields are, as well as the request attributes.

###  Health Score

32

—

LowBetter than 74% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity68

Established project with proven stability

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

Recently: every ~355 days

Total

8

Last Release

2020d ago

Major Versions

1.1.1 → 2.02019-08-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/28fc80e04726581ef8fd2cda5300c45a22d67437c62bbaa7be372feb46256640?d=identicon)[jdavidbakr](/maintainers/jdavidbakr)

---

Top Contributors

[![jdavidbakr](https://avatars.githubusercontent.com/u/25177?v=4)](https://github.com/jdavidbakr "jdavidbakr (6 commits)")

---

Tags

Address Verificationintelligentsearch

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jdavidbakr-address-verification/health.svg)

```
[![Health](https://phpackages.com/badges/jdavidbakr-address-verification/health.svg)](https://phpackages.com/packages/jdavidbakr-address-verification)
```

###  Alternatives

[amirbagh75/smsir-php

Unofficial sms.ir PHP Package

181.2k](/packages/amirbagh75-smsir-php)

PHPackages © 2026

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