Skip to content

Email Validation

Checks the correctness of an email address. Validates the format and checks the domain's MX records.

URL

Method: GET

  • Production: https://registry.wallet.kvell.group/reg2/validation/email

Request parameters

Name Data type Required Description
email string Yes Email address to check
smtp boolean No Whether to check the domain's MX records

Request example

GET https://registry.wallet.kvell.group/reg2/validation/email?email=mail@gmail.com&smtp=true

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique identifier (UUID)

Response

Response example

{
  "success": true,
  "data": {
    "valid": true,
    "email": "test@example.com",
    "format": {
      "valid": true,
      "local": "test",
      "domain": "example.com"
    },
    "mx": {
      "checked": true,
      "valid": true,
      "records": [
        "mx1.example.com",
        "mx2.example.com"
      ]
    },
    "disposable": false,
    "role": false
  }
}

Response parameters

Name Data type Description
email string Normalized email address
valid boolean Correct format (RFC 5322)
exists boolean Whether the mailbox exists (SMTP)
disposable boolean Disposable (temporary) email service
freeProvider boolean Free provider (gmail, mail.ru, etc.)
mxValid boolean Whether the domain has valid MX records
riskScore number Risk score from 0.0 to 1.0
recommendation string Antifraud system recommendation: ALLOW / REVIEW / DECLINE