Slim List phone numbers

GET /phone_numbers/slim

List phone numbers, This endpoint is a lighter version of the /phone_numbers endpoint having higher performance and rate limit.

Request

Query Parameters

page object

Consolidated page parameter (deepObject style). Originally: page[size], page[number]

include_connection boolean

Include the connection associated with the phone number.

include_tags boolean

Include the tags associated with the phone number.

sort string

Possible values: [purchased_at, phone_number, connection_name, usage_payment_method]

Specifies the sort order for results. If not given, results are sorted by created_at in descending order.

filter object

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

Responses

200: Successful response with a list of phone numbers.

application/json

Schema

data

object[]

Array [

id IntId (string)

Identifies the resource.

record_type string

Identifies the type of the resource.

phone_number string

The +E.164-formatted phone number associated with this record.

country_iso_alpha2 string

The ISO 3166-1 alpha-2 country code of the phone number.

status string

Possible values: [purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending, requirement-info-pending, requirement-info-under-review, requirement-info-exception, provision-pending]

The phone number's current status.

external_pin string

If someone attempts to port your phone number away from Telnyx and your phone number has an external PIN set, Telnyx will attempt to verify that you provided the correct external PIN to the winning carrier. Note that not all carriers cooperate with this security mechanism.

connection_id string

Identifies the connection associated with the phone number.

customer_reference string

A customer reference string for customer look ups.

billing_group_id string

Identifies the billing group associated with the phone number.

emergency_enabled boolean

Indicates whether emergency services are enabled for this number.

emergency_address_id string

Identifies the emergency address associated with the phone number.

emergency_status string

Possible values: [active, deprovisioning, disabled, provisioning, provisioning-failed]

Indicates the status of the provisioning of emergency services for the phone number. This field contains information about activity that may be ongoing for a number where it either is being provisioned or deprovisioned but is not yet enabled/disabled.

call_forwarding_enabled boolean

Default value: true

Indicates if call forwarding will be enabled for this number if forwards_to and forwarding_type are filled in. Defaults to true for backwards compatibility with APIV1 use of numbers endpoints.

cnam_listing_enabled boolean

Indicates whether a CNAM listing is enabled for this number.

caller_id_name_enabled boolean

Indicates whether caller ID is enabled for this number.

call_recording_enabled boolean

Indicates whether call recording is enabled for this number.

t38_fax_gateway_enabled boolean

Indicates whether T38 Fax Gateway for inbound calls to this number.

purchased_at string

ISO 8601 formatted date indicating when the resource was purchased.

created_at string

ISO 8601 formatted date indicating when the resource was created.

phone_number_type string

Possible values: [local, toll_free, mobile, national, shared_cost, landline, tollfree, shortcode, longcode]

The phone number's type. Note: For numbers purchased prior to July 2023 or when fetching a number's details immediately after a purchase completes, the legacy values tollfree, shortcode or longcode may be returned instead.

inbound_call_screening string

Possible values: [disabled, reject_calls, flag_calls]

Default value: disabled

The inbound_call_screening setting is a phone number configuration option variable that allows users to configure their settings to block or flag fraudulent calls. It can be set to disabled, reject_calls, or flag_calls. This feature has an additional per-number monthly cost associated with it.

]

meta

object

total_pages integer

total_results integer

page_number integer

page_size integer

{
  "data": [
    {
      "id": "1293384261075731499",
      "record_type": "phone_number",
      "phone_number": "+19705555098",
      "country_iso_alpha2": "US",
      "status": "active",
      "external_pin": "1234",
      "connection_id": "1293384261075731499",
      "customer_reference": "customer-reference",
      "billing_group_id": "86f58db9-0fe3-4adc-9d1f-46e66e6e9323",
      "emergency_enabled": true,
      "emergency_address_id": "1315261609962112019",
      "emergency_status": "active",
      "call_forwarding_enabled": true,
      "cnam_listing_enabled": true,
      "caller_id_name_enabled": true,
      "call_recording_enabled": true,
      "t38_fax_gateway_enabled": true,
      "phone_number_type": "local",
      "inbound_call_screening": "disabled",
      "purchased_at": "2019-10-23T18:10:00.000Z",
      "created_at": "2019-10-23T18:10:00.000Z",
      "updated_at": "2019-10-24T18:10:00.000Z",
      "hd_voice_enabled": true
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

default: Unexpected error

application/json

Schema

errors

object[]

Array [

code stringrequired

title stringrequired

detail string

source

object

pointer string

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

meta

object

url string

URL with additional information on the error.

]

{
  "errors": [
    {
      "code": "10007",
      "title": "Unexpected error",
      "detail": "An unexpected error occured.",
      "source": {
        "pointer": "/base",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

Request samples

curl -L 'https://api.telnyx.com/v2/phone_numbers/slim' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

{
  "data": [
    {
      "id": "1293384261075731499",
      "record_type": "phone_number",
      "phone_number": "+19705555098",
      "country_iso_alpha2": "US",
      "status": "active",
      "external_pin": "1234",
      "connection_id": "1293384261075731499",
      "customer_reference": "customer-reference",
      "billing_group_id": "86f58db9-0fe3-4adc-9d1f-46e66e6e9323",
      "emergency_enabled": true,
      "emergency_address_id": "1315261609962112019",
      "emergency_status": "active",
      "call_forwarding_enabled": true,
      "cnam_listing_enabled": true,
      "caller_id_name_enabled": true,
      "call_recording_enabled": true,
      "t38_fax_gateway_enabled": true,
      "phone_number_type": "local",
      "inbound_call_screening": "disabled",
      "purchased_at": "2019-10-23T18:10:00.000Z",
      "created_at": "2019-10-23T18:10:00.000Z",
      "updated_at": "2019-10-24T18:10:00.000Z",
      "hd_voice_enabled": true
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

{
  "errors": [
    {
      "code": "10007",
      "title": "Unexpected error",
      "detail": "An unexpected error occured.",
      "source": {
        "pointer": "/base",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10015"
      }
    }
  ]
}

Slim List phone numbers

Request ​

Query Parameters

Responses ​

Request

Responses