TP_GetOrder

Get a list of domains in a single transfer order.

Usage

Use this command to retrieve status information on each item in a transfer order.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/domains/TransferStatus.asp

On the transfer a name page, clicking a link in the Transfer Order ID column calls the TP_GetOrder command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The transfer order ID must be valid.
  • The transfer order must have originated from this account.

Input Parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue
Input ParameterStatusDescriptionMax Size
UIDRequiredAccount login ID20
PWRequiredAccount password20
TransferOrderIDRequiredTransfer order ID number. You can retrieve this number by calling the TP_GetOrderStatuses command.10
ResponseTypeOptional Format of response.Permitted values are Text (default), HTML, or XML.4

Returned Parameters and Values

Output ParameterDescription
TransferOrderIDTransfer order number
OrderDateDate the order was entered
OrderTypeIDType ID of order
OrderTypeDescType of order
StatusIDStatus ID of order. See Notes.
StatusDescStatus description of order. See Notes.
AuthAmountCharge amount for this order
TransferOrderDetailIDTransfer order detail number
SLDSecond-level domain name (for example, enom in enom.com)
TLDTop-level domain name (extension)
PriceCost of the name transfer
UseContactsUse original contacts or not
CommandName of command executed
ErrCountThe number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrXError messages explaining the failure. These can be presented as is back to the client.
DoneTrue indicates this entire response has reached you successfully.

Notes

  • The default response format is plain text. To receive the response in HTML or XML format, send ResponseType=HTMLor ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0, the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise, process the returned parameters as defined above.
  • TransferOrder StatusID:
    0 Transfer request has been made
    1 Fax has been received
    2 Order canceled
    3 Order complete
    4 Processing
    5 Order not submitted
  • TransferOrderDetail StatusID:
    0 Transfer request created - awaiting fax
    1 WhoIs information matches
    2 Canceled due to WhoIs error
    3 Pending due to domain status
    4 Canceled due to domain status
    5 Transferred and paid successfully
    6 Transfer incomplete - charge problem
    7 Frozen due to charge problem
    8 NSI rejected transfer
    9 Awaiting auto verification of transfer request (no longer used due to GDPR)
    10 Unable to retrieve current domain contacts from UWhois (no longer used due to GDPR)
    11 Auto verification of transfer request initiated (no longer used due to GDPR)
    12 Awaiting for auto transfer string validation
    13 Domain awaiting transfer initiation
    14 Domain transfer initiated and awaiting approval
    15 Canceled - cannot obtain domain contacts from UWhois
    16 Canceled - domain contacts did not respond to verification e-mail
    17 Canceled - domain contacts did not approve transfer of domain
    18 Canceled - domain validation string is invalid
    19 Canceled - Whois information provided does not match current registrant
    20 Canceled - Domain is currently not registered and cannot be transferred
    21 Canceled - Domain is already registered in account and cannot be transferred
    22 Canceled - Domain is locked at current registrar, or is not yet 60 days old
    23 Canceled - Transfer already initiated for this domain
    24 Canceled - Unable to transfer due to unknown error
    25 Canceled - The current registrar has rejected transfer (please contact them for details)
    26 Canceled - Transfer authorization fax not received
    27 Canceled by customer
    28 Fax received - awaiting registrant verification
    29 Awaiting manual fax verification
    30 Canceled - Domain name is invalid or is Invalid for Transfers
    31 Canceled - Domain is currently undergoing transfer by another Registrar
    32 Canceled - Invalid EPP/authorization key - Please contact current registrar to obtain correct key
    33 Canceled - Cannot transfer domain from name-only account
    34 Unable to complete transfer. Transfers must include a change in registrar.
    35 Transfer request not yet submitted
    36 Canceled - Account is not authorized to perform domain transfers
    37 Canceled - Domain was not retagged or not retagged in time by losing registrar
    45 Order cancelled
    100 Pending consent - The transfer order is waiting for GDPR consent to be given.
    * 101 Canceled - Registrant denied - GDPR consent was refused, and so the order was cancelled.

Example

The following query requests transfer information for transfer order ID 445413, and sends the response in XML, HTML, or Text format.

