Email validation API documentation.

Quickstart

Validate one email address

Use POST /api/validate with an access key from your account. The API accepts one address per request and returns JSON.

curl https://validated.now/api/validate \
  -H "Authorization: Bearer <access_key>" \
  -H "Content-Type: application/json" \
  -d '{"email":"person@company.com"}'

Authentication

Use an access key

Create an access key from the dashboard, then send it as a Bearer token. Copy new keys when they are created; they are not shown again.

Authorization: Bearer <access_key>

Request

Endpoint and body

{
  "email": "person@company.com"
}

Response

Result fields

Route by status first. Use score, confidence, risk, and next_step when you need more control.

{
  "status": "accept",
  "score": 92,
  "confidence": "high",
  "risk": "low",
  "next_step": "Ready to use.",
  "normalized_email": "person@company.com",
  "suggestion": "",
  "flags": {
    "role": false,
    "role_type": "",
    "disposable": false,
    "free_provider": false,
    "catch_all": false
  },
  "billable": true
}

Errors

Error format

Failed requests return a JSON object with an error code and message. When a request is temporarily paused, use the Retry-After header before retrying.

{
  "error": {
    "code": "access_required",
    "message": "A valid integration key is required."
  }
}

Limits

Usage and retries

API calls count against your active plan when the result is billable. Send one address per request, keep payloads small, and back off when you receive a 429.