---
title: "Retrieve an Upload request"
method: GET
path: "/external_connections/{id}/uploads/{ticket_id}"
tags: ["External Connections"]
---

# Retrieve an Upload request

`GET /external_connections/{id}/uploads/{ticket_id}`

Return the details of an Upload request and its phone numbers.

## Path parameters

- `id` string, required
- `ticket_id` string, uuid, required

## 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.

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[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)