This API method fetches a zone configuration


GET /zone/zone_name HTTP/1.0
Accept: encoding_type
Authorization: Basic base64_credentials


  • zone_name is the name of the zone you want to get configuration for (ie.:
  • base64_credentials is username:password in base64-encoded format (HTTP Basic Authentication)
  • encoding_type is either application/xml or application/json (if the “Accept” header is omitted, response will be JSON-encoded)

Sample requests:

  • Raw request:
GET /zone/ HTTP/1.0
Accept: application/json
Authorization: Basic dGVzdHVzZXJAZ3NsYi5tZTp0ZXN0cGFzc3dvcmQK
  • Using curl:
curl -u -H "Accept: application/json" -k


  • In case of invalid zone:
HTTP/1.1 404 Not Found
Content-Type: application/json

{"message":"Zone not found","returncode":"2"}
  • In case of internal error:
HTTP/1.1 500 Server Error
Content-Type: application/json

{"message":"Internal error, please contact","returncode":"4"}
  • In case of success:
HTTP/1.1 200 OK
Content-Type: application/json

    "active":"true", "expire":"1209600", "name":"", "needscommit":"false",
    "postmaster":"", "refresh":"3600", "retry":"600",
    "serialnumber":"1365066235", "sourceHost":"", "ttl":"3600"


  • geohosts is an array detailing all geohosts for the requested zone (see “Get Geohost Configuration” for the format of each array item)
  • rrsets is an array detailing all records (record sets) for the requested zone:
  • id: internal id, to be used for deleting/modifying the rrset (see rrset methods)
  • name: the rrset name
  • readonly: true if the rrset can be modified/deleted, false otherwise
  • TTL: Time-To-Live in seconds
  • type: the rrset type. Allowed types are A, AAAA, CNAME, LOC, MX, NS, RP, SOA, SPF, SRV, TXT
  • value: the rrset value
  • zone lists all parameters for the zone:
  • active: zone can be either enabled or disabled
  • expire: the SOA expire field
  • name: the zone name
  • needscommit: if true the zone has uncommitted changes that need to be committed in order to become active
  • postmaster: the SOA postmaster field
  • refresh: the SOA refresh field
  • retry: the SOA retry field
  • serialnumber: the SOA serial number field
  • sourcehost: the SOA source host field
  • TTL: the SOA TTL field