POST
/verify/bulkVerify a batch
Filters malformed values, deduplicates the input, processes valid addresses in batches of five, and returns every result with a summary.
Request
Authenticate with a bearer token and send the following request.
cURL
curl --request POST \
--url https://api.mailverifio.com/v1/verify/bulk \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emails": [
"ada@example.com",
"grace@example.org",
"linus@example.net"
]
}'Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
emails | string[] | Yes | One to 1,000 email address values. |
JSON body
{
"emails": [
"ada@example.com",
"grace@example.org",
"linus@example.net"
]
}Example response
json
{
"success": true,
"data": {
"total": 3,
"completed": 3,
"results": [
{
"input": "ada@example.com",
"is_reachable": "safe",
"misc": { "is_disposable": false, "is_role_account": false },
"mx": { "accepts_mail": true, "records": ["10 mx.example.com"] },
"smtp": { "can_connect_smtp": true, "is_deliverable": true },
"syntax": { "address": "ada@example.com", "domain": "example.com", "is_valid_syntax": true, "username": "ada" }
}
],
"summary": {
"safe": 1,
"risky": 1,
"invalid": 1,
"unknown": 0
}
},
"meta": {
"requestId": "req_example",
"duration": 6840,
"version": "v1"
}
}Operational notes
- The maximum request size is 1,000 input values.
- Invalid formats are filtered and duplicate valid addresses are checked once.
- This endpoint is synchronous today; durable asynchronous jobs are planned for large production lists.