edit-icon download-icon

QueryTransferInList

Last Updated: Apr 17, 2018

Description

The QueryTransferInList API queries the list of inbound domain name transfers.

Request parameters

Parameter Type Required Sample value Description
PageNum Integer Yes 1

Page number.

PageSize Integer Yes 20

Page size.

DomainName String No test.com

Domain name, prefix match.

Lang String No en

Language of the error message returned by the API, which has the following enumerated values: zh (Chinese) and en (English). The default value is en.

SimpleTransferInStatus String No INIT Transfer status, with the following enumerated values:
  • INIT: Transfer submitted.
  • AUTHORIZATION: Transfer authorization (email verification).
  • NAME_VERIFICATION: Name verification.
  • PASSWORD_VERIFICATION: Transfer authorization code verification.
  • PENDING: Transfer in progress.
  • SUCCESS: Transfer successful.
  • FAIL: Transfer failed.
SubmissionEndDate Long No 1514428524669

Transfer submission start time.

SubmissionStartDate Long No 1514428524669

Transfer submission end time.

UserClientIp String No 127.0.0.1

User IP address.

Response parameters

Parameter Type Sample value Description
RequestId String AF7D4DCE-0776-47F2-A9B2-6FB85A87AA60

The unique request ID.

TotalItemNum Integer 40

Total number of entries.

CurrentPageNum Integer 1

Current page number.

TotalPageNum Integer 2

Total number of pages.

PageSize Integer 20

Page size.

PrePage Boolean false

Whether the previous page exists.

NextPage Boolean true

Whether the next page exists.

Data

Inbound domain name transfer information list.

  └SubmissionDate String 2018-03-28 00:41:42

Transfer request submission time.

  └ModificationDate String 2018-03-28 00:41:42

Transfer information update time.

  └UserId String 123456

User ID.

  └InstanceId String S20181T0WLI85212

Instance ID.

  └DomainName String test.com

Domain name.

  └Status Integer 11 Detailed domain name transfer status, with the following enumerated values:
  • 10: Initial status.
  • 11: Email verification token link sent.
  • 19: Token link verification successful.
  • 20: Submitted for name verification.
  • 21: Name verification failed.
  • 29: Name verification successful.
  • 31: Incorrect transfer authorization code.
  • 39: Transfer submission successful.
  • 50: Transfer cancelled by customer.
  • 51: Transfer failed.
  • 52: Transfer expired.
  • 59: Transfer successful.
  └SimpleTransferInStatus String FAIL Transfer status, with the following enumerated values:
  • INIT: Transfer submitted.
  • AUTHORIZATION: Transfer authorization (email verification).
  • NAME_VERIFICATION: Name verification.
  • PASSWORD_VERIFICATION: Transfer authorization code verification.
  • PENDING: Transfer in progress.
  • SUCCESS: Transfer successful.
  • FAIL: Transfer failed.
  └ResultCode String clientCancelled

The failure code returned when a transfer fails, with the following enumerated values:

  • clientCancelled: You cancelled this transfer.
  • clientRejected: The original domain name registrar rejected the transfer (or you rejected the operation at the original registrar).
  • serverCancelled: The registry cancelled the transfer.
  • transferProhibited: The domain name status does not permit a transfer.
  • transferExpired: You did not complete the transfer within the effective period.
  • nameVerificationFailed: The domain name did not pass name verification.
  • transferSubmitted: Another user has already submitted a domain name transfer.
  └ResultDate String 2018-03-28 00:41:42

Time of transfer success or failure.

  └ResultMsg String You have cancelled this domain name transfer

The transfer description returned when a transfer fails.

  └TransferAuthorizationCodeSubmissionDate String 2018-03-28 00:41:42

Transfer authorization code submission time.

  └NeedMailCheck Boolean true

Whether email verification is required.

  └Email String test@test.com

The address to which the domain name transfer confirmation email is sent.

  └WhoisMailStatus Boolean true

Whether the domain name registrant’s email is crawled by WHOIS. When this field is false for an authorized domain name transfer (email verification), it indicates that the registrant’s email is not crawled by WHOIS and must be manually entered.

  └ExpirationDate String 2018-03-28 00:41:42

Domain name transfer expiration time.

  └ProgressBarType Integer 0

The transfer progress bar type, with the following enumerated values:

  • 0: Requires both email verification and name verification.
  • 1: Requires email verification, but not name verification.
  • 2. Requires name verification, but not email verification.
  • 3: Does not require email verification or name verification.
  └SubmissionDateLong Long 1514428524669

Transfer request submission timestamp.

  └ModificationDateLong Long 1514428524669

Transfer information update timestamp.

  └ResultDateLong Long 1514428524669

Timestamp of transfer success or failure.

  └ExpirationDateLong Long 1514428524669

Domain name transfer expiration timestamp.

  └TransferAuthorizationCodeSubmissionDateLong Long 1514428524669

Transfer authorization code submission timestamp.

Examples

Request example

  1. /?Action=QueryTransferInList
  2. &PageNum=1
  3. &PageSize=20
  4. &DomainName=test.com
  5. &SimpleTransferInStatus=INIT
  6. &SubmissionEndDate=1514428524669
  7. &SubmissionStartDate=1514428524669
  8. &<Public request parameter>

