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.