---
title: "List entity collections"
method: GET
path: "/entity-collections"
tags: ["entityCollections"]
---

# List entity collections

`GET /entity-collections`

This method returns a list of the entity collections in your account.

## Query parameters

- `page` integer
- `page_limit` integer
- `name` string
- `sort_by` 'created_at' | 'updated_at' | 'name'
- `sort_option` string

## Headers

- `x-api-key` string, required

## Response `200`

The entity collections have been successfully retrieved.

- EntityCollectionsListResponse200
  - `data` EntityCollection[] — An array containing the entity collections.
    - `_id` string — The unique identifier of the entity collection.
    - `name` string — The name of the entity collection.
    - `description` string — The description of the entity collection.
    - `created_at` string, date-time — The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity collection was created.
    - `updated_at` string, date-time — The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity collection was last updated.
  - `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.

## Changes

- **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/entity-collections/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)