# Email Score Validate API

Public product API for email and domain validation.

Authenticate with `Authorization: Bearer <api_key>` (or `X-Api-Key`).
Create keys in the Email Score dashboard. Quota applies to email, domain, and detect.

## Primary decision: `verdict`
Every validate response includes `verdict`: `allow` or `block`.
Use `verdict` to gate signup in your backend. Supporting fields (`policyReason`, `checks`, `deliverability`) explain why.
`verdict` is `allow` only when `checks.syntax` is `pass`, `checks.disposable` is `miss`, and `deliverability.status` is `deliverable`; otherwise `block`.

## API reference

- [Validate an email](https://emailscore.neuralevo.com/docs/api/md/post-api-v1-validate-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.
- [Validate a domain](https://emailscore.neuralevo.com/docs/api/md/post-api-v1-validate-domain): Requires Authorization: Bearer <api_key> or X-Api-Key. Input must be a bare domain (no @). Returns 422 when an email address is sent. Includes primary `verdict` (`allow` | `block`) for signup gating.
- [Validate email or domain(auto-detect)](https://emailscore.neuralevo.com/docs/api/md/post-api-v1-validate-detect): Requires Authorization: Bearer <api_key> or X-Api-Key. Accepts either user@company.com or company.com. Returns the same shape as email/domain validate, including primary `verdict` (`allow` | `block`).
- [Check usage status](https://emailscore.neuralevo.com/docs/api/md/get-api-v1-validate-account): Requires Authorization: Bearer <api_key> or X-Api-Key. Returns key prefix and remaining monthly quota without consuming a validation unit.