Use this endpoint when you already have multiple email addresses to check. Send an emails array and expect a results array with one result object per email. Requests are limited to 100 emails; requests with more than 100 emails are rejected in full and no subset is processed.
Endpoint
|
Method |
POST |
|
Url |
https://spamova.com/api/v1/bulk |
Request
Body fields
emails
req
|
Non-empty JSON array of non-empty email strings. Maximum 100 items per request. |
{
"emails": [
"james847@mailinator.com",
"sarah115@tempmail.com",
"steve.wozniak@gmail.com"
]
}
Response
Fields
results
|
Array of check result objects. Each item uses the same fields as /check. |
meta
|
Quota summary for this request. |
Result object
email
|
Normalized email address that was checked. |
syntax
|
valid, invalid, or suspected_typo. |
is_disposable
|
true, false, or null. |
risk_score
|
Advanced only. Integer 0 to 100, or null. |
mx
|
Advanced only. valid, invalid, unknown, or null. |
website_status
|
Advanced only. active, redirect, restricted, not_found, unknown, or null. |
meta
checks_used
|
Number of checks consumed by this request. |
checks_remaining
|
Checks remaining immediately after this request. |
{
"results": [
{
"email": "james847@mailinator.com",
"syntax": "valid",
"is_disposable": true,
"risk_score": 98,
"mx": "valid",
"website_status": "redirect"
},
{
"email": "sarah115@tempmail.com",
"syntax": "valid",
"is_disposable": true,
"risk_score": 96,
"mx": "valid",
"website_status": "redirect"
},
{
"email": "steve.wozniak@gmail.com",
"syntax": "valid",
"is_disposable": false,
"risk_score": 0,
"mx": "valid",
"website_status": "active"
}
],
"meta": {
"checks_used": 3,
"checks_remaining": 4997
}
}