---
title: "Retrieve a knowledge store item collection"
method: GET
path: "/knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}"
tags: ["knowledgeStoreItemCollections"]
---

# Retrieve a knowledge store item collection

`GET /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}`

## Request

- Base URL: `https://api.twelvelabs.io/v1.3`
- URL: `https://api.twelvelabs.io/v1.3/knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}`
- Auth: API key in header `x-api-key`

Retrieves the details of a specific item collection.

## Path parameters

- `knowledge_store_id` string, required
- `collection_id` string, required

## Response `200`

The item collection has been successfully retrieved.

- KnowledgeStoreItemCollection: A named collection of items within a knowledge store. Use item collections to organize and reference subsets of items together. The items themselves are not affected.
  - `_id` string: The unique identifier of the item collection.
  - `knowledge_store_id` string: The unique identifier of the knowledge store this collection belongs to.
  - `name` string: The name of the item collection.
  - `description` string: The description of the item collection.
  - `metadata` object: Custom metadata for the item collection. Keys are strings; each value is a string, a number, a boolean, or an array of strings.
  - `member_count` integer: The number of items in the collection.
  - `created_at` string, date-time: The date and time when the item collection was created, in the RFC 3339 format.
  - `updated_at` string, date-time: The date and time when the item collection was last updated, in the RFC 3339 format.

## Other responses

- `400`: The request has failed.

## Changes

- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `retrieve` removed and replaced with `knowledgeStoreItemCollections_retrieve`
- **2026-09-02** `335e364dd9b5`: 1 breaking
  - response property `metadata/additionalProperties/` list-of-types was widened by adding types `array, boolean, integer and number` to media type `application/json` of response `200`
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/knowledge-stores/:knowledge_store_id/item-collections/:collection_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.dev/twelvelabs/apis/twelvelabs-api/revisions/c23c6e18fdd1?raw)