Verify an email address
Checks whether an email address can receive mail, without writing to it. status is the verdict: valid; invalid, which also covers addresses never to be written to (spam traps, abuse and do-not-mail addresses); risky, when the domain accepts mail for every address, so this one cannot be confirmed; or unknown, when no verdict could be had.
A check takes a few seconds and ends within about 25 seconds. One that gets no verdict in time answers an empty 500 and costs nothing: try again. Verifications have their own limit, 60 a minute and 5,000 a day.
Price: $0.01 a verdict; unknown is free. The price is held from your balance before the check runs, and released when it gives no verdict or is refused. Scope: enrichment, with a key that can write.
Authorizations
Headers
Names this operation, so a retry with the same key and body gets the first success again, marked Idempotent-Replayed, instead of running or charging twice. A mailbox's password is not compared: the same mailbox sent again with another password is the same call, and gets the first answer. Kept 24 hours for your organization and this route. A refusal (4xx) frees the key at once, so a corrected retry runs. After a server error (5xx), which may still take effect, the key stays held for 5 minutes from the call's start, and a retry in that time answers 409 idempotency_in_progress; after that, a send or import that may already have gone out answers 409 idempotency_outcome_unknown instead of running again. 1 to 255 visible ASCII characters, such as a UUID.
1 - 255^[\x21-\x7E]+$Body
Response
The address and its verdict.
valid: it can receive mail. invalid: it cannot, or it must never be written to (a spam trap, an abuse or do-not-mail address). risky: its domain accepts mail for every address, so this one cannot be confirmed. unknown: no verdict could be had; it costs nothing.
valid, invalid, risky, unknown