---
title: "Retrieve media upload status"
method: GET
path: "/v1/media/{mediaId}"
tags: ["Media"]
---

# Retrieve media upload status

`GET /v1/media/{mediaId}`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/v1/media/{mediaId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

Retrieves the status of a media upload to Hootsuite.

## Path parameters

- `mediaId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- MediaDownloadUrlResponseEnvelope: The response data wrapper for a Media Download Url.
  - `data` MediaDownloadUrl
    - `id` string: The media identifier.
    - `state` 'READY' | 'QUEUED': The state of the uploaded media. This is used to determine whether the media has been processed by Hootsuite and is ready to attach to a message.
    - `downloadUrl` string: An S3 URL to download the media from Hootsuite. This is only available after the media has been processed
    - `downloadUrlDurationSeconds` integer: The number of seconds until the download url is no longer valid. This is only available after the media has been processed

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api.md) - [All operations](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/revisions/adac53bd28bb?raw)