PHPackages phpexperts/neverbounce - 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. phpexperts/neverbounce ActiveLibrary[API Development](/categories/api) phpexperts/neverbounce ====================== A quick and easy client for the NeverBounce API. v2.2.0(6y ago)1239MITPHPPHP >=7.1CI failing Since Jun 5Pushed 1y ago1 watchersCompare [ Source](https://github.com/phpexpertsinc/NeverBounce)[ Packagist](https://packagist.org/packages/phpexperts/neverbounce)[ Docs](https://www.phpexperts.pro/)[ RSS](/packages/phpexperts-neverbounce/feed)WikiDiscussions master Synced today READMEChangelogDependencies (11)Versions (8)Used By (0) NeverBounce Client ================== [](#neverbounce-client) [![TravisCI](https://camo.githubusercontent.com/4395e5a9bed42a0b848bbed7832eebed42d4b9506de1c5d5a198dd2d72531788/68747470733a2f2f7472617669732d63692e6f72672f70687065787065727473696e632f4e65766572426f756e63652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/phpexpertsinc/NeverBounce)[![Maintainability](https://camo.githubusercontent.com/944e8cecab21cd5ae4c9d7a26cc19e805cfdf987184dc363b0ef177035f8b80d/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f61613766353261316431616662663338333930342f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/phpexpertsinc/NeverBounce/maintainability)[![Test Coverage](https://camo.githubusercontent.com/80cf52b3c48d3cce607b0c5089e3af18ec227ed1877d6b795b68ccf9b5aa1dff/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f61613766353261316431616662663338333930342f746573745f636f766572616765)](https://codeclimate.com/github/phpexpertsinc/NeverBounce/test_coverage) NeverBounce Client is a PHP Experts, Inc., Project aimed at easily accessing the NeverBounce API. Installation ------------ [](#installation) Via Composer ``` composer require phpexperts/neverbounce ``` Usage ----- [](#usage) ### Validate a single email address [](#validate-a-single-email-address) ``` // Build the client. $client = NeverBounceClient::build(); // Quickly determine if an email is valid or not. $response = $client->isValid('theodore@phpexperts.pro'); // Output: true or false // Get details as to why an email is valid or not. $emailValidationDTO = $client->validate('doesnt-exist@gmail.com'); /* Output: { +"status": "success" +"result": "invalid" +"flags": array:4 [ 0 => "free_email_host" 1 => "has_dns" 2 => "has_dns_mx" 3 => "smtp_connectable" ] +"suggested_correction": "" +"execution_time": 309 } */ ``` ### Bulk email address validation [](#bulk-email-address-validation) ``` // Build the client. $client = NeverBounceClient::build(); // Create the job over at NeverBounce. $jobId = $client->bulkVerify(['support@neverbounce.com', 'sales@phpexperts.pro']); // Periodicly check the job for results. for ($a = 0; $a < 30; ++$a) { $bulkValidationDTO = $client->checkJob($jobId); if (!$bulkValidationDTO) { sleep(1); } break; } /** Output: BulkValidationDTO [ 'status' => 'success', 'id' => 2917483, 'job_status' => 'complete', 'filename' => 'bulk-1559703280.csv', 'created_at' => Carbon: '2019-06-04 22:54:41', 'started_at' => Carbon: '2019-06-04 22:54:42', 'finished_at' => Carbon: '2019-06-04 22:54:47', 'total' => ListStatsDTO [ 'records' => 7, 'billable' => 5, 'processed' => 7, 'valid' => 3, 'invalid' => 3, 'catchall' => 1, 'disposable' => 0, 'unknown' => 0, 'duplicates' => 1, 'bad_syntax' => 1, ], 'bounce_estimate' => 28.571428571429, 'percent_complete' => 100, 'execution_time' => 12, ] */ ``` All DTOs are easily converted to an array, JSON, and are serializable. See the [**SimpleDTO Project**](http://github.com/phpexpertsinc/SimpleDTO) for details. - To an array: `$listStats->toArray()` - To JSON: json\_encode($listStats); - Serialize (as JSON): serialize($listStats); Use cases --------- [](#use-cases) PHPExperts\\NeverBounceClient ✔ Can build itself ✔ Will validate a good email ✔ Will validate a catch all email ✔ Will validate an invalid domain email ✔ Will validate an invalid account email ✔ Will detect free email hosts ✔ Can determine if an email is good ✔ Can determine if an email has an invalid domain ✔ Can determine if an email has an invalid account PHPExperts\\NeverBounceClient: Bulk Validations ✔ Can submit a bulk validation request ✔ Can poll job until completed ✔ Will retrieve bulk validation results Testing ------- [](#testing) ``` # Run without needing a NeverBounce key / not using up your free quota. phpunit --testdox --exclude-group=thorough # Run the full suite. phpunit --testdox ``` Contributors ------------ [](#contributors) [Theodore R. Smith](https://www.phpexperts.pro/%5D) GPG Fingerprint: 4BF8 2613 1C34 87AC D28F 2AD8 EB24 A91D D612 5690 CEO: PHP Experts, Inc. License ------- [](#license) MIT license. Please see the [license file](LICENSE) for more information. ### Health Score 31 — LowBetter than 66% of packages Maintenance35 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity59 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 ~68 days Recently: every ~86 days Total 6 Last Release 2241d ago Major Versions v1.0.0 → v2.0.02019-06-06 ### Community Maintainers ![](https://www.gravatar.com/avatar/3f3a2dd16766f6b03c330e65aaca9dfb97f1bbbb41c5e2af5681f58f670b7917?d=identicon)[hopeseekr](/maintainers/hopeseekr) --- Top Contributors [![hopeseekr](https://avatars.githubusercontent.com/u/1125541?v=4)](https://github.com/hopeseekr "hopeseekr (29 commits)") --- Tags apineverbounceneverbounce client ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/phpexperts-neverbounce/health.svg) ``` [![Health](https://phpackages.com/badges/phpexperts-neverbounce/health.svg)](https://phpackages.com/packages/phpexperts-neverbounce) ``` ### Alternatives [showdoc/showdoc ShowDoc is a tool greatly applicable for an IT team to share documents online 12.8k7.1k](/packages/showdoc-showdoc)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1348.7k1](/packages/jasara-php-amzn-selling-partner-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)