---
title: "List media uploads"
method: GET
path: "/media"
tags: ["media"]
---

# List media uploads

`GET /media`

List media uploads filtered by given parameters.

<strong><a href='/docs/content/content-creation/#Creating%20video%20Pins'>Learn more</a></strong> about video Pin creation.

## Query parameters

- `bookmark` string
- `page_size` integer

## Response `200`

response

- object
  - `items` object[], required — Media
    - `media_id` string
    - `media_type` 'video'
    - `status` 'registered' | 'processing' | 'succeeded' | 'failed' — Media upload status
  - `bookmark` string, nullable

## Other responses

- `default` — Unexpected error

## Changes

- **2022-11-14** (v5) `e041d7b0cef0` — 1 info
  - for the `query` request parameter `page_size`, the max was increased from `100.00` to `250.00`
- **2022-04-12** (v5) `723c51158044` — 1 warning, 1 info
  - removed the optional property `allOf[subschema #2]/items/items/signature` from the response with the `200` status
  - the `allOf[subschema #2]/items/items/media_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
- **2022-04-08** (v5) `33ec8e7421c7` — 2 info
  - added the optional property `allOf[subschema #2]/items/items/signature` to the response with the `200` status
  - the `allOf[subschema #2]/items/items/media_id` response's property pattern was changed from `^\d+$` to `\d+` for the status `200`
- **2022-02-09** (v5) `46313d040316` — 1 warning, 1 info
  - removed the optional property `allOf[subschema #2]/items/items/signature` from the response with the `200` status
  - the `allOf[subschema #2]/items/items/media_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
- **2022-01-07** (v5) `59a2e4171755` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/media/get.md)

---

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