Get batch job results (paginated)

GET

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

Returns the verification results for a completed job, paginated via the per_page + next query parameters. Row verdicts are post-org-override: statuses the org's floss settings are configured to ignore are rewritten to passed/valid before storage, so they may differ from GET /v1/verify for the same address — see the v1 contract ("Live vs batch verdicts").

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200

application/json

Paginated results

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/batch-verify//results?per_page=&next=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "data": [
        {
            "email": "jane@example.com",
            "domain": "example.com",
            "processed": true,
            "passed": true,
            "reason": "valid",
            "status": "passed",
            "completed_at": "2026-06-19T10:18:22.000Z",
            "index": 0
        },
        {
            "email": "noreply@example.com",
            "domain": "example.com",
            "processed": true,
            "passed": false,
            "reason": "nonexistent",
            "status": "undeliverable",
            "completed_at": "2026-06-19T10:18:23.000Z",
            "index": 1,
            "suggestion": ""
        }
    ],
    "next": "U2FsdGVkX1-8k3n0pQ7rWtZ2xY"
}

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

Get batch job status

Cancel a batch verification job