Quickstart

Get up and running with CheckEmail.dev in minutes.

1. Get your API Key

Log in to your Dashboard and navigate to the API Keys section. Click "Create New Key".

Note: You receive 300 free credits immediately upon signup to test the API.

warning

Your API Key is shown only once. Make sure to copy it and store it securely.

2. Make a Request

You can use any HTTP client. Here is a simple example using curl.

curl -X GET "https://api.checkemail.dev/[email protected]" \
     -H "x-api-key: ce_d_xxxxxxxxxxxxxxxx"

3. Understand the Response

The API returns a JSON object containing the validation results and advanced classification data.

{
  "email": "[email protected]",
  "validations": {
    "syntax": true,
    "domain_exists": true,
    "mx_records": true,
    "is_disposable": false
  },
  "confidence": {
    "confidence_score": 98,
    "status": "LIKELY",
    "is_role_based": false,
    "alias_status": "ALIAS_CONFIRMED",
    "canonical_email": "[email protected]"
  },
  "provider": {
    "name": "Gmail"
  },
  "meta": {
    "latency_ms": 142,
    "source": "api"
  },
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

Status Codes

Status	Description
LIKELY	The email is likely valid (domain verified, not disposable).
INVALID	The email format is invalid or the domain could not be verified.
INVALID_FORMAT	The email syntax is incorrect.
INVALID_DOMAIN	The domain name does not exist.
NO_MX_RECORDS	The domain has no valid mail servers.
DISPOSABLE	The email belongs to a temporary/burner provider.