GetDomainStatus


Definition

Check the registration status of TLDs that do not register in real time.

Usage

Use this command to check the status of domains that do not register in real time (including .ca, .co.uk, .org.uk,and others). Because of the delay inherent in the non-real-time registrations, wait at least five minutes after yourtransaction to run this command, and run it at intervals of five minutes or longer. This command runs more quicklythan a similar command, StatusDomain.

Use this command to retrieve the most recent order ID for a domain name.

Availability

All resellers have access to this command.

Implementation on eNom.com

This command is not implemented on enom.com.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The domain name must belong to 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

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
SLD Required Second-level domain name (for example, enom in enom.com) 63
TLD Required Top-level domain name (extension) 15
OrderID Recommended Order ID of the most recent transaction for this domain 15
OrderType Optional; default is Purchase Type of order. Permitted values are Purchase (default), Transfer, or Extend 10
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
DomainName Domain name
InAccount Status of the domain in our database: 0 not in our database 1 in our database and in the account cited in this query 2 in our database but in a different account than the one cited in this query
StatusDesc More detailed explanation of the InAccount value
ExpDate Expiration date of the domain registration
OrderID Order identification number of the most recent transaction for this domain
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True 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=HTML or 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.

Example