> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collections resources

Collections are a way to group files, folders, and web links without putting them all into a folder.

## Collection

A collection of items, including files and folders. Currently, the only collection available is the `favorites` collection. The contents of a collection can be explored in a similar way to which the contents of a folder is explored.

<Accordion title="Attributes and example">
  | Property          | Type           | Required | Description                                                                                                                        |
  | ----------------- | -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
  | `id`              | `string`       | No       | The unique identifier for this collection.                                                                                         |
  | `type`            | `enum<string>` | No       | The value will always be `collection`. Available options: `collection`.                                                            |
  | `name`            | `enum<string>` | No       | The name of the collection. Available options: `Favorites`.                                                                        |
  | `collection_type` | `enum<string>` | No       | The type of the collection. This is used to determine the proper visual treatment for collections. Available options: `favorites`. |

  ```json Example theme={null}
  {
    "id": "11446498",
    "type": "collection",
    "name": "Favorites",
    "collection_type": "favorites"
  }
  ```
</Accordion>

## Collections

A list of collections.

<Accordion title="Attributes and example">
  | Property      | Type                               | Required | Description                                                                                                                                                                                                                                                                                |
  | ------------- | ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `total_count` | `integer`                          | No       | 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`                          | No       | 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`                          | No       | 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`       | array of `object`                  | No       | 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.                                                                                                                |
  | `entries`     | array of [Collection](#collection) | No       | A list of collections.                                                                                                                                                                                                                                                                     |

  ```json Example theme={null}
  {
    "total_count": 5000,
    "limit": 1000,
    "offset": 2000,
    "order": [
      {
        "by": "type",
        "direction": "ASC"
      }
    ],
    "entries": [
      {
        "id": "11446498",
        "type": "collection",
        "name": "Favorites",
        "collection_type": "favorites"
      }
    ]
  }
  ```
</Accordion>