---
title: "Retrieve an upload"
method: GET
path: "/v1/utilities/uploads/{upload_id}"
tags: ["Media"]
---

# Retrieve an upload

`GET /v1/utilities/uploads/{upload_id}`

Retrieve metadata for a previously created upload by its ID.

## Path parameters

- `upload_id` string, required

## Response `200`

Upload metadata

- UploadResponse
  - `upload_id` string
  - `provider` string
  - `file_name` string
  - `mime_type` string
  - `file_size_bytes` integer
  - `url` string, nullable
  - `linked_resource_type` string, nullable — Resource type this upload is attached to, e.g. `product`.
  - `linked_resource_id` string, nullable — ID of the resource this upload is attached to.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized - Invalid, missing, or expired API key. Verify your API key is correctly formatted and included in the Authorization header as `Bearer sk_sandbox_...` or `Bearer sk_live_...`. Check that your key hasn't been revoked.
- `404` — Not Found - The requested resource does not exist. Verify the resource ID is correct and that it belongs to your organization.

---

[API](https://skmtc.dev/bachs/apis/bachs-api.md) · [All operations](https://skmtc.dev/bachs/apis/bachs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bachs/bachs-api/revisions/f29efa8a22df/schema)