Skip to main content
GET
List dedicated IPs

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

filter[status]
enum<string>

Return only IPs in this lifecycle status (exact match). Any other value returns an empty list. An empty value applies no filter.

Available options:
provisioning,
warming_up,
active,
suspended,
released
filter[pool_id]
string<uuid>

Return only IPs in this pool (exact match on pool_id). A value that is not a UUID returns an empty list. An empty value applies no filter.

filter[region]
string

Return only IPs in this region (exact, case-sensitive match on region). An empty value applies no filter.

Response

Dedicated IP list

data
object[]
required