Revision as of 17:04, 18 February 2013

GET /dns/{zone}/records

Returns the DNS zone records.

Request

GET /dns/{zone}/records

Parameters

zone - string

The name of the DNS zone.

URI Parameters

filterType

Optional. Specifies the type of records to return: A, AAAA, NS, TXT, SRV, MX, CNAME

page - number

Optional. Specifies the page to return in paginated response. Default is 1.

pageSize - number

Optional. Specifies the number of records per page. Default 10, Max 100.

Request Headers

Authorization

Base64-encoded username:password string

Response

Status Code

200 OK

Success

401 Unauthorized

The server could not verify the credentials from the authorization header.

404 Not Found

The specified zone does not exist.

Response Body

[
  {
    "id": {id},
    "name": "{domain}",
    "type: "AAAA",
    "ttl": {ttl},
    "address": "{ipv6_address}",
    "links": [
      {"href": "https://api.hostway.com/dns/{zone}/records/{id}/", "rel": "self"}
    ]
  },
  {
    "id": {id},
    "name": "{domain}",
    "type: "A",
    "ttl": {ttl},
    "address": "{ipv4_address}",
    "links": [
      {"href": "https://api.hostway.com/dns/{zone}/records/{id}/", "rel": "self"}
    ]
  }
]
 

See also

• DNS API
• Common Features