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[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[usable_for_sending]boolean
filter[usable_for_inbound]boolean
Response
A paginated list of email domains
Example response
{
"data": [
{
"created_at": "2026-01-01T00:00:00Z",
"dkim": {
"active": false,
"algorithm": null,
"key_length": null,
"rotated_at": null,
"selector": null
},
"dmarc_policy": {
"p": "none",
"pct": 100,
"rua": "mailto:dmarc@telnyx.com"
},
"dns_records": [],
"domain": "example.com",
"id": "123e4567-e89b-12d3-a456-426614174000",
"inbound": {
"catch_all": false,
"enabled": false,
"mx_required": false
},
"record_type": "email_domain",
"status": "pending",
"tracking": {
"click_tracking": false,
"open_tracking": false,
"unsubscribe_tracking": false
},
"type": "custom",
"updated_at": "2026-01-01T00:00:00Z",
"usable_for_inbound": false,
"usable_for_sending": false,
"verification": {
"dkim": "pending",
"dmarc": "missing_optional",
"mx": "not_required",
"ownership": "pending",
"spf": "missing_optional"
},
"verified_at": null
}
]
}