Polling endpoint for retrieving the status or result of a validation request submitted via POST /v1/email/validate (sync) or POST /v1/email/validate-async (async). Call this endpoint with the requestId returned by either submission endpoint to retrieve the latest state.
The HTTP status code is the canonical discriminator:
-
200 — validation has completed; body contains the result in
the same shape as the sync 200 response. -
202 — validation is still in progress; body contains a
pollUrlandretryAfter. Poll again after the suggested wait. -
404 — the
requestIddoes not exist (or belongs to another
tenant). -
500 — validation failed irrecoverably.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Use this endpoint to retrieve the status or result of a validation request submitted via Validate Email (Synchronous) or Validate Email (Asynchronous).
Call this endpoint with the requestId returned by either submission endpoint. The HTTP status code is the canonical discriminator across all responses:
- 200 — validation has completed. The body contains the result in the same shape as the sync 200 response.
- 202 — validation is still in progress. The body contains a
pollUrland aretryAfter(seconds). Poll again after the suggested wait. - 404 — the
requestIddoes not exist. - 500 — validation failed irrecoverably.
Branch on the HTTP status code rather than reading a body field for state — the same approach used by the sync endpoint.
Response fields (200)
The 200 response carries the same shape as the sync endpoint, including validatedAt plus the domain and mailbox objects. See Validation Statuses for the meaning of each field.