---
title: "List video embedding tasks"
method: GET
path: "/embed/tasks"
tags: ["embed > tasks"]
---

# List video embedding tasks

`GET /embed/tasks`

<Note title="Note">
  This method will be deprecated in a future version. Migrate to the [Embed API v2](/v1.3/api-reference/create-embeddings-v2) for continued support and access to new features.
</Note>
This method returns a list of the video embedding tasks in your account. The platform returns your video embedding tasks sorted by creation date, with the newest at the top of the list.

<Note title="Notes">
- Video embeddings are stored for seven days.
- When you invoke this method without specifying the `started_at` and `ended_at` parameters, the platform returns all the video embedding tasks created within the last seven days.
</Note>

## Query parameters

- `started_at` string
- `ended_at` string
- `status` string
- `page` integer
- `page_limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

A list of async embedding tasks has successfully been retrieved.

- EmbedTasksListResponse200
  - `data` MediaEmbeddingTask[] — An array that contains up to `page_limit` embedding tasks.
    - `_id` string — The unique identifier of the embedding task.
    - `model_name` string — The name of the video understanding model the platform used to create the embedding.
    - `status` string — A string indicating the status of the emedding task. It can take one of the following values: `processing`, `ready` or `failed`.
    - `created_at` string, date-time — A string representing the date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the resource was created.
    - `updated_at` string, date-time — A string representing the date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the resource was last updated.
    - `video_embedding` MediaEmbeddingTaskVideoEmbedding — An object containing the metadata associated with the embedding.
      - `metadata` VideoEmbeddingMetadata — An object containing metadata associated with the embedding.
        - `input_url` string — The URL of the media file used to generate the embedding. Present if a URL was provided in the request.
        - `input_filename` string — The name of the media file used to generate the embedding. Present if a file was provided in the request.
        - `video_clip_length` number, double — The duration for each clip in seconds, as specified in the request. Note that the platform automatically truncates video segments shorter than 2 seconds. For a 31-second video divided into 6-second segments, the final 1-second segment will be truncated. This truncation only applies to the last segment if it does not meet the minimum length requirement of 2 seconds.
        - `video_embedding_scope` string[] — The scope you've specified in the request.
        - `duration` number, double — The total duration of the video in seconds.
    - `audio_embedding` MediaEmbeddingTaskAudioEmbedding — An object containing the metadata associated with the embedding.
      - `metadata` AudioEmbeddingMetadata — An object containing metadata associated with the embedding.
        - `input_url` string — The URL of the media file used to generate the embedding. Present if a URL was provided in the request.
        - `input_filename` string — The name of the media file used to generate the embedding. Present if a file was provided in the request.
        - `audio_embedding_options` string[] — The type of the embedding. It can take one of the following values: ['audio'] or ['transcription'].
        - `audio_embedding_scopes` string[] — The scope you've specified in the request.
        - `duration` number, double — The total duration of the audio in seconds.
        - `start_offset_sec` number, double — The start offset in seconds from the beginning of the audio where processing should begin.
        - `end_offset_sec` number, double — The end offset in seconds from the beginning of the audio where processing should end.
  - `page_info` EmbedTasksGetResponsesContentApplicationJsonSchemaPageInfo — 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)