---
title: "List all Upload requests"
method: GET
path: "/external_connections/{id}/uploads"
tags: ["External Connections"]
---

# List all Upload requests

`GET /external_connections/{id}/uploads`

Returns a list of your Upload requests for the given external connection.

## Path parameters

- `id` string, required

## Query parameters

- `filter` object
  - `status` object
    - `eq` string[] — The status of the upload 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
    - `eq` string — The phone number to filter by (exact match)
    - `contains` string — The phone number to filter by (partial match)
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response

- object
  - `data` Upload[]
    - `ticket_id` string, uuid — Uniquely identifies the resource.
    - `tenant_id` string, uuid
    - `location_id` string, uuid
    - `status` 'pending_upload' | 'pending' | 'in_progress' | 'partial_success' | 'success' | 'error' — Represents the status of the upload on Microsoft Teams.
    - `available_usages` string[]
    - `error_code` string — A code returned by Microsoft Teams if there is an error with the upload process.
    - `error_message` string — A message set if there is an error with the upload process.
    - `tn_upload_entries` TnUploadEntry[]
      - `number_id` string, uuid — Uniquely identifies the resource.
      - `phone_number` string — Phone number in E164 format.
      - `status` 'pending_upload' | 'pending' | 'in_progress' | 'success' | 'error' — Represents the status of the phone number entry upload on Microsoft Teams.
      - `error_code` 'internal_error' | 'unable_to_retrieve_default_location' | 'unknown_country_code' | 'unable_to_retrieve_location' | 'unable_to_retrieve_partner_info' | 'unable_to_match_geography_entry' — A code returned by Microsoft Teams if there is an error with the phone number entry upload.
      - `error_message` string — A message returned by Microsoft Teams if there is an error with the upload process.
      - `civic_address_id` string, uuid — Identifies the civic address assigned to the phone number entry.
      - `location_id` string, uuid — Identifies the location assigned to the phone number entry.
      - `internal_status` 'pending_assignment' | 'in_progress' | 'all_internal_jobs_completed' | 'release_requested' | 'release_completed' | 'error' — Represents the status of the phone number entry upload on Telnyx.
  - `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)