Skip to main content

POST /listcleaning/email/verify

POST 
listcleaning/email/verify

Verify email addresses in real time at the moment of entry, for example in sign-up forms. This full verification method validates syntax and domain, checks SMTP server deliverability, and returns the best result available within 10 seconds (maximum 30). It prioritizes speed and may return about 5% more unknown results than list validation

Request Body​

email string Required
Email address to verify

Returns

  • dataobject
    • emailstring
      Email address that was verified
    • statusstring
      Verification status of the email (deliverable, risky, undeliverable, or unknown)
    • reasonstring
      Reason for the assigned status
    • domainobject
      Information about the email's domain
      • namestring
        Domain name of the email address
      • accept_allstring
        Indicates if the domain accepts all emails (yes, no, or unknown)
      • disposablestring
        Indicates if the domain is a disposable email service (yes, no, or unknown)
      • freestring
        Indicates if the domain is a free email provider (yes, no, or unknown)
    • accountobject
      Information about the email account
      • rolestring
        Indicates if the email is a role-based address (yes, no, or unknown)
      • disabledstring
        Indicates if the email account is disabled (yes, no, or unknown)
      • full_mailboxstring
        Indicates if the mailbox is full (yes, no, or unknown)
    • dnsobject
      DNS information for the email's domain
      • typestring
        Type of DNS record (e.g., MX, A)
      • recordstring
        DNS record value
    • providerstring
      Email service provider name
    • scorenumber
      Overall quality score of the email address
    • toxicstring
      Indicates if the email is toxic (yes, no, or unknown)
    • toxicitynumber
      Toxicity level from 0 (lowest) to 5 (highest)
Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error