API Documentation

1. Overview

The Email Check Tool API validates email addresses programmatically. It returns JSON with validity, score, and per-check flags (syntax, MX, disposable, role-based).

• Base URL: https://emailchecktool.com/api
• Authentication: API key in header (coming soon)
• Response format: JSON

2. Endpoints

POST /api/verify

Request body:

{
  "email": "test@example.com"
}

Response:

{
  "email": "test@example.com",
  "valid": true,
  "score": 85,
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role_based": false
  }
}

Live responses may wrap results in a result object from the current implementation. OpenAPI spec: openapi.json

3. Error codes

4. Code examples

curl

curl -X POST https://emailchecktool.com/api/verify \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com"}'

PHP

$response = \Illuminate\Support\Facades\Http::asJson()
    ->post('https://emailchecktool.com/api/verify', [
        'email' => 'test@example.com',
    ]);
$data = $response->json();

JavaScript (fetch)

const response = await fetch('https://emailchecktool.com/api/verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'test@example.com' })
});
const data = await response.json();

5. Rate limits

• Free: 10 requests per hour (subject to change; see pricing)
• Coming soon: Paid plans with higher limits and API keys