API reference
POST/verify/bulk

Verify a batch

Filters malformed values, deduplicates the input, processes valid addresses in batches of five, and returns every result with a summary.

Request

Authenticate with a bearer token and send the following request.

cURL
curl --request POST \
  --url https://api.mailverifio.com/v1/verify/bulk \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "emails": [
      "ada@example.com",
      "grace@example.org",
      "linus@example.net"
    ]
  }'

Body parameters

NameTypeRequiredDescription
emailsstring[]YesOne to 1,000 email address values.
JSON body
{
  "emails": [
    "ada@example.com",
    "grace@example.org",
    "linus@example.net"
  ]
}

Example response

json
{
  "success": true,
  "data": {
    "total": 3,
    "completed": 3,
    "results": [
      {
        "input": "ada@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_deliverable": true },
        "syntax": { "address": "ada@example.com", "domain": "example.com", "is_valid_syntax": true, "username": "ada" }
      }
    ],
    "summary": {
      "safe": 1,
      "risky": 1,
      "invalid": 1,
      "unknown": 0
    }
  },
  "meta": {
    "requestId": "req_example",
    "duration": 6840,
    "version": "v1"
  }
}

Operational notes

  • The maximum request size is 1,000 input values.
  • Invalid formats are filtered and duplicate valid addresses are checked once.
  • This endpoint is synchronous today; durable asynchronous jobs are planned for large production lists.