Dedicated IPs

List dedicated IPs

Changed on

List the dedicated sending IPs owned by the account, newest first. Narrow the list with filter[status], filter[pool_id], and filter[region]; supplied filters combine, so an IP must match every one. An empty value, or a nested or array value such as filter[status][]=active, applies no filter, and other filter[...] keys are ignored. A value that no IP can match (an unknown status, a pool_id that is not a UUID, or a value containing a NUL byte) returns an empty list, not an error.

get/email/dedicated_ips

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/email/dedicated_ips
  • Auth: HTTP bearer

Query parameters

filter[status]'provisioning' | 'warming_up' | 'active' | 'suspended' | 'released'

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

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

Changes