PHPackages                             bledileka/emailcleaningclub-api - 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. bledileka/emailcleaningclub-api

ActiveLibrary[API Development](/categories/api)

bledileka/emailcleaningclub-api
===============================

A sample php interface for using the EmailCleaning.Club api services.

00PHP

Since Nov 21Pushed 4y ago1 watchersCompare

[ Source](https://github.com/bledileka/emailcleaningclub-api)[ Packagist](https://packagist.org/packages/bledileka/emailcleaningclub-api)[ RSS](/packages/bledileka-emailcleaningclub-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![EmailCleaning.Club](assets/emailcleaningclublogo.png)](assets/emailcleaningclublogo.png)

[EmailCleaning.Club](https://emailcleaning.club)

emailcleaningclub-api
=====================

[](#emailcleaningclub-api)

Simple cURL rest API calls to EmailCleaning.club endpoints. This script will make an email verification request.

Make sure to whitelist your servers IP address on your API key settings. If not, you wont be able to get any results.

Installation:

**Via composer:**

`composer require emailcleaningclub/cleanlist-php-api`

Sample call:

```

```

**Sample http cURL call:**

`curl "https://api.emailcleaning.club/api/v1/?api_key={your_api_key}&email={email_address}&check={basic|advanced}"`

**Responses:**

```
Array
(
    [code] => 401
    [message] => Unauthorized Access!
)
Invalid API key OR ip addess not whitelisted.

```

```
Array
(
    [code] => 200
    [status] => role
    [risklevel] => risky
    [message] => Role Based Email - Role based emails reflect different departments/roles, like: admin@ or sales@. These emails are not bad emails or to avoid, just make sure to be cautious.
    [verification_type] => advanced
    [verification_cost] => 2
)

Risklevel can be: safe|risky|bad
Status reflects the verification code. In most cases it is a logical word reflecting the result.

```

Common status codes:

CodeNameDescriptionRisklevelduplicatesDuplicated EmailsDuplicated rows are removed from your file and only unique emails are scanned.-invalidInvalid FormattingIn general, this validates e-mail addresses against the syntax in RFC 822, with the exceptions that comments and whitespace folding and dotless domain names are not supported.badnomxDomain has no MXThe domain doesn't have any valid MX records, there is no way to possibly send emails to this domain.badnonsDomain has no NSThe domain doesn't have any valid NS records, the domain might not have a website but its mailboxes can be active. Use with caution.riskyparkedDomain is ParkedThis domain is parked. In most cases the email addresses are accessible only by the webmaster, developer or only a small number of people. Use with coution if you need to.riskydisposableDisposable Email DomainA disposable email address (DEA) is a pain to marketers and often an indication of fraudulent activity online. Alternatively, a DEA is just a way for a consumer to fight back against spam and bad opt-in protocols, or a good tool for developers to test software.riskbaddomainsBad DomainThis domain is blacklisted and its known to cause problems. Avoid if you can.badblackholeBlackhole DomainBlackhole domains are used just for attracting spammers. These domains do no use any real MX but just to trap spammers.badroleRole Based EmailRole based emails reflect different departments/roles, like: admin@ or sales@. These emails are not bad emails or to avoid, just make sure to be cautious.riskycatchallCatchall EmailA catch-all email address is a mailbox which captures emails sent to your domain name that may have otherwise been lost because the email address they are being sent to doesn't existbadhardbouncesHardBounced EmailHard bounce is an email that has failed to deliver for permanent reasons, such as the recipient's address is invalid (either because the domain name is incorrect, isn't real, or the recipient is unknown.)badspamtrapsSpamtrap/HoneypotA spamtrap is a honeypot used to collect spam. Spamtraps are usually e-mail addresses that are created not for communication, but rather to lure spam. In order to prevent legitimate email from being invited, the e-mail address will typically only be published in a location hidden from view such that an automated e-mail address harvester (used by spammers) can find the email address, but no sender would be encouraged to send messages to the email address for any legitimate purpose.badbotclickersBotclickerEmail click bots are the close cousin to the SPAM bots, many designed to click links in emails as a way to explore, find, and exploit potential vulnerabilities.badcomplainersComplainerFor e-mailers, complainers are the people who hit the spam-complaint button on the messages they actually signed up to receive. You might think there's nothing to learn from these people.riskyinstitutionalInstitutional DomainDomain used by a well known public or private institution. Government, education or military are considered institutional.riskypossibleriskKnown Problematic EmailsWe do not have a fully detailed log for this group but we are sure this data is not 100% safe to use. Be cautious.riskybadkeywordBad KeywordThe email address contains a word classified as bad in our systems. These emails are not always fake or bad so be cautious while sending to this category.risky

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/21483498fc9dfec47c70c6c4a31991b5eeca2b770fef7e9fb9e84c9300a58f76?d=identicon)[bledileka](/maintainers/bledileka)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/bledileka-emailcleaningclub-api/health.svg)

```
[![Health](https://phpackages.com/badges/bledileka-emailcleaningclub-api/health.svg)](https://phpackages.com/packages/bledileka-emailcleaningclub-api)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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