---
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.

---

[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/5dbd6e8473c9/schema)