---
title: "List media files"
method: GET
path: "/v1/media_files"
---

# List media files

`GET /v1/media_files`

## Request

- Base URL: `https://api.clipflow.co`
- URL: `https://api.clipflow.co/v1/media_files`
- Auth: OAuth 2
  - Authorization code: `https://app.clipflow.co/oauth/authorize`
  - Token URL: `https://app.clipflow.co/oauth/token` scopes: `media_files.read`

## Query parameters

- `after` string
- `limit` integer
- `expand` string
- `media_status` 'declined' | 'pending' | 'changes_required' | 'reviewed' | 'approved' | 'unused'
- `media_type` 'edited_video' | 'final_video' | 'raw_video' | 'sample_video'
- `organization_id` string
- `title` string
- `user_id` string

## Response `200`

Success

## Other responses

- `401`: Missing or invalid token
- `403`: Token lacks the required scope
- `404`: Not found

---

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