Single Validation

Verify a single email address in real-time.

Endpoint GET https://api.checkemail.dev/validate

Cost: 1 Credit

Parameters

Parameter	Type	Required	Description
email	string	Yes	The email address to verify.

Headers

Header	Value
x-api-key	Your API Key

Example Request

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

Response Body

The response contains a structured object with validation results, confidence metrics, and metadata.

Field	Type	Description
email	string	The email address that was validated.
validations	object	Breakdown of specific validation checks (syntax, domain_exists, mx_records, is_disposable).
confidence	object	Confidence metrics including score, status, role-based detection, and alias information.
confidence.confidence_score	number	A confidence score from 0-100 based on validation results.
confidence.status	string	The overall validity status (LIKELY, INVALID, DISPOSABLE, etc).
confidence.is_role_based	boolean	true if the email is generic (e.g. admin@, info@).
confidence.alias_status	string	ALIAS_CONFIRMED, ALIAS_POSSIBLE, or MAYBE_NOT_ALIAS. Indicates if the email uses sub-addressing (e.g. user+tag@).
confidence.canonical_email	string	If an alias is detected, this field shows the base email address (e.g. [email protected]).
confidence.equivalent_domains	array	List of other domains that route to the same inbox (e.g., ['proton.me', 'pm.me']).
provider	object	The email service provider information (e.g., { "name": "Gmail" }).
meta	object	Metadata including latency and source.
meta.latency_ms	number	Server processing time in milliseconds (excludes network latency).
meta.source	string	Source of the validation (api, dashboard, demo).
requestId	string	Unique request identifier (added automatically by middleware).

Example Response

{
  "email": "[email protected]",
  "validations": {
    "syntax": true,
    "domain_exists": true,
    "mx_records": true,
    "is_disposable": false
  },
  "confidence": {
    "confidence_score": 95,
    "status": "LIKELY",
    "is_role_based": true,
    "alias_status": "MAYBE_NOT_ALIAS",
    "canonical_email": null,
    "equivalent_domains": ["gmail.com", "googlemail.com"]
  },
  "provider": {
    "name": "Google Workspace"
  },
  "meta": {
    "latency_ms": 120,
    "source": "api"
  },
  "requestId": "c92d192b-3132-4740-9b39-5b7e27607902"
}