---
title: "List email domains"
method: GET
path: "/email_domains"
tags: ["Email Domains"]
---

# List email domains

`GET /email_domains`

Shared (`type: shared`) Telnyx-managed domains are included/readable for every account, in addition to the account's own custom domains.

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `page[after]` string
- `page[before]` string
- `sort` 'created_at' | '-created_at' | 'domain' | '-domain'
- `filter[status]` 'pending' | 'verifying' | 'verified' | 'failed' | 'degraded' | 'suspended'
- `filter[domain]` string
- `filter[profile_id]` string, uuid
- `filter[type]` 'custom' | 'shared' | 'shared_inbound'
- `filter[usable_for_sending]` boolean
- `filter[usable_for_inbound]` boolean

## Response `200`

A paginated list of email domains

- EmailDomainListResponse
  - `data` EmailDomain[], required
    - `id` string, uuid, required
    - `record_type` 'email_domain', required
    - `domain` string, required
    - `type` 'custom' | 'shared' | 'shared_inbound', required
    - `status` 'pending' | 'verifying' | 'verified' | 'failed' | 'degraded' | 'suspended', required
    - `usable_for_sending` boolean, required
    - `usable_for_inbound` boolean, required
    - `verification` EmailDomainVerification, required
      - `ownership` 'pending' | 'verified' | 'not_required', required
      - `spf` 'missing_optional' | 'verified' | 'failed' | 'not_required', required
      - `dkim` 'pending' | 'verified' | 'failed', required
      - `dmarc` 'missing_optional' | 'verified' | 'failed', required
      - `mx` 'not_required' | 'pending' | 'verified' | 'failed', required
    - `dns_records` 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
    - `dkim` DKIMStatus, required
      - `selector` string, nullable, required
      - `algorithm` 'rsa-sha256' | 'null', nullable, required
      - `key_length` 2048 | null, nullable, required
      - `active` boolean, required
      - `rotated_at` string, date-time, nullable, required
    - `inbound` InboundConfig, required
      - `enabled` boolean, required
      - `catch_all` boolean, required
      - `mx_required` boolean, required
    - `dmarc_policy` EmailDMARCPolicy, required — DMARC policy for a sending domain. Drives the recommended _dmarc.<domain> TXT record. DMARC is advisory and never blocks sending. When omitted or null, the domain uses the advisory default (v=DMARC1; p=none; rua=mailto:dmarc@telnyx.com).
      - `p` 'none' | 'quarantine' | 'reject' — Policy applied to messages that fail alignment.
      - `pct` integer — Percentage of messages the policy applies to. Omitted from the record when 100.
      - `rua` string, nullable — URI for aggregate reports. Defaults to the Telnyx address when absent; null omits it.
      - `sp` 'none' | 'quarantine' | 'reject', nullable — Policy for subdomains. Omitted from the record when null.
    - `tracking` DomainsTrackingSettings, required
      - `open_tracking` boolean — Inject a tracking pixel into HTML messages to record open events.
      - `click_tracking` boolean — Rewrite HTML links through a tracking redirect to record click events.
      - `unsubscribe_tracking` boolean — Add RFC 8058 List-Unsubscribe headers with a signed one-click unsubscribe URL. Enabled by default; Gmail/Yahoo bulk-sender rules require one-click unsubscribe support.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `verified_at` string, date-time, nullable
    - `reputation` object — Sender reputation for this domain (present on all domain responses).
      - `band` string — Reputation band, e.g. good/warn/poor.
      - `breakdown` object
      - `computed_at` string, date-time, nullable
  - `meta` union, required
    - OffsetPaginationMeta
      - `page_number` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
      - `total_results` integer, required
    - EmailCursorPaginationMeta
      - `page_size` integer, required
      - `next_cursor` string, nullable — Opaque cursor to fetch the next page
      - `previous_cursor` string, nullable — Opaque cursor to fetch the previous page
      - `has_next` boolean, required
      - `has_previous` boolean, required

## Other responses

- `400` — Validation failed
- `500` — Internal server error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)