---
title: "List"
method: GET
path: "/media"
tags: ["Media (Audio/Video)"]
---

# List

`GET /media`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/media`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

If you are looking for a paginated, sorted and filtered listing of your media library.

- You can pass `userId` in `params` to get data for a user. (Only for enterprise use cases)

## Query parameters

- `mediaType` string
- `page` integer
- `pageSize` integer
- `sortBy` string
- `filterMedia` integer
- `filterName` string
- `folderId` string

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `totalCount` integer
    - `pages` integer
    - `mediaList` object[]
      - `duration` object
        - `inSecond` string
        - `start` string
        - `end` string
      - `privacyMode` string
      - `processingProgress` string
      - `state` string
      - `remark` string
      - `_id` string
      - `sentiment` unknown[]
        - unknown
      - `mediaId` string
      - `name` string
      - `description` string
      - `createdAt` string, date-time
      - `thumbnailUrl` string: A signed link to the video's thumbnail, custom or automatic. Present only when the file has one. It expires, so do not store it.

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)