---
title: "List DNS records for an email domain"
method: GET
path: "/email_domains/{domain_id}/dns_records"
tags: ["Email Domain DNS Records"]
---

# List DNS records for an email domain

`GET /email_domains/{domain_id}/dns_records`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/email_domains/{domain_id}/dns_records`
- Auth: HTTP bearer

Returns the DNS records Telnyx generated for domain ownership and DKIM verification, plus MX records when inbound delivery is enabled.

## Path parameters

- `domain_id` string, uuid, required

## Response `200`

DNS records for the email domain

- DNSRecordListResponse
  - `data` DNSRecord[], required
    - `id` string, uuid, required
    - `purpose` 'ownership' | 'spf' | 'dkim' | 'dmarc' | 'mx', required
    - `record_type` 'TXT' | 'MX', required
    - `host` string, required
    - `value` string, required
    - `actual_value` string, nullable
    - `priority` integer, nullable
    - `required` boolean, required
    - `status` 'pending' | 'verified' | 'failed' | 'not_required', required

## Other responses

- `404`: Resource not found
- `500`: Internal server error

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-09-23** `16bfa298dc71`: 2 warning
  - added the new `40901` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `40901` enum value to the `errors/items/code` response property for the response status `500`
- **2026-07-07** `6ef0ae248bf7`: 1 info
  - endpoint added
- **2026-07-02** `224ed0d8a5c3`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_domains/:domain_id/dns_records/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)