- Docs
- API reference
- Check Disposable Email
Check Disposable Email
GEThttps://api.envoapi.com/v1/emails/disposable
Check whether an email domain appears in the disposable-domain list. Free (0 Credits), with API-key authentication and account rate limits. This does not verify mailbox existence or deliverability. Unavailable evidence returns HTTP 503.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”One email address. Only its normalized domain is checked; this does not verify mailbox existence or deliverability.
Example
person@example.comResponses
Section titled “Responses”Exact domain membership in the current disposable-domain snapshot. Free, including when the domain is not listed.
object
object
object
Headers
Section titled “Headers”Required response header.
Required response header.
Required response header.
Required response header.
Required response header.
Required response header.
Errors
Section titled “Errors”Every error returns the same body. The status and error.code tell you what went wrong. The Errors guide covers handling and retries.
object
object
object
object
Headers
Section titled “Headers”Required response header.
Required response header.
Required response header.
| Status | error.code | Meaning |
|---|---|---|
| 400 | invalid_request | A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again. |
| 401 | invalid_api_key | Your API key is missing, wrong or switched off. Check it in your dashboard. |
| 403 | insufficient_scope, account_suspended | Your account is suspended or cannot use this endpoint. Resolve the account or its access first. |
| 405 | method_not_allowed | The route exists, but the request used a method other than GET. Use the method shown at the top of this page. Also sends Allow. |
| 406 | not_acceptable | The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value. |
| 415 | unsupported_media_type | The request declared a media type we do not accept. Remove the body or use the documented media type. |
| 429 | rate_limit_exceeded | Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. Also sends X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After. |
| 500 | internal_error, response_too_large | Something failed on our side. Retry only when error.retryable is true. |
| 503 | service_unavailable | Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present. Also sends Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. |