This API method fetches all records for a zone


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


  • zone_name is the name of the zone you want to get records 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 /records/ 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

    {"id":"576","name":"@","readonly":"false","TTL":"86400","type":"MX","value":"10 mail"},


  • rrset is an array detailing all records (record sets) for the requested zone:
  • id: internal id, to be used for deleting/modifying the rrset via Modify Zone Record and Delete Zone Record methods
  • name: the rrset name
  • readonly: true if the rrset can be modified/deleted, false otherwise
  • TTL: Time-To-Live in seconds. This is always 86400 for free users. Subscribers can fully customize TTL
  • type: the rrset type. Allowed types are A, AAAA, CAA, CERT, CNAME, LOC, MX, NS, RP, SOA, SPF, SRV, TXT
  • value: the rrset value