---
title: "List videos"
method: GET
path: "/indexes/{index-id}/videos"
tags: ["indexes > videos"]
---

# List videos

`GET /indexes/{index-id}/videos`

<Info>This method will be deprecated in a future version. New implementations should use the [List indexed assets](/v1.3/api-reference/index-content/list) method.</Info>

This method returns a list of the videos in the specified index. By default, the platform returns your videos sorted by creation date, with the newest at the top of the list.

## Path parameters

- `index-id` string, required

## Query parameters

- `page` integer
- `page_limit` integer
- `sort_by` string
- `sort_option` string
- `filename` string
- `duration` IndexesIndexIdVideosGetParametersDuration
  - `gte` number, double
  - `lte` number, double
- `fps` IndexesIndexIdVideosGetParametersFps
  - `gte` number, double
  - `lte` number, double
- `width` IndexesIndexIdVideosGetParametersWidth
  - `gte` integer
  - `lte` integer
- `height` IndexesIndexIdVideosGetParametersHeight
  - `gte` integer
  - `lte` integer
- `size` IndexesIndexIdVideosGetParametersSize
  - `gte` number, double
  - `lte` number, double
- `created_at` string
- `updated_at` string
- `user_metadata` object

## Headers

- `x-api-key` string, required

## Response `200`

The video vectors in the specified index have successfully been retrieved.

- IndexesVideosListResponse200
  - `data` VideoVector[] — An array that contains up to `page_limit` videos.
    - `_id` string — A string representing the unique identifier of a video. The platform creates a new `video_vector` object and assigns it a unique identifier when the video has successfully been indexed. Note that video IDs are different from task IDs.
    - `asset_id` string — The unique identifier of the associated asset.
    - `created_at` string — A string indicating the date and time, in the RFC RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the video indexing task was created.
    - `updated_at` string — A string indicating the date and time, in the RFC RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the video indexing task object was last updated. The platform updates this field every time the video indexing task transitions to a different state.
    - `indexed_at` string — A string indicating the date and time, in the RFC RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the video indexing task has been completed.
    - `system_metadata` VideoVectorSystemMetadata — System-generated metadata about the video.
      - `filename` string
      - `duration` number, double
      - `fps` number, double
      - `width` integer
      - `height` integer
      - `size` number, double
  - `page_info` PageInfo — An object that provides information about pagination.
    - `limit_per_page` integer — The maximum number of items on each page.
    - `page` integer — The page you retrieved.
    - `total_page` integer — The total number of pages.
    - `total_results` integer — The total number of results.

## Other responses

- `400` — The request has failed.

---

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