Verify a single email address

GET

/v1/verify

Performs email verification on a single email address and returns a deliverability verdict. Consumes one credit from the org account on success. Returns the raw engine verdict: batch results for the same address may differ, because batch verdicts have the org's floss-settings overrides applied — 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 ********************

Query Params

Responses

🟢200

application/json

Verification verdict

Bodyapplication/json

🟠400

🟠401

🟠402

🟠403

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/verify?email=&timeout=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "email": "jane@example.com",
    "domain": "example.com",
    "status": "passed",
    "reason": "valid",
    "passed": true,
    "role": false,
    "disposable": false,
    "free": false,
    "relay": false,
    "gibberish": false,
    "suggestion": "",
    "meta": ""
}

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

Submit a batch of emails for async verification