---
title: "Get the status of a presigned upload slot."
method: GET
path: "/media/uploads/{id}"
tags: ["Media"]
---

# Get the status of a presigned upload slot.

`GET /media/uploads/{id}`

## Request

- Base URL: `https://api.reveldigital.com`
- URL: `https://api.reveldigital.com/media/uploads/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.reveldigital.com/connect/authorize`
    - Token URL: `https://id.reveldigital.com/connect/token` scopes: `webapi`
  - API key in header `X-RevelDigital-ApiKey`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/docs/media/uploads/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

Returns the slot status

- MediaUploadStatus: Status of an upload slot returned from `GET /media/uploads/{id}`.
  - `id` string, nullable: The upload slot id.
  - `status` string, nullable: The current state: `pending` (awaiting upload), `uploaded` (object present, not finalized), or `completed` (media record created).
  - `key` string, nullable: The S3 object key for this slot.
  - `created_at` string, date-time: When the slot was created (UTC).
  - `expires_at` string, date-time: When the presigned URL expires (UTC).
  - `media_id` string, nullable: The created media id once the slot has been finalized; otherwise null.

## Other responses

- `404`: If the slot does not exist, has expired, or belongs to another account

---

[API](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api.md) - [All operations](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/revisions/39d5c8302822?raw)