NOTE: We strongly recommend that you cache this API response to avoid repeated calls.

namecheap.domains.getTldList

Returns a list of tlds

Request Parameters

Global parameters are not shown here for clarity, but should be present in all requests

Name Type MaxLength Required? Default Description
None

Example Request

https://api.namecheap.com/xml.response?ApiUser=apiexample&ApiKey=56b4c87ef4fd49cb96d915c0db68194&
UserName=apiexample&Command=namecheap.domains.gettldlist&ClientIp=192.168.1.109

Example Response

<?xml version="1.0" encoding="utf-8"?>
<ApiResponse Status="OK" xmlns="http://api.namecheap.com/xml.response">
 <Errors /> 
 <RequestedCommand>namecheap.domains.getTldList</RequestedCommand> 
 <CommandResponse Type="namecheap.domains.getTldList">
  <Tlds>
    <Tld Name="biz" NonRealTime="false" MinRegisterYears="1" MaxRegisterYears="10"
         MinRenewYears="1" MaxRenewYears="10" MinTransferYears="1" MaxTransferYears="10" 
         IsApiRegisterable="true" IsApiRenewable="true" IsApiTransferable="false" 
         IsEppRequired="false" IsDisableModContact="false" IsDisableWGAllot="false" 
         IsIncludeInExtendedSearchOnly="false"  SequenceNumber="5" Type="GTLD" 
         IsSupportsIDN="false" Category="P">US Business</Tld> 
    <Tld Name="bz" NonRealTime="false" MinRegisterYears="1" MaxRegisterYears="10"
         MinRenewYears="1" MaxRenewYears="10" MinTransferYears="1" MaxTransferYears="10" 
         IsApiRegisterable="false" IsApiRenewable="false" IsApiTransferable="false" 
         IsEppRequired="false" IsDisableModContact="false" IsDisableWGAllot="false" 
         IsIncludeInExtendedSearchOnly="true" SequenceNumber="11" Type="CCTLD" 
         IsSupportsIDN="false" Category="A">BZ Country Domain</Tld> 
    <Tld Name="ca" NonRealTime="true" MinRegisterYears="1" MaxRegisterYears="10" 
         MinRenewYears="1" MaxRenewYears="10" MinTransferYears="1" MaxTransferYears="10" 
         IsApiRegisterable="false" IsApiRenewable="false" IsApiTransferable="false" 
         IsEppRequired="false" IsDisableModContact="false" IsDisableWGAllot="false" 
         IsIncludeInExtendedSearchOnly="true" SequenceNumber="7" Type="CCTLD" 
         IsSupportsIDN="false" Category="A">Canada Country TLD</Tld>
    <Tld Name="cc" NonRealTime="false" MinRegisterYears="1" MaxRegisterYears="10" 
         MinRenewYears="1" MaxRenewYears="10" MinTransferYears="1" MaxTransferYears="10" 
         IsApiRegisterable="false" IsApiRenewable="false" IsApiTransferable="false" 
         IsEppRequired="false" IsDisableModContact="false" IsDisableWGAllot="false" 
         IsIncludeInExtendedSearchOnly="true" SequenceNumber="9" Type="CCTLD" 
         IsSupportsIDN="false" Category="A">CC TLD</Tld>
    <Tld Name="co.uk" NonRealTime="true" MinRegisterYears="2" MaxRegisterYears="10" 
         MinRenewYears="2" MaxRenewYears="10" MinTransferYears="2" MaxTransferYears="10" 
         IsApiRegisterable="true" IsApiRenewable="false" IsApiTransferable="false" 
         IsEppRequired="false" IsDisableModContact="false" IsDisableWGAllot="false"
         IsIncludeInExtendedSearchOnly="false" SequenceNumber="18" Type="CCTLD" 
         IsSupportsIDN="false" Category="A">UK based domain</Tld>
  </Tlds>
 </CommandResponse>
 <Server>IMWS-A06</Server> 
 <GMTTimeDifference>+5:30</GMTTimeDifference> 
 <ExecutionTime>0.047</ExecutionTime> 
</ApiResponse>

Error Codes

Specifies the error codes that might be returned from this method

Number Description
2011166 UserName is invalid
3050900 Unknown response from provider

Comments

Support requests, bug reports, and off-topic comments will be deleted without warning.

Please do post corrections or additional information/ pointers for this article below. We aim to quickly move corrections into the documentation. Also, your comments may take some time to appear.

If you need specific help with your account, please contact Support

We are an ICANN accredited registrar. Serving customers since 2001
TRUSTe online privacy certification
Verisign Security Seal - Click to Verify
Payment Options
Supported Currency Conversions