Skip to main content
GET
/
collections
/
{collection_id}
cURL
curl -i -X GET "https://api.box.com/2.0/collections/926489" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
{
  "id": "11446498",
  "type": "collection",
  "name": "Favorites",
  "collection_type": "favorites"
}

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.

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"