Get a verification job

GET

/v1/jobs/{id}

Returns one verification job by id, with the full results breakdown including per-reason counts (reasons: spam / role_based / disposable / nonexistent / …). As with the list, results is null until the job's status is completed. A job id that does not exist or belongs to another org → 404 not_found. (For paginated per-email results use GET /v1/batch-verify/{id}/results; to cancel, POST /v1/batch-verify/{id}/cancel.)

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 detail

Bodyapplication/json

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "id": "job_a1b2c3d4e5f6g7h8",
    "status": "completed",
    "source": "integration",
    "source_integration": "mailchimp",
    "created_at": "2026-06-19T08:00:00Z",
    "finished_at": "2026-06-19T08:05:45Z",
    "results": {
        "total": 1000,
        "processed": 1000,
        "passed": 850,
        "failed": 150,
        "undeliverable": 100,
        "risky": 40,
        "unknown": 10,
        "reasons": {
            "invalid": 12,
            "nonexistent": 60,
            "deactivated": 18,
            "inbox_full": 6,
            "illegitimate": 3,
            "spam": 9,
            "role_based": 14,
            "banned_words": 2,
            "disposable": 8,
            "failed_exchange": 1,
            "accept_all": 26,
            "unverified": 4,
            "complained": 2,
            "bounced": 5,
            "blacklisted": 0,
            "available": 850
        }
    }
}

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

List verification jobs

Account activity timeline