Documentation

Build secure and reliable email flows with the EmailCheck API. Everything you need to integrate real-time verification into your apps.


Introduction

The EmailCheck REST API allows you to programmatically verify email addresses using our proprietary multi-step validation engine. We provide real-time results with 99.6% accuracy.

GET https://api.emailcheck.cc/v1/verify?email=test@example.com

Quick Start

Get up and running in less than 5 minutes. Follow these three simple steps to start validating emails.

1

Get your API Key

Sign up for a free account and copy your unique API key from the developer dashboard.

2

Make your first request

Use cURL or any HTTP client to send a GET request to our verification endpoint.

3

Parse the JSON response

Our API returns a structured JSON object containing the validation status and quality score.

Authentication

Authenticate your requests by including your API Key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Verify Single Email

Endpoint for real-time validation of a single address.

Request Parameters

  • email Required
  • timeout Optional (Default: 10s)
// Response Format
{
  "email": "test@example.com",
  "status": "valid",
  "score": 0.98,
  "checks": {
    "smtp": true,
    "syntax": true,
    "mx": true
  }
}

Batch Verification

Verify thousands of emails at once by uploading a JSON array or a CSV file via our bulk endpoint.

// POST /v1/batch
[
  "user1@example.com",
  "user2@domain.org",
  "invalid-email-3"
]

Batch requests are processed asynchronously. You will receive a job_id to track the progress.

Status Codes

Our API uses standard HTTP response codes to indicate the success or failure of an API request.

Code Description
200 Request was successful.
400 Bad Request. Often due to missing parameters.
401 Unauthorized. Check your API key.
429 Too Many Requests. Rate limit exceeded.
500 Internal Server Error. Our team has been notified.

Official SDKs

We maintain official libraries for the most popular languages to help you integrate faster.

JS

Node.js SDK

npm install @emailcheck/sdk View on GitHub →
PY

Python SDK

pip install emailcheck-python View on GitHub →

Troubleshooting

1

Invalid API Key

Ensure your key is copied correctly from your dashboard. Keys are case-sensitive.

2

Rate Limit Exceeded

Enterprise users can request higher limits via the technical support channel.

Get Started

Ready to get started?

Start your EmailCheck journey for free. No credit card required.