Normal response example

  • XML format
  1. <QueryTransferInListResponse>
  2. <Data>
  3. <TransferInInfo>
  4. <Status>31</Status>
  5. <Email>te****st@alibaba-inc.com</Email>
  6. <ResultMsg>TransferInFailureReason.null</ResultMsg>
  7. <SimpleTransferInStatus>PASSWORD_VERIFICATION</SimpleTransferInStatus>
  8. <InstanceId>S20182G180111111</InstanceId>
  9. <ModificationDate>2018-03-29 16:31:02</ModificationDate>
  10. <DomainName>test.com</DomainName>
  11. <WhoisMailStatus>true</WhoisMailStatus>
  12. <UserId>123456</UserId>
  13. <ProgressBarType>0</ProgressBarType>
  14. <ExpirationDate>2018-04-13 15:51:01</ExpirationDate>
  15. <NeedMailCheck>true</NeedMailCheck>
  16. <SubmissionDate>2018-03-29 15:51:01</SubmissionDate>
  17. </TransferInInfo>
  18. <TransferInInfo>
  19. <InstanceId>S20182G151111111</InstanceId>
  20. <WhoisMailStatus>true</WhoisMailStatus>
  21. <UserId>123456</UserId>
  22. <ResultDate>2018-03-29 15:47:37</ResultDate>
  23. <ExpirationDate>2018-04-13 14:57:11</ExpirationDate>
  24. <NeedMailCheck>true</NeedMailCheck>
  25. <Status>50</Status>
  26. <Email>b****i4@test.com</Email>
  27. <SimpleTransferInStatus>FAIL</SimpleTransferInStatus>
  28. <ResultMsg>You have canceled this domain name transfer in.</ResultMsg>
  29. <ModificationDate>2018-03-29 15:47:37</ModificationDate>
  30. <ResultCode>clientCancelled</ResultCode>
  31. <DomainName>btest.com</DomainName>
  32. <ProgressBarType>0</ProgressBarType>
  33. <SubmissionDate>2018-03-29 14:57:11</SubmissionDate>
  34. </TransferInInfo>
  35. </Data>
  36. <TotalItemNum>87</TotalItemNum>
  37. <PageSize>2</PageSize>
  38. <CurrentPageNum>1</CurrentPageNum>
  39. <RequestId>041FEBFE-966C-452E-A21D-38FBE520B93D</RequestId>
  40. <PrePage>false</PrePage>
  41. <TotalPageNum>44</TotalPageNum>
  42. <NextPage>true</NextPage>
  43. </QueryTransferInListResponse>
  • JSON format
  1. {
  2. "CurrentPageNum":1,
  3. "Data":{
  4. "TransferInInfo":[
  5. {
  6. "DomainName":"test.com",
  7. "Email":"te****st@alibaba-inc.com",
  8. "ExpirationDate":"2018-04-13 15:51:01",
  9. "InstanceId":"S20182G180111111",
  10. "ModificationDate":"2018-03-29 15:59:02",
  11. "NeedMailCheck":true,
  12. "ProgressBarType":0,
  13. "ResultMsg":"TransferInFailureReason.null",
  14. "SimpleTransferInStatus":"PASSWORD_VERIFICATION",
  15. "Status":31,
  16. "SubmissionDate":"2018-03-29 15:51:01",
  17. "UserId":"123456",
  18. "WhoisMailStatus":true
  19. },
  20. {
  21. "DomainName":"btest.com",
  22. "Email":"b****i4@test.com",
  23. "ExpirationDate":"2018-04-13 14:57:11",
  24. "InstanceId":"S20182G15000000",
  25. "ModificationDate":"2018-03-29 15:47:37",
  26. "NeedMailCheck":true,
  27. "ProgressBarType":0,
  28. "ResultCode":"clientCancelled",
  29. "ResultDate":"2018-03-29 15:47:37",
  30. "ResultMsg":"You have canceled this domain name transfer in.",
  31. "SimpleTransferInStatus":"FAIL",
  32. "Status":50,
  33. "SubmissionDate":"2018-03-29 14:57:11",
  34. "UserId":"123456",
  35. "WhoisMailStatus":true
  36. }
  37. ]
  38. },
  39. "NextPage":true,
  40. "PageSize":2,
  41. "PrePage":false,
  42. "RequestId":"CC71762B-0A20-4D3A-AD74-C225DB8DBEAE",
  43. "TotalItemNum":87,
  44. "TotalPageNum":44
  45. }

Abnormal response example

  • XML format
  1. <Error>
  2. <RequestId>773FF621-FAF1-40C4-93F6-800AD2AEEF75</RequestId>
  3. <HostId>domain.aliyuncs.com</HostId>
  4. <Code>MissingPageNum</Code>
  5. <Message>PageNum is mandatory for this action.</Message>
  6. <Recommend><![CDATA[https://error-center.aliyun.com/status/search?Keyword=MissingPageNum&source=PopGw]]></Recommend>
  7. </Error>
  • JSON format
  1. {
  2. "Code":"MissingPageNum",
  3. "HostId":"domain.aliyuncs.com",
  4. "Message":"PageNum is mandatory for this action.",
  5. "Recommend":"https://error-center.aliyun.com/status/search?Keyword=MissingPageNum&source=PopGw",
  6. "RequestId":"1489D619-4051-4CA0-92DD-B57A89E125D2"
  7. }

Error code

See error codes of this product.

Thank you! We've received your feedback.