Check an email address
POST/v1/check
Returns the canonical inbox and whether the address is disposable or deliverable.
Request
Responses
- 200
- 400
- 401
- 413
- 422
- 429
- 503
The address was checked. Every authenticated request with a valid body counts toward the monthly quota,
including addresses that turn out to be invalid (400).
Response Headers
Checks included per month in your plan.
Checks left this month.
Unix time (seconds) when the monthly quota resets (1st of the month, 00:00 UTC).
active, past_due (Premium ended, grace period with Premium limits) or expired (back to Free limits).
Plan whose limits apply to this request.
The value is not an email address.
Missing, invalid or revoked API key.
Request body too large.
The body is invalid, or (signup and orders) the email is disposable or undeliverable.
Two different limits, told apart by error.type:
QuotaExceededError: the monthly quota is used up.Retry-Afteris the number of seconds until the reset (1st of the month, 00:00 UTC). Don't retry before then; upgrade instead.RateLimitError: too many requests per second (or, on public endpoints, per hour from one IP).Retry-Aftersays how many seconds to wait.
Response Headers
Seconds to wait before retrying.
Checks included per month in your plan.
Checks left this month.
Unix time (seconds) when the monthly quota resets (1st of the month, 00:00 UTC).
The check is temporarily unavailable or took too long. Not counted toward your quota. Continue the signup and recheck later (see "Never block a signup" in the docs).