Getting Started With the API

With our API, you can integrate Emaillistverify® email verification in your web applications.

To get started, you need to sign up. Once you are signed up, login to your account and navigate to API. Click ‘New API’, enter your desired API name and click ‘create’.

Once you have created an API, it will be visible in API dashboard. Click on it and note down the ‘API Key’ listed in ‘Code Example’ (shown below). You will need this API key while making requests to Emaillistverify®.

You can use our API for both single email verification and bulk email verification.

Single email verification

The API for single email verification is located at following URL:

https://app.emaillistverify.com/api/verifemail

Before making an API call for single email address, you need following two parameters and they should be appended with above URL:

  • secret - Your Emaillistverify® API key
  • email - Email address you need to verify

Below is an example of simple HTTP GET request:

https://app.emaillistverify.com/api/verifyEmail?secret=tiPcJsnFiZhBBotcDEYcx&email=rsanders@enpointe.com

Status

Our API will respond you with one of following statuses:

  • Ok - Email you provided exist
  • Unknown - Email you provided cannot be verified
  • Incorrect - Email you provided is not formatted properly
  • key_not_valid - Key you provided is not valid
  • missing parameters - You missed any required parameter in API call

Bulk email verification

The API for bulk email verification is located at below URL:

https://app.emaillistverify.com/api/verifApiFile

Following two parameters are required and must be appended with above URL:

  • secret - Your Emaillistverify® API key
  • filename - Path to your file

Below is an example of simple HTTP GET request for bulk email address verification:

https://app.emaillistverify.com/api/verifApiFile?secret=tiPcJsnFiZhBBotcDEYcx&filename=/home/Downloads/emails.txt

Status

  • ok - File you provide has been successfully verified
  • no_credit - You do not have any credit
  • cannot_upload_file - File you provided is broken
  • key_not_valid - Key you provided is not valid
  • missing parameters - You missed any required parameter in API call
    • PHP (Put a link to github pages)
    • Curl (Put a link to github pages)
    • Python (Put a link to github pages)
    • Ruby (Put a link to github pages)
    • .Net (Put a link to github pages)