Email Verification API Documentation

Introduction

Our Email Verification API allows you to check the validity and status of email addresses. The API categorizes emails into different status types: LIVE, VERIFIED, DISABLED, UNKNOWN, and NOTEXISTS.

To use this API, you need to be a VIP user with API access enabled and a valid API key.

Authentication

All API requests require an API key which should be included in the request headers.

x-api-key: YOUR_API_KEY

Endpoints

Email Verification

POST https://emailscan.in/api/v1/email-check

Request Format

The API accepts a direct JSON array of email addresses.

[
  "email1@example.com",
  "email2@example.com",
  "email3@example.com"
]

⚠️ Only 1 request at a time is allowed. You can verify up to 50,000 email addresses in a single request.

Response Format

The API returns the results directly in JSON format.

{
  "ALL": "email1@example.com\nemail2@example.com\nemail3@example.com",
  "LIVE_COUNT": 1,
  "VERIFYED_COUNT": 1,
  "LIVE": "email1@example.com",
  "VERIFYED": "email2@example.com",
  "DISABLED_COUNT": 0,
  "UNKNOW_COUNT": 0,
  "DISABLED": "",
  "UNKNOW": "",
  "NOTEXISTS_COUNT": 1,
  "NOTEXISTS": "email3@example.com"
}

Code Examples

JavaScript

// Using Node.js with axios
const axios = require('axios');

async function verifyEmails() {
  // Array of emails to verify
  const emails = [
    'email1@example.com',
    'email2@example.com',
    'email3@example.com'
  ];
  
  try {
    const response = await axios.post('https://emailscan.in/api/v1/email-check', 
      emails,
      {
        headers: {
          'Content-Type': 'application/json',
          'x-api-key': 'YOUR_API_KEY'
        }
      }
    );
    
    console.log('Verification results:', response.data);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

verifyEmails();

Python

# Using Python with requests
import requests
import json

# Array of emails to verify
emails = [
    'email1@example.com',
    'email2@example.com',
    'email3@example.com'
]

# Make the API request
try:
    response = requests.post(
        'https://emailscan.in/api/v1/email-check',
        json=emails,  # Direct array, not an object
        headers={
            'Content-Type': 'application/json',
            'x-api-key': 'YOUR_API_KEY'
        }
    )
    
    # Check if the request was successful
    response.raise_for_status()
    
    # Get the results
    result = response.json()
    
    print('Verification results:', result)
except requests.exceptions.RequestException as e:
    print('Error:', str(e))

Response Status Codes

Status Code	Description
200	Success
400	Bad Request - The request was invalid
401	Unauthorized - API key is missing or invalid
403	Forbidden - Your API key doesn't have permission
429	Too Many Requests - You've exceeded your rate limit
500	Internal Server Error - Something went wrong on our end

Requirements for API Access

To use this API, you must meet all of the following requirements:

Be a API user with an active subscription.
Have API access enabled on your account
Have a valid API key

Contact our support team if you need help enabling API access for your account.

Support

If you need help with our API, please contact our support team atsupport@emailscan.in