API Documentation

List DNS Records

Returns all DNS records for a domain. This is a lightweight alternative to the full domain details endpoint when you only need the DNS records.

Request

GET /api/v1/domains/{id}/dns

Required scope: domains:read

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": [
    {
      "id": "abc123",
      "type": "A",
      "name": "@",
      "value": "45.84.196.79",
      "ttl": 3600,
      "priority": null
    },
    {
      "id": "def456",
      "type": "AAAA",
      "name": "@",
      "value": "2a03:4000:64:e8b::1",
      "ttl": 3600,
      "priority": null
    },
    {
      "id": "ghi789",
      "type": "MX",
      "name": "@",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10
    },
    {
      "id": "jkl012",
      "type": "TXT",
      "name": "@",
      "value": "v=spf1 include:_spf.google.com ~all",
      "ttl": 3600,
      "priority": null
    }
  ]
}

Record Fields

Field Type Description
id string Record identifier
type string Record type: A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA, SSHFP
name string Record name (e.g. @, www, mail, _dmarc)
value string Record value (IP address, hostname, TXT content, etc.)
ttl number Time to live in seconds
priority number | null Priority (used by MX and SRV records)

Errors

Status Code Description
404 NOT_FOUND Domain not found or access denied

Example

curl https://hosting.site.quest/api/v1/domains/6997649fd6212ab98fbb7289/dns \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the list_dns_records MCP tool.