---
title: "List media library assets"
method: GET
path: "/workspace/media/assets"
tags: ["Media Library"]
---

# List media library assets

`GET /workspace/media/assets`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/media/assets`
- Auth: API key in header `Authorization`

List media library assets.

## Query parameters

- `folder_id` string
- `asset_type` 'video' | 'audio' | 'image' | 'document' | 'all'
- `search` string
- `min_duration_seconds` number
- `orientation` 'landscape' | 'portrait' | 'square'
- `aspect_ratio` '9:16' | '16:9' | '1:1' | '4:5'
- `sort_by` 'newest' | 'oldest'
- `limit` number
- `offset` number
- `cursor` string
- `include_total` boolean

## Response `200`

Successful response

- object
  - `assets` object[], required
    - `id` string, required
    - `name` string, nullable, required
    - `assetType` string, required
    - `folderId` string, nullable, required
    - `thumbnailUrl` string, nullable, required
    - `description` string, nullable, required
    - `aiDescription` string, nullable, required
    - `aiTags` string[], required
    - `aiMood` string, nullable, required
    - `aiCameraMovement` string, nullable, required
    - `importSource` string, required
    - `fileSizeBytes` number, required
    - `allowUsingAsBroll` boolean, nullable, required
    - `processingStatus` string, nullable, required
    - `audioType` string, nullable, required
    - `durationSeconds` number, nullable, required
    - `dimensionsWidth` number, nullable, required
    - `dimensionsHeight` number, nullable, required
    - `orientation` 'landscape' | 'portrait' | 'square', nullable, required
    - `createdAt` string, nullable, required
  - `items` object[], required
    - `id` string, required
    - `name` string, nullable, required
    - `assetType` string, required
    - `folderId` string, nullable, required
    - `thumbnailUrl` string, nullable, required
    - `description` string, nullable, required
    - `aiDescription` string, nullable, required
    - `aiTags` string[], required
    - `aiMood` string, nullable, required
    - `aiCameraMovement` string, nullable, required
    - `importSource` string, required
    - `fileSizeBytes` number, required
    - `allowUsingAsBroll` boolean, nullable, required
    - `processingStatus` string, nullable, required
    - `audioType` string, nullable, required
    - `durationSeconds` number, nullable, required
    - `dimensionsWidth` number, nullable, required
    - `dimensionsHeight` number, nullable, required
    - `orientation` 'landscape' | 'portrait' | 'square', nullable, required
    - `createdAt` string, nullable, required
  - `count` number, required
  - `totalCount` number, nullable, required
  - `total_count_exact` boolean, required
  - `limit` number, required
  - `offset` number, required
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)