---
title: "Get upload metadata and processing status"
method: GET
path: "/v1/uploads/{upload_id}"
---

# Get upload metadata and processing status

`GET /v1/uploads/{upload_id}`

## Request

- Base URL: `https://api.uploadcheck.app`
- URL: `https://api.uploadcheck.app/v1/uploads/{upload_id}`
- Auth: HTTP bearer

Returns upload status. Stored workspace API keys can only read upload reservations owned by their own workspace.

## Path parameters

- `upload_id` string, required

## Response `200`

Upload status

- Upload
  - `uploadId` string
  - `filename` string
  - `contentType` string
  - `sizeBytes` integer
  - `workspaceId` string, nullable: Workspace that owns this upload reservation. Stored workspace API keys are pinned to this value.
  - `ownerEmail` string, nullable
  - `apiKeyId` string, nullable
  - `status` 'created' | 'uploaded'
  - `signedPutUrl` string
  - `expiresAt` string, date-time
  - `storageMode` 'render_temp_storage' | 'durable_filesystem' | 'object_storage'
  - `objectKey` string, nullable
  - `objectUrl` string, nullable

## Other responses

- `404`: Upload not found

---

[API](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api.md) · [All operations](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api/revisions/d7c8a14caa30?raw)