Submit a batch of emails for async verification

POST

/v1/batch-verify

Queues a verification job for the supplied email list. Returns immediately with a job ID; results retrievable via /v1/batch-verify/{id}/results once the job completes.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Job accepted

Bodyapplication/json

🟠400

🟠401

🟠402

🟠403

🟠409

🟠422

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/batch-verify' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "emails": [
        "string"
    ],
    "webhook_url": "string"
}'

Response Example

200 - Success

{
    "id": "job_a1b2c3d4e5f6g7h8"
}

Modified at 2026-10-20 13:54:45

Verify a single email address

Get batch job status