List DNS records

GET /v1/domain-purchases/:id/dns

Returns the DNS records currently set on the domain at the registrar. Records aren't stored in Domainee — the source of truth lives at the registrar, this endpoint is a thin pass-through.

Request

curl https://api.domainee.dev/v1/domain-purchases/f8a0c1b9-…/dns \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Response — 200 OK

{
  "hostname": "janesbakery.com",
  "records": [
    { "type": "CNAME", "name": "@",   "value": "edge.domainee.dev", "ttl": 300 },
    { "type": "TXT",   "name": "@",   "value": "v=spf1 include:_spf.acme.com ~all", "ttl": 3600 },
    { "type": "MX",    "name": "@",   "value": "inbox.acme.com", "ttl": 3600, "priority": 10 }
  ]
}

Record fields

Field	Notes
type	A, AAAA, CNAME, MX, TXT, NS, SRV, URL, URL301, FRAME.
name	@ is the apex (e.g. janesbakery.com). www would be www.janesbakery.com.
value	Target/value of the record. IP, hostname, or text content.
ttl	Cache duration in seconds. Lower = faster propagation, higher = better cache hit.
priority	MX records only. Lower = preferred.

Use this for

• Rendering a DNS records table in your dashboard
• Validating that a previous PUT /:id/dns actually took effect at the registrar
• Pre-loading the form when the user clicks "Edit records"

Cache the response on your side if you display this on every page load — each call hits the registrar's API.