Get a DNS Name

GET /v1/dns/records/{zone_name}/{name}

Get detailed information about a DNS name.

Path Parameters

zone_name

The name of the zone.

Example: example.com

name

The DNS name, not including the zone portion.

Example: dns-name

Response

200 401 404

---

OK

DNS name, not fully-qualified

{
  "data": {
    "metadata": {
      "public property": "public value"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "is_published": true,
    "is_write_prohibited": true,
    "name": "dns-name",
    "name_labels_reversed": "string"
  },
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Unauthorized

unauthorized (code: 2465)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Not Found

Multiple error variants are possible:

• DNS name not found (code: 4809)
• zone not found (code: 2510)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}