---
title: "Get media upload session status"
method: GET
path: "/media/upload-sessions/{uploadSessionId}"
tags: ["Media"]
---

# Get media upload session status

`GET /media/upload-sessions/{uploadSessionId}`

## Request

- Base URL: `https://api.woopsocial.com/v1`
- URL: `https://api.woopsocial.com/v1/media/upload-sessions/{uploadSessionId}`
- Auth: HTTP bearer

## Path parameters

- `uploadSessionId` string, required

## Response `200`

Current upload status.

- union
  - UploadSessionInitiatedStatus
    - `status` 'INITIATED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionUploadedStatus
    - `status` 'UPLOADED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionReadyStatus
    - `mediaId` string, required: Media identifier created by the completed upload.
    - `status` 'READY', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionFailedStatus
    - `failureCode` string, required: Machine-readable failure code for the upload session.
    - `failureMessage` string, required: Human-readable summary of why the upload session failed.
    - `status` 'FAILED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionAbortedStatus
    - `status` 'ABORTED', required
    - `uploadSessionId` string, required: Media upload session identifier.

## Other responses

- `429`: Too many requests are already in progress for this API key.

---

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