---
title: "Retrieve collection items"
method: GET
path: "/v1/collections/{collection_id}/items"
tags: ["Collections"]
---

# Retrieve collection items

`GET /v1/collections/{collection_id}/items`

## Request

- Base URL: `https://ac.cnstrc.com`
- URL: `https://ac.cnstrc.com/v1/collections/{collection_id}/items`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

**🔐 This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).**
For authenticating with Bearer token, required scopes are: `collections(r)`.

Retrieve all items of a collection, optionally filtered by `type`, i.e. method  of addition to the collection.

## Path parameters

- `collection_id` string, required

## Query parameters

- `key` string, required: The key of the index to use.
- `section` string: The section of the index to use. Defaults to `Products`.
- `filters` CollectionItemFilters
  - `manual_items` boolean: Specifies whether to include manually added items in the response.
  - `dynamic_items` boolean: Specifies whether to include dynamic items (matching collection.filter_expression) in the response.
  - `unindexed_items` boolean: Specifies whether to include unindexed collection items. Supported only for manual items, hence mutually exclusive with `dynamic_items` filter
- `num_results_per_page` integer: The number of results per page to return.
- `page` integer: The page of results to return.
- `offset` integer: The number of results to skip from the beginning. Cannot be used together with `page`.
- `c` string: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Response `200`

OK

- CollectionItemListGetResponse
  - `items` CollectionItemResponse[], required
    - `id` string, required: The ID of the item, added to the collection.
    - `source` string: Arbitrary identifier of the source of the item manually added to the collection.
    - `variation_ids` string[]: List of variation IDs to include in this collection for the item. If not provided, all variations of the item are included.
    - `created_at` string, date-time: Collection Item creation date in ISO 8601 format. Present only for manually added items.
    - `updated_at` string, date-time: Collection Item update date in ISO 8601 format. Present only for manually added items.
    - `type` 'manual' | 'dynamic'
  - `total_count` integer, required

## Other responses

- `400`: Validation Error
- `401`: Credentials are not passed or action is forbidden.
- `403`: The supplied token does not have the required permissions.
- `404`: Not Found
- `429`: Rate limit breached

---

[API](https://skmtc.dev/constructor/apis/configuration.md) - [All operations](https://skmtc.dev/constructor/apis/configuration/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/configuration/revisions/205ffdb5f494?raw)