Instant Email Verification API Documentation

Instant Email Verification API

Introduction

Welcome to the EmailVerify.io Single Email Validation API! This API allows you to validate a single email address in real time with a simple request, ensuring accuracy and reliability in your email communications.

Authentication

To access the API, you’ll need a valid API key. You can generate your personal key from the API section after logging into your account. This key is required for authentication and to make requests securely.

API Endpoint

Validate a batch of email addresses by sending your API key and email batch in the body of POST request.:

Get Request URL (HTTPS)

https://app.emailverify.io/api/v1/validate?key=Your_API_Key&email=valid@example.com

Example Success Response

You would get a response like this if your single email request is successfully processed:

Response (JSON)

{ "email": "jhon123@gmail.com" ,

"status": "valid" ,

"sub_status": "permitted" }

Checks Performed in Single Email Validation

Error Responses

Error Message Description
Invalid API Key The provided API key is disabled or does not exist.
Invalid Request Invalid parameters were provided in the API endpoint.
0 Credits Remaining You do not have enough credits.
Please Try Again An internal error occurred. Try the request again.

Check Account Balance

Use the following GET request to check your current account balance.

Get Request URL (HTTPS):

https://app.emailverify.io/api/v2/check-account-balance?key=<Your_API_Key>

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):

{ "api_status": "enabled" ,

"available_credits": 16750 }

Available credits are the total of your daily available credits, refunded credits, and referral credits. The following endpoint is deprecated and will be removed in future versions.

Get Request URL (HTTPS) [Deprecated]:

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):

{ "api_status": "enabled" ,

"daily_credits_limit": 150 ,

"referral_credits": 100 ,

"remaining_credits": 15000 }