Skip to main content
GET
List assets
Returns an array of assets from your library. Supports filtering by type and status, with pagination via query parameters. Pagination metadata is returned in response headers:

Asset Types

Examples


Authorizations

x-api-key
string
header
required

API key to be included in the x-api-key header

Query Parameters

type
enum<string>[]

Filter by asset type. Can be specified multiple times (e.g. ?type=VIDEO&type=IMAGE). Omit to return all types.

Available options:
AUDIO,
IMAGE,
VIDEO
status
enum<string>
default:READY

Filter by processing status. Default: READY.

Available options:
PROCESSING,
READY,
FAILED
page
integer
default:1

Page number

Required range: x >= 1
pageSize
integer
default:20

Number of items per page

Required range: 1 <= x <= 100

Response

An array of assets. Pagination metadata is in response headers.

id
string<uuid>
name
string | null
type
enum<string>
Available options:
AUDIO,
IMAGE,
VIDEO
status
enum<string>

Processing status. Poll until READY before using as B-roll.

Available options:
PROCESSING,
READY,
FAILED
fileUrl
string | null

URL to access the asset. Null while processing.

thumbnailUrl
string | null

URL to a thumbnail image. Null while processing.

createdAt
string<date-time>