Loading
Loading
Validate up to 100 email addresses in a single request. Each address is independently checked for syntax, MX records, domain validity, disposable addresses, catch-all domains, role-based accounts, spam traps, and deliverability.
Send an array of email objects in the request body. Each object can include an email address, optional name, and optional IP for enrichment. Invalid entries do not affect the rest of the batch.
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 optional query parameter controls the response format.
formatoptionalStringdefault: jsonResponse format. Possible values are:
The request body must be in JSON format and include an emailData array of email objects to validate:
{
"emailData": [
{
"email": "abc.def@gmail.com",
"name": "Test User",
"ip": "1.1.1.1"
},
{
"email": "test@example.com",
"name": "Example User"
}
]
}emailDatarequiredArray<Object>Array of email objects to validate. Maximum 100 objects per request.
Each object in the emailData array supports the following fields:
{
"email": "abc@example.com",
"name": "ABC Person",
"ip": "1.1.1.1"
}emailrequiredStringThe email address to validate.
nameoptionalStringOptional identifier or label for record tracking purposes.
ipoptionalStringOptional IP address for geolocation and security enrichment.
A successful request returns a 200 OK response with a JSON object containing an array of per-email validation results.
emailValidationResponsesemailValidationResponses array follows the same schema as the single email validation response.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.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Please provide data in required format in request body
Timed out while connecting to the remote URL.
API rate limit exceeded.