GET
/
v1
/
videos
List all videos
curl --request GET \
  --url https://api.getbluma.com/api/v1/videos \
  --header 'Authorization: Bearer <token>'
{
  "videos": [
    {
      "id": "<string>",
      "template_id": "<string>",
      "status": "queued",
      "video_url": "<string>",
      "thumbnail_url": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "total_pages": 123
  }
}

Authorizations

Authorization
string
header
required

Use your API key in the format: Bearer bluma_live_your_api_key_here

Query Parameters

page
integer
default:1

Page number

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

Items per page

Required range: 1 <= x <= 100
status
enum<string>

Filter by video status

Available options:
queued,
processing,
completed,
failed
template_id
string

Filter by template ID

from_date
string<date-time>

Filter videos created after this ISO 8601 timestamp

to_date
string<date-time>

Filter videos created before this ISO 8601 timestamp

Response

200 - application/json

List of videos retrieved successfully

videos
object[]
pagination
object