Get batch job status

GET

/v1/batch-verify/{id}/status

Poll endpoint for batch job progress. Returns the job's verdict counters (numImported, emailsProcessed, numPassed, numFailed, …) plus a status string. Counters are absent until processing begins; there is no single percent-complete field — derive progress from emailsProcessed / numImported.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Job status

Bodyapplication/json

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/batch-verify//status' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "job_a1b2c3d4e5f6g7h8",
    "processed": false,
    "numImported": 1000,
    "emailsProcessed": 650,
    "numPassed": 540,
    "numFailed": 110,
    "numUndeliverable": 80,
    "numUnknown": 10,
    "numRisky": 20,
    "status": "processing"
}

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

Submit a batch of emails for async verification

Get batch job results (paginated)