Docs
REST APIVideosList videos GET

List videos

Returns a paginated list of videos in your organization, sorted by creation date (newest first).

GET
/v1/videos

Authorization

BearerAuth
AuthorizationBearer <token>

Pass the raw API key as a Bearer token (Authorization: Bearer <key>). Publishable keys start with mvi_pub_ (playback-scoped). Other prefixes denote private/admin keys for general REST routes. GET /v1/embeds/{embedId}/playback accepts publishable keys only.

In: header

Query Parameters

cursor?string

Opaque cursor from a previous response pageInfo.nextCursor. Omit for the first page.

limit?integer

Number of videos to return per page.

Default24
Range1 <= value <= 100
search?string

Filter by title (case-insensitive contains).

collectionId?string

Filter by collection.

Formatuuid
referenceId?string

Filter by your external reference id.

status?string

Comma-separated list of statuses. E.g. ready,processing.

visibility?string

Comma-separated visibility values: public, unlisted, private.

resolution?string

Comma-separated resolutions to include. E.g. 1080p,720p.

speechPresence?string

Comma-separated speech-detection results: speech_present, no_audio, non_speech_audio, unknown.

aiContent?string

Comma-separated AI content the video must have (matches videos that have any of the listed): captions, chapters, summary, quiz, mindmap, ebook.

createdFrom?string

Only videos created on or after this date (ISO 8601, e.g. 2024-01-01).

createdTo?string

Only videos created on or before this date (ISO 8601).

framerateMin?|

Minimum framerate (fps).

framerateMax?|

Maximum framerate (fps).

durationMin?|

Minimum duration in milliseconds.

durationMax?|

Maximum duration in milliseconds.

storageSizeMin?|

Minimum stored size in bytes.

storageSizeMax?|

Maximum stored size in bytes.

Response Body

application/json

application/json

curl -X GET "https://api.moviie.ai/v1/videos"
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "external_id": "bun-abc123",
      "title": "Product overview.mp4",
      "status": "ready",
      "duration_ms": 120000,
      "width": 1920,
      "height": 1080,
      "framerate": 30,
      "available_resolutions": "240p,360p,480p,720p,1080p",
      "thumbnail_blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
      "thumbnail_file_name": "thumbnail.jpg",
      "storage_size": "52428800",
      "created_at": "2024-01-15T12:00:00.000Z",
      "updated_at": "2024-01-15T12:00:00.000Z",
      "collection": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Product demos",
        "color": "sky",
        "isDefault": true
      }
    }
  ],
  "pageInfo": {
    "nextCursor": "string",
    "hasMore": true
  }
}
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}