Sign in

v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-041,1941,9384.1 MB
CSV Downloads

Create a CSV download

post/phone_numbers/csv_downloads

Query parameters

csv_format'V1' | 'V2'
Example:V2

Which format to use when generating the CSV file. The default for backwards compatibility is 'V1'

billing_group_idstring

Filter by the billing_group_id associated with phone numbers. To filter to only phone numbers that have no billing group associated them, set the value of this filter to the string 'null'.

connection_idstring

Filter by connection_id.

customer_referencestring

Filter numbers via the customer_reference set.

emergency_address_idstring

Filter by the emergency_address_id associated with phone numbers. To filter only phone numbers that have no emergency address associated with them, set the value of this filter to the string 'null'.

has_bundlestring

Filter by phone number that have bundles.

phone_numberstring

Filter by phone number. Requires at least three digits. Non-numerical characters will result in no values being returned.

status'purchase-pending' | 'purchase-failed' | 'port-pending' | 'active' | 'deleted' | 'port-failed' | 'emergency-only' | 'ported-out' | 'port-out-pending'

Filter by phone number status.

tagstring

Filter by phone number tags.

voice.usage_payment_method'pay-per-minute' | 'channel'

Filter by usage_payment_method.

Consolidated filter parameter (deepObject style). Originally: filter[has_bundle], filter[tag], filter[connection_id], filter[phone_number], filter[status], filter[voice.connection_name], filter[voice.usage_payment_method], filter[billing_group_id], filter[emergency_address_id], filter[customer_reference]

{
  "billing_group_id": "62e4bf2e-c278-4282-b524-488d9c9c43b2",
  "connection_id": "1521916448077776306",
  "emergency_address_id": "9102160989215728032",
  "status": "active",
  "voice.connection_name": {
    "contains": "test",
    "ends_with": "test",
    "eq": "test",
    "starts_with": "test"
  },
  "voice.usage_payment_method": "channel"
}

Response

Successful response with details about a CSV download.

Example response

{
  "data": [
    {
      "id": "42587e44-3a3e-46de-9255-0c9a7a1d1ec7",
      "record_type": "csv_download",
      "status": "pending",
      "url": "https://www.telnyx.com/sample/42587e44-3a3e-46de-9255-0c9a7a1d1ec7"
    }
  ]
}