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

# List all videos

`GET /v1/videos`

Returns a paginated list of all videos for the authenticated user. Use playlistId query parameter to filter videos by playlist.

## Query parameters

- `cursor` string — Pagination cursor from previous response
- `limit` integer — Items per page (default: 20, max: 100)
- `playlistId` string — Filter videos by playlist ID
- `tagIds` string — Filter videos by tag IDs, comma-separated. Multiple tags are combined with AND. Ignored when playlistId is set.

## Response `200`

OK

- object
  - `pagination` Pagination, required — Pagination metadata for list responses. Results are sorted by updatedAt descending.
    - `hasMore` boolean, required — Whether there are more items to fetch
    - `nextCursor` string, nullable, required — Cursor for next page. Pass this value as the 'cursor' query parameter to fetch the next page. Null if no more pages. This is an opaque value - do not decode or modify it.
  - `videos` VideoListItem[], required — List of videos
    - `aspectRatio` string, required — Video aspect ratio (e.g., '16:9', '9:16')
    - `createdAt` string, date-time, required — ISO 8601 datetime
    - `description` string, required — Video description
    - `dimensions` object, required — Canvas size in pixels
      - `height` number, required
      - `width` number, required
    - `id` string, required — Unique video identifier
    - `links` VideoLinks, required — URLs related to a video
      - `embedPage` string, uri, required — URL for embedding the video
      - `viewPage` string, uri, required — URL to view the video on Tella
    - `name` string, required — Video title
    - `updatedAt` string, date-time, required — ISO 8601 datetime
    - `views` integer, required — Total view count

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withchima/tella-public-api/revisions/ba2bb13928a5/schema)