---
title: "List DNS records"
method: GET
path: "/domains/{name}/dns/records"
tags: ["dns-records"]
---

# List DNS records

`GET /domains/{name}/dns/records`

Retrieve DNS records for the specified domain. Supports filtering by record type and subdomain name, and cursor-based pagination.

## Path parameters

- `name` string, required

## Query parameters

- `$cursor` string
- `type` DnsRecordType[]
- `subName` string[]

## Response `200`

List of DNS records

- DomainDnsRecordsResponse
  - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
  - `items` DomainDnsRecordResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.DomainDnsRecord', required
    - `subName` string
    - `type` 'A' | 'AAAA' | 'ALIAS' | 'CAA' | 'CNAME' | 'DNSKEY' | 'DS' | 'HTTPS' | 'IPSECKEY' | 'MX' | 'NAPTR' | 'NS' | 'PTR' | 'SOA' | 'SPF' | 'SRV' | 'SSHFP' | 'SVCB' | 'TLSA' | 'TXT', required
    - `values` string[], required
    - `ttl` number, required
    - `readonly` DomainDnsRecordReadonlyResponse
      - `state` boolean, required
      - `reasons` string[], required
    - `id` string, required — DNS record ID
  - `next` CursorListResponseNext, required
    - `$cursor` string

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/unstoppabledomains/apis/reseller-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/reseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/reseller-api/revisions/e0ac88d02fe7/schema)