This endpoint allows you to perform a real-time email validation and receive the result immediately.
Note: This endpoint has a 30-second timeout.
A 202 response indicates the validation is still in progress. Clients should poll pollUrl after retryAfter seconds. On 202 responses, the result object is absent; it will be present on the subsequent 200 response from the poll URL.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
This endpoint allows you to perform a real-time email validation and receive the result immediately.
Note: This endpoint has a 30-second timeout.
If validation takes longer, the endpoint returns an HTTP 202 response with a pollUrl and a retryAfter (seconds). Poll the pollUrl after the suggested wait to retrieve the validation result. The HTTP status code (200 vs 202) is the canonical discriminator between a completed result and a still-in-progress one.
See Validate Email Status (Polling) for the full polling endpoint contract.
Response fields
Every successful (200) response includes:
result.status/result.subStatus— the headline validation outcome.validatedAt— ISO 8601 timestamp of when this validation response was produced.domain— domain-level signals:name,mxProvider,mxRecords,isCatchAll.mailbox— mailbox-level signals:isRoleAccount.
See Validation Statuses for the meaning of each field.