Skip to main content
POST
Batch Verify
Submit a batch of email addresses for verification. For large batches, results are processed asynchronously - use the verification ID to poll for results.

Request Body

string[]
required
Array of email addresses to verify. Maximum 1000 emails per batch.

Examples

Response

string
Unique ID for polling batch status.
integer
Total number of emails in the batch.
integer
Number of credits deducted (cached emails are free).
string
Current batch status:
  • pending - Batch submitted, not yet started
  • processing - Verification in progress
  • completed - All emails verified
  • failed - Batch verification failed
array
Only populated when all emails were cached. Contains array of verification results.
Example Response
The response is wrapped in an envelope with success, data, and meta fields. SDKs automatically extract the data object.

Limits

Credits

  • New emails: 1 credit per email
  • Cached emails: 0 credits (cached 24 hours)
  • Credits are deducted upfront when batch is submitted

Errors