Retrieve a list of the TLDs that you offer.


Use this command to retrieve a list of the TLDs that you offer. If you have not specifically authorized TLDs then this command returns all TLDs offered by us.

Use the AuthorizeTLD command to authorize TLDs and the RemoveTLD command to remove TLDs from authorized status for your account.


All resellers have access to this command.

Implementation on

Log on to with Login ID resellid, password resellpw.

Clicking the TLD pricing tab shows a table that includes all TLDs offered by this account (although the contents of this particular table are retrieved by a different command than GetTLDList).


The query must meet the following requirements:

  • The login ID and password must be valid.

Input parameters

Build the query string using this syntax:


Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4


Returned parameters and values

Parameter Description
TLDX Top-level domain name (extension). If ResponseType=text or html, each entry is indexed X.
TLDCount Number of TLDs listed in this response (that is, the number of TLDs authorized by this account)
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.



  • 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 parameterErr(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.