Loading
Loading
Check whether an email address comes from a throwaway provider, whether its domain resolves and has mail servers, and whether it is a free-provider, spam-listed, or role-based address.
Pass the address in the email query parameter. To check up to 100 addresses in one request, use the bulk endpoint.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis is version v1.0 of the API.
The following query parameters are supported by this endpoint.
emailrequiredStringThe email address to check. A malformed address still returns a normal response, with validSyntax and domain.validDomain set to false.
formatoptionalStringdefault: jsonjson (default) or xml.A successful request returns a 200 OK response with a JSON object. A malformed address still returns 200 OK, with validSyntax set to false.
emailThe email address that was checked.
validSyntaxWhether the address is well-formed. When false, only domain.name and domain.validDomain (false) are returned alongside it.
domainFlags describing the address domain.
accountMailbox-level signals. Not returned when validSyntax is false.
dnsDNS data for the domain. Not returned when validSyntax is false.
name (String), disposable (Boolean), free (Boolean), spam (Boolean), validDomain (Boolean)
role (Boolean)
mxRecord (Array<String>), aRecord (Array<String>)
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.