Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

Telnyx API key supplied as Authorization: Bearer <token>. In production, auth may be validated by the API gateway and forwarded via Telnyx auth headers.

Query Parameters

page[number]
integer
default:1

Page number to return (offset pagination)

Required range: x >= 1
page[size]
integer
default:25

Number of records per page

Required range: 1 <= x <= 100
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
enum<string>

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

Available options:
created_at,
-created_at,
domain,
-domain
filter[status]
enum<string>

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

Available options:
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]
enum<string>

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

Available options:
custom,
shared,
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

data
object[]
required
meta
object
required