Skip to main content
GET
/
collections
/
{collection_id}
cURL
curl --request GET \
  --url https://api.box.com/2.0/collections/{collection_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "11446498",
  "type": "collection",
  "name": "Favorites",
  "collection_type": "favorites"
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
collection_id
string
required

The ID of the collection.

Response

Returns an array of items in the 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.

​
id
string

The unique identifier for this collection.

Example:

"11446498"

​
type
enum<string>

The value will always be collection.

Available options:
collection
Example:

"collection"

​
name
enum<string>

The name of the collection.

Available options:
Favorites
Example:

"Favorites"

​
collection_type
enum<string>

The type of the collection. This is used to determine the proper visual treatment for collections.

Available options:
favorites
Example:

"favorites"