You can call this operation to query whether an email address is verified.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes QueryEmailVerification

The operation that you want to perform. Set the value to QueryEmailVerification.

Lang String No en

The language of the error message to return. Valid values:

  • zh: Chinese
  • en: English

Default value: en

Email String No abc@aliyun.com

The email address that you want to query.

UserClientIp String No 127.0.0.1

The IP address of the client used by the user to initiate the query.

Response parameters

Parameter Type Example Description
RequestId String FC4F7D02-8A83-4E37-B935-2D48A1B8423E

The ID of the request. Request IDs are unique.

GmtCreate String 2019-02-19 16:38:07

The time when the email address was created.

GmtModified String 2019-02-19 16:40:38

The time when the email address was updated.

Email String abc@aliyun.com

The email address that was queried.

UserId String 140692647406****

The ID of the user.

EmailVerificationNo String 72b36ba0572e423bbb3f19640896****

The ID of the email verification task.

TokenSendTime String 2019-02-19 16:38:07

The time when the verification URL was sent to the email address.

VerificationStatus Integer 1

The status of the email verification task. Valid values:

  • 0: The email address is to be verified.
  • 1: The email address is verified.
VerificationTime String 2019-02-19 16:40:38

The time when the email address was verified.

SendIp String 42.*. *.115

The IP address from which the verification email was sent.

ConfirmIp String 42.*. *.31

The IP address of the client used to confirm the email verification information.

Examples

Sample requests

http(s)://[Endpoint]/? Action=QueryEmailVerification
&<Common request parameters>

Sample success responses

XML format

<QueryEmailVerificationResponse>
  <ConfirmIp>42. *. *.31</ConfirmIp>
  <TokenSendTime>2019-02-19 16:38:07</TokenSendTime>
  <Email>abc@aliyun.com</Email>
  <RequestId>FC4F7D02-8A83-4E37-B935-2D48A1B8423E</RequestId>
  <VerificationStatus>1</VerificationStatus>
  <SendIp>42. *. *.115</SendIp>
  <VerificationTime>2019-02-19 16:40:38</VerificationTime>
  <EmailVerificationNo>72b36ba0572e423bbb3f19640896****</EmailVerificationNo>
  <UserId>140692647406****</UserId>
  <GmtCreate>2019-02-19 16:38:07</GmtCreate>
  <GmtModified>2019-02-19 16:40:38</GmtModified>
</QueryEmailVerificationResponse>

JSON format

{
    "ConfirmIp": "42. *. *.31",
    "TokenSendTime": "2019-02-19 16:38:07",
    "Email": "abc@aliyun.com",
    "RequestId": "FC4F7D02-8A83-4E37-B935-2D48A1B8423E",
    "VerificationStatus": 1,
    "SendIp": "42. *. *.115",
    "VerificationTime": "2019-02-19 16:40:38",
    "EmailVerificationNo": "72b36ba0572e423bbb3f19640896****",
    "UserId": "140692647406****",
    "GmtCreate": "2019-02-19 16:38:07",
    "GmtModified": "2019-02-19 16:40:38"
}

Error codes

For a list of error codes, visit the API Error Center.