# List DNS records for a domain

List all DNS records for a domain in your portfolio. Supports filtering by record type and subdomain, with pagination.

Endpoint: POST /mcp/v1/actions/ud_dns_records_list
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `domain` (string, required)
    Domain name (e.g., "example.com")

  - `type` (string)
    Filter by record type (A, AAAA, CNAME, MX, TXT, NS)

  - `subName` (string)
    Filter by subdomain ("@" for root, "www", "*" for wildcard)

  - `cursor` (string)
    Pagination cursor

## Response 200 fields (application/json):

  - `domain` (string)

  - `records` (array)

  - `records.id` (string,null)
    Record ID (may be undefined for system records)

  - `records.type` (string)
    Enum: "A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV", "CAA"

  - `records.subName` (string,null)
    Record subdomain (relative name)

  - `records.values` (array)
    Record values

  - `records.ttl` (number)
    Time to live in seconds

  - `records.readonly` (boolean)
    Whether this record is read-only and cannot be modified

  - `records.readonlyReasons` (array)
    Reasons why the record is read-only

  - `pagination` (object)

  - `pagination.hasMore` (boolean)

  - `pagination.nextCursor` (string,null)

  - `dnsStatus` (object,null)
    Present when DNS is not managed by UD. Explains the current DNS configuration state.

  - `dnsStatus.configured` (boolean)
    Whether nameservers are set up for this domain

  - `dnsStatus.provider` (string,null)
    DNS provider: "ud" for UD-managed, "external" for third-party
    Enum: "ud", "external"

  - `dnsStatus.message` (string)
    Human-readable explanation and suggested next steps


## Response 401 fields