---
title: "List DNS Records"
method: GET
path: "/v1/domains/{domain}/dns-records"
tags: ["Domains"]
---

# List DNS Records

`GET /v1/domains/{domain}/dns-records`

## Request

- Base URL: `https://api.migma.ai`
- URL: `https://api.migma.ai/v1/domains/{domain}/dns-records`
- Auth: API key in header `Authorization`

List DNS records on a domain whose DNS zone is hosted by Migma. Only domains bought in Migma have Migma-hosted zones; for other domains managed is false and records is empty. Requires API key with domain:read permission.

## Path parameters

- `domain` string, required

## Response `200`

DNS records for the domain

- ApiResponseDnsRecords
  - `success` boolean, required
  - `data` object, nullable
    - `managed` boolean, required: Whether Migma hosts this domain's DNS zone. Only domains bought in Migma have Migma-hosted zones. When false, records is empty.
    - `records` CustomDnsRecord[], required
      - `id` string, required: Record id, used to remove the record
      - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS', required: DNS record type
      - `name` string, required: Record name. '@' for the root domain, a label like 'mail', or a full name
      - `content` string, required: Record value, e.g. an IP address, hostname, or TXT content
      - `priority` number: Priority, set on MX records
      - `createdAt` string, required: When the record was added (ISO 8601)
  - `error` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Missing required permissions or access denied

## Changes

- **2026-08-22** `2d06ad0e0bc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/domains/:domain/dns-records/get.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) - [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/2ce0e1e4d856?raw)