---
title: "List Videos in Folder"
method: GET
path: "/serve/api/v1/folders/videos"
---

# List Videos in Folder

`GET /serve/api/v1/folders/videos`

## Query parameters

- `folder_id` integer, required
- `page` integer
- `page_size` integer

## Response `200`

Successful response

- ListVideosResponse
  - `code` string
  - `msg` string
  - `data` object
    - `current_page` integer
    - `page_size` integer
    - `total_count` integer
    - `videos` object[]
      - `video_no` string
      - `video_name` string
      - `duration` integer — Video duration in seconds.
      - `size` integer — File size in bytes.
      - `create_time` integer — Upload time in ms since epoch.
      - `status` 'PARSE' | 'UNPARSE' | 'FAILED'
      - `cause` string — Failure reason — only present when status=FAILED.
      - `video_url` string — Download URL — only present when available.
      - `datetime_taken` integer — Capture timestamp (ms since epoch). Only present when available.
      - `camera_model` string — Camera/device model. Only present when available.
      - `latitude` number, double — Decimal latitude. Only present when available.
      - `longitude` number, double — Decimal longitude. Only present when available.
      - `tags` string[] — User-defined tags. Only present when non-empty.
      - `bucket` string — GCS bucket of the original video file. Omitted when the storage location cannot be resolved.
      - `blob` string — GCS blob path of the video file. Use with bucket at GET /serve/api/v2/download to fetch the file directly.
  - `success` boolean
  - `failed` boolean

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/revisions/720c8c144ddc/schema)