---
title: "Retrieve collections"
method: GET
path: "/browse/collections"
tags: ["Browse collections"]
---

# Retrieve collections

`GET /browse/collections`

Retrieve collections for end users. To get specific collection items use the `/browse/collection_id/<collection_id>` endpoint.

## Query parameters

- `key` string, required — The key of the index to use.
- `section` string — The section of the index to use. Defaults to `Products`.
- `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`.
- `sort_by` 'id' | 'display_name' — The method to sort collections by.
- `sort_order` 'ascending' | 'descending'
- `now` string, date-time — A date time representing the current moment in time when applying filtering by product age. Used to emulate "past/future" requests. Requires authentication.
- `origin_referrer` string — The url or app location where the request originated.
- `c` string — The ID of the client and version that the request is coming from, such as `cio-js-2.90`.
- `us` string[] — A customer defined context (such as `vip-club-member`) used to evaluate redirect or refined tag rules. Pass multiple segments by passing multiple `us` arguments.
- `ui` string — A customer generated anonymized identifier for a user on a customer website. It should only be sent for logged in customers and helps Constructor to tie multiple client and session IDs together to form a behavioral data profile across devices.
- `display_name` union — Filter collections by display name.
  - string
  - string[]
- `s` integer — An integer representing the users session number (starting with `1`), incremented after a 30 minute period of inactivity.
- `i` string — A globally unique identifier for the user browser (or mobile application instance) making the request.

## Response `200`

OK

- BrowseCollectionsGetResponse
  - `response` BrowseCollectionsResponse, required
    - `collections` Collection[], required — Information on browsed collections.
      - `id` string, required — The ID of the browsed collection.
      - `display_name` string — The name of the collection as you'd present it to users.
      - `data` object — Object containing custom data associated with this collection.
      - `start_time` string, date-time — The start time of the collection if it is time-bound.
      - `end_time` string, date-time — The end time of the collection if it is time-bound.
      - `active_child_collection` Collection — recursive
    - `total_num_results` integer, required — Total count of collections.

## Other responses

- `400` — Validation Error

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)