---
title: "List videos"
method: GET
path: "/videos"
tags: ["Videos"]
---

# List videos

`GET /videos`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/videos`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

List videos across your brands, newest first.

## Query parameters

- `brandSessionId` string, uuid: Only this brand.
- `workspaceId` string: Only this workspace.
- `source` 'uploaded' | 'scraped' | 'generated': Only files from this source.
- `inLibrary` 'true' | 'false': Only files in (true) or not in (false) the Library.
- `limit` integer: Results per page (1–100, default 50)
- `cursor` string: Pagination cursor from a previous response's nextCursor

## Response `200`

OK

- object
  - `data` object, required
    - `items` object[], required
      - `id` string, uuid, required: Media ID.
      - `type` string, required: Media family: image, video, or audio. More values may be added.
      - `source` string, required: How the file entered Rainbrand: uploaded, scraped (collected from a brand source), or generated. More values may be added.
      - `brandSessionId` string, uuid, required: Brand that owns the file.
      - `workspaceId` string, nullable, required: Workspace that owns the brand. Null for a personal workspace.
      - `mimeType` string, required: The file's MIME type.
      - `url` string, uri, required: Stable link to the file. Stops working when the file is deleted.
      - `fileSize` integer, required: Size in bytes.
      - `durationMs` integer, nullable, required: Duration in milliseconds, when known.
      - `width` integer, nullable, required: Width in pixels, when known.
      - `height` integer, nullable, required: Height in pixels, when known.
      - `description` string, nullable, required: Description of the file's contents, when Rainbrand has one.
      - `inLibrary` boolean, required: Whether the file is in its brand's Library.
      - `addedToLibraryAt` string, date-time, nullable, required: When the file was added to the Library, or null.
      - `generationId` string, uuid, nullable, required: Generation that produced the file, or null.
      - `createdAt` string, date-time, required: When the file was stored.
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: 401
- `403`: 403
- `429`: 429

---

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