Gmail Checker API

Automate Your Bulk Gmail Verification

Free Gmail checker API Docs - Email Scan API

For businesses, agencies, and developers managing large volumes of email data, manual verification is impossible. Integrating a reliable Gmail Checker API allows you to automate the entire status verification process directly into your own software, CRM, or marketing platform.

In this guide, we will explore how to use the Email Scan API to verify up to 50,000 Gmail addresses in a single request!

What Can the Email Scan API Do?

Our API is built for speed, accuracy, and ease of use. It categorizes email addresses into five distinct statuses for total clarity on the health of your list:

✅ LIVE: The account is active and actively processing mail.
✅ VERIFIED: The account requires a phone number verification to log in, but still exists and can receive mail.
❌ DISABLED: The account has been suspended or permanently deactivated by Google.
❌ NOTEXISTS: The account does not exist or has been permanently deleted.
⚠️ UNKNOWN: The status could not be clearly determined.

Getting Started: Access Requirements

To start verifying emails via the Email Scan API, you must meet the following criteria:

Active VIP Subscription: The API is a premium volume feature available exclusively to our VIP users.
API Access Enabled: Make sure API access is enabled on your account dashboard.
Valid API Key: Generate your unique x-api-key from your profile page and keep it secure.

⚠️ Rate Limit Note: The system handles massive scale natively. The API allows only 1 active request per user at a time, but you can submit up to 50,000 email addresses in a single request.

Endpoints and Authentication

All requests to the API must include your API key in the headers.

Endpoint:

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

Headers:

x-api-key: YOUR_API_KEY
Content-Type: application/json

Request and Response Formats

The API is designed for simplicity. You don't need to wrap your emails in complex JSON objects. Just send a direct JSON array of the email addresses you want to check.

Example Request:

[
  "johndoe@gmail.com",
  "janedoe@gmail.com",
  "invalid-email-123@gmail.com"
]

Example Response:

The API will return a structured JSON response categorizing all the emails you submitted, along with exact counts for each category.

{
  "ALL": "johndoe@gmail.com\njanedoe@gmail.com\ninvalid-email-123@gmail.com",
  "LIVE_COUNT": 1,
  "VERIFYED_COUNT": 1,
  "LIVE": "johndoe@gmail.com",
  "VERIFYED": "janedoe@gmail.com",
  "DISABLED_COUNT": 0,
  "UNKNOW_COUNT": 0,
  "DISABLED": "",
  "UNKNOW": "",
  "NOTEXISTS_COUNT": 1,
  "NOTEXISTS": "invalid-email-123@gmail.com"
}

Code Examples

Ready to integrate? Here are quick examples in popular backend languages.

JavaScript (Node.js / Fetch)

// The list of emails you want to check
const emails = [
  "test1@gmail.com",
  "test2@gmail.com"
];

const checkEmails = async () => {
  try {
    const response = await fetch("https://emailscan.in/api/v1/email-check", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY" // Replace with your actual key
      },
      body: JSON.stringify(emails)
    });

    const data = await response.json();
    console.log("Verification Results:", data);
  } catch (error) {
    console.error("Error verifying emails:", error);
  }
};

checkEmails();

Python (Requests)

import requests
import json

url = "https://emailscan.in/api/v1/email-check"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY" # Replace with your actual key
}

# The list of emails you want to check
emails = [
    "test1@gmail.com",
    "test2@gmail.com"
]

response = requests.post(url, headers=headers, data=json.dumps(emails))

if response.status_code == 200:
    print("Verification Results:", response.json())
else:
    print("Error:", response.status_code, response.text)

Response Status Codes

When building your integration, make sure to handle the following HTTP status codes natively in your application error boundaries:

200 Success: Everything worked perfectly and your response is ready.
400 Bad Request: The request format was invalid (e.g., you did not send a JSON array).
401 Unauthorized: Your API key is missing or invalid.
403 Forbidden: Your account doesn't have API access enable (VIP required).
429 Too Many Requests: You already have an active request running. Please wait for it to complete.
500 Internal Server Error: Something went wrong on our end.

Why Use the Email Scan API?

Integrating a bulk Gmail verification API into your workflow saves hundreds of hours of manual labor. Whether you are validating user signups in real-time or cleaning historical CRM data in bulk nightly batches, the Email Scan API is the most robust solution for managing Gmail account deliverability.

Ready to test it out? Head over to your Account Profile to generate your API key today, and start building!