verifications

Verify batch of emails (max 3000 emails)

post/verify/email/batch

Request

  • Base URL: https://api.listclean.xyz/v1
  • URL: https://api.listclean.xyz/v1/verify/email/batch
  • Auth: API key in header X-Auth-Token

Request body

filenamestring

Optional source filename. If omitted, the API generates a UTC filename in the format batch_upload-DD-MM-YYYY-HHMMSS-utc.csv (for example, batch_upload-05-10-2026-143025-utc.csv). A .csv extension is added when a supplied filename has no extension.

emailsstring[] required

Email addresses to verify. The default limit is 3,000 addresses per request.

Example request

{
  "emails": [
    "user1@example.com",
    "user2@example.com"
  ]
}

Response

Response on success

success0 | 1

Success status, 0 for failed 1 for success

messagestring
error_codeinteger

Example response

{
  "success": 1,
  "data": {
    "list_id": 370124
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.