email validation

Validate an email

Requires Authorization: Bearer <api_key> or X-Api-Key. Resolves to the owning tenant for quotas. Returns a primary `verdict` (`allow` | `block`) for signup gating, plus disposable detection and DNS/MX deliverability (soft-fail on timeout). Prefer `verdict` over composing fields yourself.

post/api/v1/validate/email

Authorizations

ApiKeyAuth

Authorization: Bearer <api_key>required

Alternative header: X-Api-Key

Email Score API key. Paste the full key (including `ve_` prefix). Do not include the `Bearer ` prefix in Authorize UIs that add it automatically.

Parameters

Header

Authorizationstringheaderoptional

Preferred auth: `Bearer <api_key>`. Obtain a key from the Email Score dashboard.

X-Api-Keystringheaderoptional

Alternative to Authorization: pass the API key directly.

X-Email-Score-Sourcestringheaderoptional

Optional audit source. Set to `dashboard` for dashboard try-validate traffic.

Request body

application/json

{
  "email": "<string>"
}

Primary field: `verdict`

Use verdict to allow or block signup in your backend. Supporting fields explain why the decision happened.

allow: Continue signup or onboarding. checks.syntax is pass, checks.disposable is miss, and deliverability.status is deliverable.
block: Stop signup with a neutral message. Triggered by syntax fail, disposable/blocklist hit (checks.disposable), or deliverability that is not deliverable (undeliverable, unknown, or skipped).

Deliverability status

Shown in the usage dashboard Status column. Informational, not a substitute for verdict.

deliverable: DNS/MX signals look healthy enough to accept mail for this domain.
undeliverable: Domain or MX signals indicate mail is unlikely to be accepted.
unknown: Checks timed out or could not be resolved confidently.
skipped: Deliverability was not run (for example invalid syntax or disposable).

Billing note

Successful and attempted validations count toward your Space monthly quota and per-minute rate limit, including dashboard try-validate. Demo checks use Turnstile and IP limits only.

Validate an email

curl -X POST https://api-emailscore.neuralevo.com/api/v1/validate/email \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "email": "<string>" }'

Response

{
  "inputType": "email",
  "input": "<string>",
  "normalized": "<string>",
  "domain": "<string>",
  "registrableDomain": "<string>",
  "verdict": "allow",
  "policyReason": "invalid_syntax",
  "matchedDomain": "<string>",
  "listVersion": "<string>",
  "checks": {
    "syntax": "pass",
    "disposable": "pass"
  },
  "deliverability": {
    "status": "deliverable",
    "reason": "mx_found",
    "hasDns": true,
    "hasMx": true,
    "usedAFallback": true,
    "cached": true
  },
  "mxRecords": [
    {
      "host": "<string>",
      "priority": 0,
      "ips": [
        "<string>"
      ]
    }
  ],
  "provider": {
    "id": "<string>",
    "name": "<string>",
    "category": "free_webmail"
  },
  "flags": {
    "freeProvider": true,
    "businessProvider": true,
    "privacyProvider": true,
    "roleAccount": true
  },
  "usage": {
    "period": "<string>",
    "remainingMonthly": 123,
    "rateLimitPerMinute": 123
  }
}

Validate an email

curl -X POST https://api-emailscore.neuralevo.com/api/v1/validate/email \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "email": "<string>" }'

Response

{
  "inputType": "email",
  "input": "<string>",
  "normalized": "<string>",
  "domain": "<string>",
  "registrableDomain": "<string>",
  "verdict": "allow",
  "policyReason": "invalid_syntax",
  "matchedDomain": "<string>",
  "listVersion": "<string>",
  "checks": {
    "syntax": "pass",
    "disposable": "pass"
  },
  "deliverability": {
    "status": "deliverable",
    "reason": "mx_found",
    "hasDns": true,
    "hasMx": true,
    "usedAFallback": true,
    "cached": true
  },
  "mxRecords": [
    {
      "host": "<string>",
      "priority": 0,
      "ips": [
        "<string>"
      ]
    }
  ],
  "provider": {
    "id": "<string>",
    "name": "<string>",
    "category": "free_webmail"
  },
  "flags": {
    "freeProvider": true,
    "businessProvider": true,
    "privacyProvider": true,
    "roleAccount": true
  },
  "usage": {
    "period": "<string>",
    "remainingMonthly": 123,
    "rateLimitPerMinute": 123
  }
}

Loading API reference...

Parameters

Header

Authorizationstringheaderoptional

Preferred auth: `Bearer <api_key>`. Obtain a key from the Email Score dashboard.

X-Api-Keystringheaderoptional

Alternative to Authorization: pass the API key directly.

X-Email-Score-Sourcestringheaderoptional

Optional audit source. Set to `dashboard` for dashboard try-validate traffic.

Primary field: verdict

Use verdict to allow or block signup in your backend. Supporting fields explain why the decision happened.

allow

Continue signup or onboarding. checks.syntax is pass, checks.disposable is miss, and deliverability.status is deliverable.

block

Stop signup with a neutral message. Triggered by syntax fail, disposable/blocklist hit (checks.disposable), or deliverability that is not deliverable (undeliverable, unknown, or skipped).

Deliverability status

Shown in the usage dashboard Status column. Informational, not a substitute for verdict.

deliverable

DNS/MX signals look healthy enough to accept mail for this domain.

undeliverable

Domain or MX signals indicate mail is unlikely to be accepted.

unknown

Checks timed out or could not be resolved confidently.

skipped

Deliverability was not run (for example invalid syntax or disposable).

{ "inputType": "email", "input": "<string>", "normalized": "<string>", "domain": "<string>", "registrableDomain": "<string>", "verdict": "allow", "policyReason": "invalid_syntax", "matchedDomain": "<string>", "listVersion": "<string>", "checks": { "syntax": "pass", "disposable": "pass" }, "deliverability": { "status": "deliverable", "reason": "mx_found", "hasDns": true, "hasMx": true, "usedAFallback": true, "cached": true }, "mxRecords": [ { "host": "<string>", "priority": 0, "ips": [ "<string>" ] } ], "provider": { "id": "<string>", "name": "<string>", "category": "free_webmail" }, "flags": { "freeProvider": true, "businessProvider": true, "privacyProvider": true, "roleAccount": true }, "usage": { "period": "<string>", "remainingMonthly": 123, "rateLimitPerMinute": 123 } }

Authorizations

Parameters

Request body

Primary field: verdict

Deliverability status

Billing note

Authorizations

Parameters

Request body

Primary field: verdict

Deliverability status

Billing note

Primary field: `verdict`

Primary field: `verdict`