---
title: "Get videos list"
method: GET
path: "/api/videos"
tags: ["videos"]
---

# Get videos list

`GET /api/videos`

Get list of videos. Returns first 10 by default. Supports filtering by type (include/exclude).

## Query parameters

- `search` string, nullable — Search term to filter videos by title or description
- `type` string, nullable — Filter videos by single type/category (use types for multiple)
- `types` string[], nullable — Filter videos by multiple types (OR logic). Example: ?types=educational&types=tutorial
- `exclude_types` string[], nullable — Exclude videos by types. Example: ?exclude_types=family_course
- `limit` integer — Maximum number of results to return (default: 10)
- `cursor` string, nullable — Cursor for the next page.

## Response `200`

Successful Response

- VideosListResponse — Videos list response model.
  - `videos` VideoResponse[], required — List of videos
    - `id` integer, required — Video ID
    - `created_at` string, required — Creation timestamp
    - `youtube_url` string, nullable — YouTube URL
    - `title` string, required — Video title
    - `description` string, required — Video description
    - `type` string, nullable — Video type/category
    - `video_id` string, nullable — Video identifier
    - `thumbnail` string, nullable — Base64 encoded video thumbnail
    - `badge_name` string, nullable — Badge name to display for this video in app/website
    - `is_locked` boolean — Whether the video is visible but not playable
    - `locked_message` string, nullable — Reason shown when the video is locked
    - `cta_url` string, nullable — CTA URL/path shown when the video is locked
    - `cta_label` string, nullable — CTA label shown when the video is locked
  - `total` integer, required — Total number of videos
  - `next_cursor` string, nullable — Cursor for the next page.
  - `has_more` boolean — Whether there are more results after this page

## Other responses

- `422` — Validation Error

---

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