---
title: "List video indexing tasks"
method: GET
path: "/tasks"
tags: ["tasks"]
---

# List video indexing tasks

`GET /tasks`

<Info>This method will be removed in a future version.</Info>

This method returns a list of the video indexing tasks in your account. The platform returns your video indexing tasks sorted by creation date, with the newest at the top of the list.

## Query parameters

- `page` integer
- `page_limit` integer
- `sort_by` string
- `sort_option` string
- `index_id` string
- `status` TasksGetParametersStatusSchemaItems[]
- `filename` string
- `duration` number, double
- `width` integer
- `height` integer
- `created_at` string
- `updated_at` string

## Headers

- `x-api-key` string, required

## Response `200`

The video indexing tasks have successfully been retrieved.

- TasksListResponse200
  - `data` VideoIndexingTask[] — An array that contains up to `page_limit` tasks.
    - `_id` string — A string representing the unique identifier of the task. It is assigned by the platform when a new task is created.
    - `video_id` string — A string representing the unique identifier of the video associated with the specified video indexing task.
    - `created_at` string — A string indicating the date and time, in the RFC RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the 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 task object was last updated. The platform updates this field every time the video indexing task transitions to a different state.
    - `status` string — A string indicating the status of the video indexing task. See the [Task object](/v1.3/api-reference/upload-content/tasks/the-task-object) page for a list of possible statuses.
    - `index_id` string — A string representing the unique identifier of the index to which the video must be uploaded.
    - `system_metadata` VideoIndexingTaskSystemMetadata — System-generated metadata about the video.
      - `duration` number, double
      - `filename` string
      - `height` integer
      - `width` integer
  - `page_info` TasksGetResponsesContentApplicationJsonSchemaPageInfo — 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)