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

# List DNS records

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

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/domains/{name}/dns/records`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/domains/:name/dns/records/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-03** `f2c42c8ffa95`: 1 warning, 1 info
  - removed the optional property `next/allOf[#/components/schemas/CursorListResponseNext]/cursor` from the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/CursorListResponseNext]/$cursor` to the response with the `200` status
- **2026-02-27** `64f751be432d`: 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - …1 more

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/domains/:name/dns/records/get.md)

---

[API](https://skmtc.dev/unstoppabledomains/apis/reseller-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/reseller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/reseller-api/revisions/e0ac88d02fe7?raw)