---
title: "Retrieve a video indexing task"
method: GET
path: "/tasks/{task_id}"
tags: ["tasks"]
---

# Retrieve a video indexing task

`GET /tasks/{task_id}`

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

This method retrieves a video indexing task.

## Path parameters

- `task_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

The specified video indexing task has successfully been retrieved.

- TasksRetrieveResponse200 — A video indexing task that describes the status of the task and the metadata about the video.
  - `_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` TasksTaskIdGetResponsesContentApplicationJsonSchemaSystemMetadata — System-generated metadata about the video.
    - `duration` number, double
    - `filename` string
    - `height` integer
    - `width` integer
  - `hls` HLSObject — The platform returns this object only for the videos that you uploaded with the `enable_video_stream` parameter set to `true`.
    - `video_url` string — A string representing the URL of the video. You can then use this URL to access the stream over the <a href="https://en.wikipedia.org/wiki/HTTP_Live_Streaming" target="_blank">HLS</a> protocol.
    - `thumbnail_urls` string[] — An array containing the URL of the thumbnail.
    - `status` 'PROCESSING' | 'COMPLETE' | 'CANCELED' | 'ERROR' — A string representing the encoding status of the video file from its original format to a streamable format. **Values**: - `PROCESSING`: Video is currently being encoded and is not yet ready for streaming - `COMPLETE`: Encoding has successfully finished and the video is ready for streaming - `CANCELED`: Encoding was manually canceled before completion - `ERROR`: An error occurred during the encoding process
    - `updated_at` string — A string indicating the date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the encoding status was last updated.

## Other responses

- `400` — The request has failed.

## Changes

> 8 revisions in range; 4 could not be searched.

- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/tasks/:task_id/get.md)

---

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