Verification

Validate email addresses (syntax, MX records, disposable domain detection).

Verify email addresses before sending to reduce bounces and protect your sender reputation. Checks include syntax validation, MX record lookup, disposable domain detection, and role-based address detection. Supports single and batch verification.

Endpoints

Method	Path	Description	Permission
POST		Verify an email address	verify.use
POST		Batch verify emails	verify.use

Verify Email

POST /api/v1/verify • POST /api/v1/verify/batch

Single verification

Response (single)

{
  "success": true,
  "data": {
    "email": "user@example.com",
    "result": "valid",
    "checks": {
      "syntax": true,
      "mxRecords": true,
      "disposable": false,
      "roleBased": false,
      "freeProvider": false
    }
  }
}

json

Batch verification

Response (batch)

{
  "success": true,
  "data": [
    { "email": "valid@example.com", "result": "valid", "checks": { "syntax": true, "mxRecords": true, "disposable": false } },
    { "email": "invalid@fakeddomain.xyz", "result": "invalid", "checks": { "syntax": true, "mxRecords": false, "disposable": false } },
    { "email": "throwaway@tempmail.io", "result": "risky", "checks": { "syntax": true, "mxRecords": true, "disposable": true } }
  ]
}

json