API

API

Email Checker provides a simple API that you may use to check email validity programmatically.

In order to use the API, you need to:

  1. Register an account
  2. Buy credits
  3. Create an API TOKEN
  4. Use the API TOKEN in your requests

The API is really simple. In order to check the validity of an email address, send a GET request to the following URL:

https://www.emailchecker.online/api/check/example@example.com

Replace the email address with the one you want to check. The API will return a JSON response with the following structure:

In order for the request to work, you need to authenticate by including your API Token as an Authorization header like this:

Authorization: Bearer <API TOKEN>

CURL Example:

curl  -H "Authorization: Bearer <API TOKEN>" https://www.emailchecker.online/api/check/example@example.com

Replace the <API TOKEN> with your API Token.

The response you will get will look like this:

                {
                    "email":"example@example.com",
                    "result":4,
                    "remaining_credits":2399,
                }

The result field will contain one of the following values:

0 for valid, existing email addresses
1 for email addresses with invalid format
2 for disposable email addresses
3 for unable to identify the existence of the email address
4 for non-existing email addresses
5 for existing email addresses that are role based