---
title: "List indexes"
method: GET
path: "/indexes"
tags: ["indexes"]
---

# List indexes

`GET /indexes`

This method returns a list of the indexes in your account. The platform returns indexes sorted by creation date, with the oldest indexes at the top of the list.

## Query parameters

- `page` integer
- `page_limit` integer
- `sort_by` string
- `sort_option` string
- `index_name` string
- `model_options` string
- `model_family` string
- `created_at` string
- `updated_at` string

## Headers

- `x-api-key` string, required

## Response `200`

The indexes have successfully been retrieved.

- IndexesListResponse200
  - `data` Index[] — An array that contains up to `page_limit` indexes.
    - `_id` string — A string representing the unique identifier of the index. It is assigned by the platform when an index is created.
    - `created_at` string — A string representing the date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the index was created.
    - `updated_at` string — A string representing the date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), that the index has been updated.
    - `expires_at` string — A string representing the date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when your index will expire. If you're on the Free plan, the platform retains your index data for 90 days from creation. After this period, the platform deletes your index data, and this action cannot be undone. To continue using your index beyond this period, consider upgrading to the Developer plan, which offers unlimited index retention. For details, see the [Upgrade your plan](/v1.3/docs/get-started/manage-your-plan#upgrade-your-plan) section. If you're on the Developer plan, this field is set to `null`, indicating no expiration.
    - `index_name` string — A string representing the name of the index.
    - `total_duration` number, double — A number representing the total duration, in seconds, of the videos in the index.
    - `video_count` number, double — The number of videos uploaded to this index.
    - `models` IndexModelsItems[] — An array containing the list of the [video understanding models](/v1.3/docs/concepts/models) enabled for this index.
      - `model_name` string — A string representing the name of the model.
      - `model_options` string[] — An array of strings that contains the [model options](/v1.3/docs/concepts/modalities#model-options) enabled for this index.
    - `addons` string[] — The list of the add-ons that are enabled for this index.
  - `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/9c12cd88093a/schema)