---
title: "List all Releases"
method: GET
path: "/external_connections/{id}/releases"
tags: ["External Connections"]
---

# List all Releases

`GET /external_connections/{id}/releases`

Returns a list of your Releases for the given external connection. These are automatically created when you change the `connection_id` of a phone number that is currently on Microsoft Teams.

## Path parameters

- `id` string, required

## Query parameters

- `filter` object
  - `status` object
    - `eq` string[] — The status of the release to filter by
  - `civic_address_id` object
    - `eq` string — The civic address ID to filter by
  - `location_id` object
    - `eq` string — The location ID to filter by
  - `phone_number` object — Phone number filter operations. Use 'eq' for exact matches or 'contains' for partial matches.
    - `eq` string — The phone number to filter by
    - `contains` string — The partial phone number to filter by. Requires 3-15 digits.
- `page` object
  - `size` integer — The size of the page
  - `number` integer — The page number to load

## Response `200`

Successful response

- object
  - `data` Release[]
    - `ticket_id` string, uuid — Uniquely identifies the resource.
    - `tenant_id` string, uuid
    - `status` 'pending_upload' | 'pending' | 'in_progress' | 'complete' | 'failed' | 'expired' | 'unknown' — Represents the status of the release on Microsoft Teams.
    - `error_message` string — A message set if there is an error with the upload process.
    - `telephone_numbers` TnReleaseEntry[]
      - `phone_number` string — Phone number in E164 format.
      - `number_id` string — Phone number ID from the Telnyx API.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
  - `meta` ExternalVoiceIntegrationsPaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

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

---

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