Sign in
Email Domains

List email domains

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

get/email_domains

Query parameters

page[number]integer

Page number to return (offset pagination)

page[size]integer

Number of records per page

page[after]string

Cursor for records after the provided value (cursor pagination)

page[before]string

Cursor for records before the provided value (cursor pagination)

sort'created_at' | '-created_at' | 'domain' | '-domain'

Field to sort by. Prefix with - for descending order.

filter[status]'pending' | 'verifying' | 'verified' | 'failed' | 'degraded' | 'suspended'

Filter domains by verification status: pending, verifying, verified, failed, degraded, or suspended.

filter[domain]string

Partial match on domain name (case-insensitive)

filter[profile_id]string uuid

Filter by profile UUID

filter[type]'custom' | 'shared' | 'shared_inbound'

Filter domains by type: custom, shared, or shared_inbound.

filter[usable_for_sending]boolean

Filter domains by whether they can currently be used to send email.

filter[usable_for_inbound]boolean

Filter domains by whether they can currently receive inbound email.

Response

A paginated list of email domains

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "record_type": "email_domain",
      "domain": "example.com",
      "type": "custom",
      "status": "pending",
      "usable_for_sending": false,
      "usable_for_inbound": false,
      "verification": {
        "ownership": "pending",
        "spf": "missing_optional",
        "dkim": "pending",
        "dmarc": "missing_optional",
        "mx": "not_required"
      },
      "dns_records": [],
      "dkim": {
        "selector": null,
        "algorithm": null,
        "key_length": null,
        "active": false,
        "rotated_at": null
      },
      "inbound": {
        "enabled": false,
        "catch_all": false,
        "mx_required": false
      },
      "dmarc_policy": {
        "p": "none",
        "pct": 100,
        "rua": "mailto:dmarc@telnyx.com"
      },
      "tracking": {
        "open_tracking": false,
        "click_tracking": false,
        "unsubscribe_tracking": false
      },
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z",
      "verified_at": null
    }
  ]
}

Changes

Changed in 5 of the 99 revisions of this API.253

  • 16bfa298dc712See the full diff
    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • b1bf96d8391e31See the full diff
    • ●

      added the new not_required enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new not_required enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new shared_inbound enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value shared_inbound to the query request parameter filter[type]

      request-parameter-enum-value-added

  • 80833e66e01011See the full diff
    • ▲

      the // response's property type changed from string to object for status

      response-property-type-changed

    • ○

      added to the // response property allOf list for the response status

      response-property-all-of-added

  • 6ef0ae248bf71See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 224ed0d8a5c31See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 111 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 99 revisions, 1 has no diff computed.