---
title: "List all collections"
method: GET
path: "/collections"
tags: ["Collections"]
---

# List all collections

`GET /collections`

Retrieves all collections for a given user.

Currently, only the `favorites` collection
is supported.

## Query parameters

- `fields` string[]
- `offset` integer
- `limit` integer

## Response `200`

Returns all collections for the given user.

- Collections — The part of an API response that describes pagination.
  - `total_count` integer — One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than `total_count`. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `offset` integer — The 0-based offset of the first entry in this set. This will be the same as the `offset` query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `order` object[] — The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
    - `by` string — The field to order by.
    - `direction` 'ASC' | 'DESC' — The direction to order by, either ascending or descending.
  - `entries` Collection[] — A list of collections.
    - `id` string — The unique identifier for this collection.
    - `type` 'collection' — The value will always be `collection`.
    - `name` 'Favorites' — The name of the collection.
    - `collection_type` 'favorites' — The type of the collection. This is used to determine the proper visual treatment for collections.

## Other responses

- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)