Skip to main content
Live zone view, not the verification setup view. This returns every record currently in the DNS zone (with the provider record IDs needed for delete). For the read-only list of email setup records the customer needs to add to pass verification, see /dns-records.
​
id
string
required
Domain UUID
curl https://api.usenaive.ai/v1/domains/dom-uuid-2/zone-records \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "domain": "acme.com",
  "domain_id": "dom-uuid-2",
  "mock": false,
  "records": [
    {
      "id": "rec_abc",
      "type": "A",
      "name": "",
      "value": "76.76.21.21",
      "ttl": 60,
      "comment": "naive:owned;company=co_...;agent=ag_...;ts=1717..."
    },
    {
      "id": "rec_def",
      "type": "CNAME",
      "name": "www",
      "value": "shops.myshopify.com",
      "ttl": 60
    }
  ]
}

​
Differences from GET /v1/domains/:id/dns-records

EndpointReturns
GET /v1/domains/:id/dns-recordsThe email setup records (MX, TXT for SPF, CNAME for DKIM) the customer must add at their registrar to pass verification. Read-only and informational.
GET /v1/domains/:id/zone-recordsEvery record currently in the live DNS zone, with the provider record ID (id) needed for DELETE /v1/domains/:id/zone-records/:recordId.

​
Fields

FieldDescription
domainThe fully-qualified domain
domain_idDomain UUID
mocktrue when running in DOMAIN_MOCK mode (no real DNS provider call)
records[].idProvider record ID — pass to DELETE for removal
records[].typeA, AAAA, CNAME, MX, TXT, NS, or CAA
records[].nameRecord name; "" for apex
records[].valueRecord value
records[].ttlTTL in seconds
records[].priorityMX priority (MX records only)
records[].commentDNS record comment; records written by Naive use naive:owned;company=...;agent=...;ts=...

​
Errors

StatusreasonCause
501FEATURE_DISABLEDAGENT_DNS_EDIT_ENABLED is false on the API
501MOCK_MODE_REJECTEDNo DNS_REGISTRAR_TOKEN and DOMAIN_MOCK not enabled
403SYSTEM_DOMAINTried to read a system-registered domain (system domains are read-only via this endpoint)
404DOMAIN_NOT_FOUNDDomain doesn’t exist or belongs to another company