REST API v1.1 - Managed DNS

Zones - Get a zone

This response is similar to Listing All Zones, with the addition of hosts-count and possibly hosts. As long as there are no more than 300 hosts, they will be returned. If there are more, the hosts array will be left out. hosts-count will always be returned.

Request

Example
GET /api/1.1/zones/12345678.xml

GET /api/1.1/zones/example.com.xml (to retrieve the record for example.com)

Response

Example body
<zone>
  <created-at type="datetime">2008-12-07T02:40:02Z</created-at>
  <custom-nameservers>ns1.example.com,ns2.example.com</custom-nameservers>
  <custom-ns type="boolean">true</custom-ns> 
  <default-ttl type="integer">600</default-ttl>
  <domain>example.com</domain>
  <hostmaster>dnsadmin@example.com</hostmaster> 
  <id type="integer">12345678</id>
  <notes nil="true"/>
  <ns1 nil="true"/>
  <ns-type>pri_sec</ns-type>
  <nx-ttl nil="true"></nx-ttl>
  <slave-nameservers nil="true"/>
  <tag-list>one two</tag-list>
  <updated-at type="datetime">2008-12-07T02:40:02Z</updated-at>
  <hosts-count>1</hosts-count>
  <hosts type="array">
    <host>
      <created-at type="datetime">2008-12-07T02:51:13Z</created-at>
      <data>172.16.16.1</data>
      <fqdn>example.com</fqdn>
      <host-type>A</host-type>
      <hostname nil="true"/>
      <id type="integer">23456789</id>
      <notes nil="true"/>
      <priority type="integer" nil="true"/>
      <ttl type="integer" nil="true"/>
      <updated-at type="datetime">2008-12-07T02:51:13Z</updated-at>
      <zone-id type="integer">12345678</zone-id>
    </host>
  </hosts>
</zone>