POST/verify

Verify one email

Runs a real-time verification for one address and returns the normalized Reacher result inside the standard MailVerifio response envelope.

Request

Authenticate with a bearer token and send the following request.

cURL

curl --request POST \
  --url https://api.mailverifio.com/v1/verify \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"email":"person@example.com"}'

Body parameters

Name	Type	Required	Description
`email`	`string`	Yes	Complete email address to verify.

JSON body

{
  "email": "person@example.com"
}

Example response

json

{
  "success": true,
  "data": {
    "input": "person@example.com",
    "is_reachable": "safe",
    "misc": {
      "is_disposable": false,
      "is_role_account": false
    },
    "mx": {
      "accepts_mail": true,
      "records": ["10 mx.example.com"]
    },
    "smtp": {
      "can_connect_smtp": true,
      "is_catch_all": false,
      "is_deliverable": true
    },
    "syntax": {
      "address": "person@example.com",
      "domain": "example.com",
      "is_valid_syntax": true,
      "username": "person"
    }
  },
  "meta": {
    "requestId": "req_example",
    "duration": 2180,
    "version": "v1"
  }
}

Operational notes

Reachability is one of safe, risky, invalid, or unknown.
SMTP checks can take several seconds depending on the receiving server.
A successful HTTP response describes the check; inspect data.is_reachable for the email classification.