namecheap.domains.dns.getHosts
Retrieves DNS host record settings for the requested domain.
Request Parameters
Global parameters are not shown here for clarity, but should be present in all requests
| Name | Type | MaxLength | Required? | Default | Description |
| SLD | String | 70 | Yes | | SLD of the domain to getHosts |
| TLD | String | 10 | Yes | | TLD of the domain to getHosts
|
Example Request
https://api.namecheap.com/xml.response?ApiUser=apiexample&ApiKey=56b4c87ef4fd49cb96d915c0db68194&
UserName=apiexample&Command=namecheap.domains.dns.getHosts&ClientIp=192.168.1.109&
SLD=domain&TLD=com
Example Response
<?xml version="1.0" encoding="utf-8"?>
<ApiResponse Status="OK" xmlns="http://api.namecheap.com/xml.response">
<Errors />
<RequestedCommand>namecheap.domains.dns.getHosts</RequestedCommand>
<CommandResponse Type="namecheap.domains.dns.getHosts">
<DomainDNSGetHostsResult Domain="domain.com" IsUsingOurDNS="true">
<Host HostId="12" Name="@" Type="A" Address="1.2.3.4" MXPref="10" TTL="1800" />
<Host HostId="14" Name="*" Type="A" Address="1.2.3.4" MXPref="10" TTL="1800"/>
</DomainDNSGetHostsResult>
</CommandResponse>
<Server>SERVER-NAME</Server>
<GMTTimeDifference>+5</GMTTimeDifference>
<ExecutionTime>32.76</ExecutionTime>
</ApiResponse>
Error Codes
Specifies the error codes that might be returned from this method
| Number | Description |
| 2019166 | Domain not found |
| 2030166 | Edit Permission for Domainname is not supported |
2030288
| Cannot complete this command as this domain is not using proper DNS servers
|
| 4023330 | Unable to get DNS hosts
from list |
| 3031510 | Error From Enom when Errorcount <> 0 |
| 3050900 | Unknown error from Enom |
| 3011288 | Invalid nameserver specified |
| 5050900 | Unhandled Exceptions |