---
title: "List all phone numbers"
method: GET
path: "/external_connections/{id}/phone_numbers"
tags: ["External Connections"]
---

# List all phone numbers

`GET /external_connections/{id}/phone_numbers`

Returns a list of all active phone numbers associated with the given external connection.

## Path parameters

- `id` string, required

## Query parameters

- `filter` object
  - `phone_number` object
    - `eq` string — The phone number to filter by (exact match)
    - `contains` string — The phone number to filter by (partial match)
  - `civic_address_id` object
    - `eq` string — The civic address ID to filter by
  - `location_id` object
    - `eq` string — The location ID to filter by
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response

- object
  - `data` ExternalConnectionPhoneNumber[]
    - `ticket_id` string, uuid — Uniquely identifies the resource.
    - `telephone_number` string — Phone number in E164 format.
    - `number_id` string — Phone number ID from the Telnyx API.
    - `civic_address_id` string, uuid — Identifies the civic address assigned to the phone number.
    - `location_id` string, uuid — Identifies the location assigned to the phone number.
    - `displayed_country_code` string — The iso country code that will be displayed to the user when they receive a call from this phone number.
    - `acquired_capabilities` string[]
  - `meta` ExternalVoiceIntegrationsPaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `401` — Unauthorized
- `404` — Not found
- `422` — Bad request

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)