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

# List media

`GET /media`

## Request

- Base URL: `https://api.woopsocial.com/v1`
- URL: `https://api.woopsocial.com/v1/media`
- Auth: HTTP bearer

Returns media library items that belong to the API key's organization.

When `projectId` is provided, only media in that project is returned.

## Query parameters

- `projectId` string
- `mediaId` string[]
- `limit` integer
- `cursor` string

## Response `200`

Media items.

- ListMediaResponse
  - `media` Media[], required
    - `createdAt` string, date-time, required: UTC time when the media item was created.
    - `id` string, required: Media identifier.
    - `mediaType` 'IMAGE' | 'VIDEO', required
    - `projectId` string, required: Project identifier.
    - `url` string, uri, required: Canonical media URL.
  - `nextCursor` string: Opaque cursor for the next page of results. Omitted when there are no more results.

## 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)