TLD_GetTLD


Definition

Retrieve a list of TLDs currently offered for this account.

Usage

Use this command to retrieve a list of TLDs currently offered for this account.

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/tlds/watchlist.aspx

The Browse TLDs tab calls the TLD_GetTLD command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.

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
Category Optional Return a list of TLDs filtered by Primary Category 500
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML 4

 

Returned parameters and values

Parameter Description
Name TLD name (IDN is displayed as PUNY Code).

International Domain Name (IDN) allows more web users to navigate the Internet in their preferred native language. Most domain names are registered in ASCII characters. The non-Latin scripts such as Chinese, Russian, Korean or other languages cannot be rendered in ASCII. IDN is fully supported in PUNY Code and URL Encoded format.

To get more information and conversion tool for PUNY Code, check the sites below:
- Verisign's IDN Tool: http://mct.verisign-grs.com
- RFC 3492: http://tools.ietf.org/html/rfc3492
CategoryNames TLD Category. Each TLD may have more than one category. The first category in this list (comma delimited format) is the Primary
NativeIDN TLD Name in native characters
Description Description of NativeIDN
StatusID TLD Status ID
StatusDesc TLD Status Description
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