PHPackages                             samkitano/kbox - 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. [Validation &amp; Sanitization](/categories/validation)
4. /
5. samkitano/kbox

ActiveLibrary[Validation &amp; Sanitization](/categories/validation)

samkitano/kbox
==============

An implementation of kickbox.io email validation api for Laravel

v1.0.0(11y ago)1210MITPHPPHP &gt;=5.4.0

Since Jan 23Pushed 11y ago1 watchersCompare

[ Source](https://github.com/samkitano/kbox)[ Packagist](https://packagist.org/packages/samkitano/kbox)[ RSS](/packages/samkitano-kbox/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Kickbox for Laravel
===================

[](#kickbox-for-laravel)

[Kickbox](http://kickbox.io) is an Email Verification Library for PHP
---------------------------------------------------------------------

[](#kickbox-is-an-email-verification-library-for-php)

According to [kickbox-php](github.com/kickboxio/kickbox-php):

```
Kickbox determines if an email address is not only valid, but associated with a actual user. Uses include:

* Preventing users from creating accounts on your applications using fake, misspelled, or throw-away email addresses.
* Reducing bounces by removing old, invalid, and low quality email addresses from your mailing lists.
* Saving money and projecting your reputation by only sending to real email users.

## Getting Started

To begin, hop over to [kickbox.io] and create a free account. Once you've signed up and logged in, click on **API Settings** and then click **Add API Key**. Take note of the generated API Key - you'll need it to setup the client as explained below.

## Bug Reports
Report [here](https://github.com/kickboxio/kickbox-php/issues).

## Need Help?
help@kickbox.io

```

Installation
------------

[](#installation)

Add the following to your composer.json

```
{
    "require": {
        "samkitano/kbox": "dev-master"
    }
}
```

Update your dependencies

```
$ php composer.phar update
```

Open `app/config/app.php`, and add a new item to the providers array:

```
'Samkitano\Kbox\KboxServiceProvider',

```

Publish your configuration file:

```
php artisan config:publish samkitano/kbox

```

Edit `app/config/packages/samkitano/kbox/config.php` and provide your API key:

```
'kickbox_api_key'   => 'paste your kickbox api key here',

```

#### Versions

[](#versions)

Works with Laravel \[ 4.2 \]

Usage
-----

[](#usage)

```
$response = Kbox::verify('email@example.com');

```

### Response information (from kickbox.io)

[](#response-information-from-kickboxio)

A successful API call responds with the following values:

- **result** `string` - The verification result: `valid`, `invalid`, `unknown`
- **reason** `string` - The reason for the result. Possible reasons are:
    - `invalid_email` - Specified email is not a valid email address syntax
    - `invalid_domain` - Domain for email does not exist
    - `rejected_email` - Email address was rejected by the SMTP server, email address does not exist
    - `accepted_email` - Email address was accepted by the SMTP server
    - `no_connect` - Could not connect to SMTP server
    - `timeout` - SMTP session timed out
    - `invalid_smtp` - SMTP server returned an unexpected/invalid response
    - `unavailable_smtp` - SMTP server was unavailable to process our request
    - `unexpected_error` - An unexpected error has occurred
- **role** `true | false` - *true* if the email address is a *role* address (`postmaster@example.com`, `support@example.com`, etc)
- **free** `true | false` - *true* if the email address uses a free email service like gmail.com or yahoo.com.
- **disposable** `true | false` - *true* if the email address uses a *disposable* domain like trashmail.com or mailinator.com.
- **accept\_all** `true | false` - *true* if the email was accepted, but the domain appears to accept all emails addressed to that domain.
- **did\_you\_mean** `null | string` - Returns a suggested email if a possible spelling error was detected. (`bill.lumbergh@gamil.com` -&gt; `bill.lumbergh@gmail.com`)
- **sendex** `float` - A *quality* score of the provided email address ranging between 0 (no quality) and 1 (perfect quality). More information on the Sendex Score can be found [here](http://help.kickbox.io/support/solutions/articles/4000017047-the-sendex-).
- **email** `string` - Returns a normalized version of the provided email address. (`BoB@example.com` -&gt; `bob@example.com`
- **user** `string` - The user (a.k.a local part) of the provided email address. (`bob@example.com` -&gt; `bob`)
- **domain** `string` - The domain of the provided email address. (`bob@example.com` -&gt; `example.com`)
- **success** `true | false` - *true* if the API request was successful (i.e., no authentication or unexpected errors occured)

License
-------

[](#license)

MIT

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

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

Unknown

Total

1

Last Release

4133d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

laravelkickbox

### Embed Badge

![Health badge](/badges/samkitano-kbox/health.svg)

```
[![Health](https://phpackages.com/badges/samkitano-kbox/health.svg)](https://phpackages.com/packages/samkitano-kbox)
```

###  Alternatives

[propaganistas/laravel-phone

Adds phone number functionality to Laravel based on Google's libphonenumber API.

3.0k35.7M107](/packages/propaganistas-laravel-phone)[proengsoft/laravel-jsvalidation

Validate forms transparently with Javascript reusing your Laravel Validation Rules, Messages, and FormRequest

1.1k2.3M49](/packages/proengsoft-laravel-jsvalidation)[stevebauman/purify

An HTML Purifier / Sanitizer for Laravel

5325.6M19](/packages/stevebauman-purify)[axlon/laravel-postal-code-validation

Worldwide postal code validation for Laravel and Lumen

3853.3M1](/packages/axlon-laravel-postal-code-validation)[wendelladriel/laravel-validated-dto

Data Transfer Objects with validation for Laravel applications

759569.4k13](/packages/wendelladriel-laravel-validated-dto)[sunspikes/clamav-validator

Custom Laravel 5 anti-virus validator for file uploads.

3651.8M3](/packages/sunspikes-clamav-validator)

PHPackages © 2026

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