https://resellertest.enom.com/interface.asp?
command=TP_GetOrder&uid=resellid&pw=resellpw
&TransferOrderID=445413&responsetype=XML
https://resellertest.enom.com/interface.asp?
command=TP_GetOrder&uid=resellid&pw=resellpw
&TransferOrderID=445413&responsetype=html
https://resellertest.enom.com/interface.asp?
command=TP_GetOrder&uid=resellid&pw=resellpw
&TransferOrderID=445413&responsetype=text

The response provides information on transfer order ID 445413:

<?xml version="1.0" ?>
<interface-response>
<transferorder>
 <transferorderid>445413</transferorderid>
 <orderdate>7/29/2002 5:19:29 PM</orderdate>
 <ordertypeid>1</ordertypeid>
 <ordertypedesc>Auto Verification</ordertypedesc>
 <statusid>4</statusid>
 <statusdesc>Processing</statusdesc>
 <authamount>17.90</authamount>
 <version>1</version>
 <transferorderdetail>
  <transferorderdetailid>301770</transferorderdetailid>
  <sld>resellerdocs2</sld>
  <tld>net</tld>
  <statusid>9</statusid>
  <statusdesc>Awaiting auto verification of transfer request</statusdesc>
  <price>8.95</price>
  <usecontacts>0</usecontacts>
 </transferorderdetail>
 <transferorderdetail>
  <transferorderdetailid>301771</transferorderdetailid>
  <sld>resellerdocs3</sld>
  <tld>info</tld>
  <statusid>9</statusid>
  <statusdesc>Awaiting auto verification of transfer request</statusdesc>
  <price>8.95</price>
  <usecontacts>0</usecontacts>
 </transferorderdetail>
 <transferorderdetailcount>2</transferorderdetailcount>
</transferorder>
<Command>TP_GETORDER</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
 <![CDATA[ ] ]>
</debug>
</interface-response>
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
transferorderid: 445413
orderdate: 7/29/2002 5:19:29 PM
ordertypeid: 1
ordertypedesc: Auto Verification
statusid: 4
statusdesc: Processing
authamount: 17.90
version: 1
transferorderdetailid: 301770
sld: resellerdocs2
tld: net
statusid: 9
statusdesc: Awaiting auto verification of transfer request
price: 8.95
usecontacts: 0
transferorderdetailid: 301771
sld: resellerdocs3
tld: info
statusid: 9
statusdesc: Awaiting auto verification of transfer request
price: 8.95
usecontacts: 0
transferorderdetailcount: 2
Command: TP_GETORDER
APIType: API.NET
Language: eng
ErrCount: 0
ResponseCount: 0
MinPeriod: 1
MaxPeriod: 10
Server: sjl0vwresell_t1
Site: eNom
IsLockable:
IsRealTimeTLD:
TimeDifference: +0.00
ExecTime: 0.031
Done: true
TrackingKey: 9d3fa45d-648c-461a-ac95-bcf2ead5a8ad
RequestDateTime: 2/9/2015 12:34:28 PM
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
transferorderid=445413
orderdate=7/29/2002 5:19:29 PM
ordertypeid=1
ordertypedesc=Auto Verification
statusid=4
statusdesc=Processing
authamount=17.90
version=1
transferorderdetailid=301770
sld=resellerdocs2
tld=net
statusid=9
statusdesc=Awaiting auto verification of transfer request
price=8.95
usecontacts=0
transferorderdetailid=301771
sld=resellerdocs3
tld=info
statusid=9
statusdesc=Awaiting auto verification of transfer request
price=8.95
usecontacts=0
transferorderdetailcount=2
Command=TP_GETORDER
APIType=API.NET
Language=eng
ErrCount=0
ResponseCount=0
MinPeriod=1
MaxPeriod=10
Server=sjl0vwresell_t1
Site=eNom
IsLockable=
IsRealTimeTLD=
TimeDifference=+0.00
ExecTime=0.031
Done=true
TrackingKey=9d3fa45d-648c-461a-ac95-bcf2ead5a8ad
RequestDateTime=2/9/2015 12:34:28 PM

Related Commands

PushDomain
SynchAuthInfo
TP_CancelOrder
TP_CreateOrder
TP_GetDetailsByDomain
TP_GetOrderDetail
TP_GetOrderReview
TP_GetOrdersByDomain
TP_GetOrderStatuses
TP_ResendEmail
TP_ResubmitLocked
TP_SubmitOrder
TP_UpdateOrderDetail
UpdatePushList