Verify an address
POST/v2/email/validate
Runs the checks enabled on the key and returns the verdict (result), the score (0 to 100) and the details of each check in features.
- Always responds
200when the verification completes, whatever the verdict. - SMTP runs if, and only if, the key has it enabled. Allow a 30 s client timeout in that case.
- A check disabled on the key is absent from
features.syntaxanddnsare always present. - Limit: 100 requests per minute per IP.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 413
- 429
Verification completed.
Response Headers
RateLimit-Limit
Requests allowed in the window.
RateLimit-Remaining
Requests remaining in the window.
RateLimit-Reset
Seconds until the window resets.
Invalid body or unknown field. message is an array.
Missing or invalid authentication: No authorization header, Invalid or revoked API key, Invalid authorization format.
Balance used up while SMTP is enabled on the key. Nothing is debited.
IP or origin not allowed for the key, or widget anti-abuse check.
Body larger than 256 KB, rejected before any processing.
Four cases, all with Retry-After:
- per-IP rate limit: plain-text body;
- key call limit (minute, hour, day): JSON,
code: API_KEY_RATE_LIMITED; - key credit cap: JSON,
code: API_KEY_BUDGET_EXCEEDED; - widget anti-abuse: JSON.
Response Headers
Retry-After
Seconds to wait before retrying.