All Products
Search

This Product

    Direct Mail:ValidateEmail

    Document Center

    Direct Mail:ValidateEmail

    Last Updated:Nov 20, 2025

    Validates an email address.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request syntax

    POST  HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Email

    string

    Yes

    The email address to validate.

    xxx@yyy.com
    Timeout

    integer

    No

    The timeout period. The default value is 60 seconds.

    20
    CheckGraylist

    boolean

    No

    Specifies whether to check the graylist. The default value is false. The result is returned through an asynchronous notification message from EventBridge.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    Response schema

    RequestId

    string

    The request ID.

    xxxx-xxxx-xxxx-xxxx
    Status

    string

    The status of the validated email address.

    Valid values:

    • VALID :

      The address is valid.

    • CATCHALL :

      The address is a catch-all address. This indicates that the domain accepts emails sent to any non-existent mailbox in the domain.

    • UNKNOWN :

      The address status is unknown.

    • INVALID :

      The address is invalid.

    • DONOTMAIL :

      The address is abnormal and can be excluded from marketing scenarios.

    VALID
    SubStatus

    string

    The sub-status of the validated email address. This parameter provides a detailed description of the status.

    Valid values:

    • NO_DNS_ENTRIES :

      The address is invalid. No DNS records are found.

    • MISSPELLED :

      The address is invalid because of a spelling error.

    • MAILBOX_NOT_EXISTS :

      The address is invalid. The mailbox does not exist.

    • SYSTEM_ERROR :

      The status is unknown because of a system error.

    • SYNTAX_INVALID :

      The address is invalid because of a syntax error.

    • ROLE_ACCOUNT :

      The address is abnormal. It is a role-based account.

    • SMTP_CONNECT_FAILED :

      The status is unknown. The connection to the recipient's SMTP server failed.

    • DISABLED :

      The address is invalid. The mailbox is disabled.

    • UNSPECIFIED :

      No specific sub-status. This may be returned for the VALID, CATCHALL, or UNKNOWN status.

    • IP_UNROUTABLE :

      The address is invalid. The mail server IP address is unreachable.

    • MAILBOX_FULL :

      The address is invalid. The mailbox is full.

    • DISPOSABLE :

      The address is abnormal. It is a disposable email address.

    • TIMEOUT_EXCEEDED :

      The status is unknown. The specified timeout period was exceeded.

    UNSPECIFIED
    Provider

    string

    The category of the email service provider for the address.

    Valid values:

    • Others :

      Others

    • Yahoo :

      Yahoo

    • Gmx :

      Gmx

    • MailDotCom :

      MailDotCom

    • Tencent :

      Tencent

    • Gmail :

      Gmail

    • Outlook :

      Outlook

    • Zoho :

      Zoho

    • Proton :

      Proton

    • Netease :

      Netease

    • Icloud :

      Icloud

    • Webde :

      Webde

    Gmail
    IsFreeMail

    boolean

    Indicates whether the address is from a free email service.

    Valid values:

    • true :

      The address is from a free email service.

    • false :

      The address is not from a free email service.

    true
    LocalPart

    string

    The local part of the email address that is obtained from syntax parsing. The local part is converted to lowercase, and the part after the plus sign (+) is removed.

    xxx
    DomainPart

    string

    The domain part of the email address that is obtained from syntax parsing. The domain part is converted to lowercase.

    yyy.com

    Examples

    Success response

    JSON format

    {
  "RequestId": "xxxx-xxxx-xxxx-xxxx",
  "Status": "VALID",
  "SubStatus": "UNSPECIFIED",
  "Provider": "Gmail",
  "IsFreeMail": true,
  "LocalPart": "xxx",
  "DomainPart": "yyy.com"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.