Add the power of the Box AI API to your custom apps at Content Cloud Summit on May 15

Learn more and register!

List User's Collections

Guides Collections List User's Collections
Edit this page

List User's Collections

To list all collections for a user, call the GET /collections API.

curl -i -X GET "" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
BoxCollection<BoxCollectionItem> collections = await client.CollectionsManager.GetCollectionsAsync();
Iterable<BoxCollection.Info> collections = BoxCollection.getAllCollections(api);
for (BoxCollection.Info collectionInfo : collections) {
	// Do something with the collection.
collections = client.collections()
for collection in collections:
    print(f'Collection "{}" has ID {}')
	.then(collections => {
		/* collections -> { total_count: 1,
			[ { type: 'collection',
				id: '11111',
				name: 'Favorites',
				collection_type: 'favorites' } ],
			limit: 100,
			offset: 0 }
TypeScript (Beta)
await client.collections.getCollections();
Python (Beta)
.NET (Beta)
await client.Collections.GetCollectionsAsync();

The only collection that is available via the API is the "Favorites" collection. The ID of this collection is different for every user.

Favorites Collection

The only collection that can items can currently be added and removed to via the API is the "Favorites" collection.

The ID of the favorites collection is different for every user. To find the user's collection ID for their favorites, list all the user's collections and then find the collection with a collection_type of favorites.

  "entries": [
      "collection_type": "favorites",
      "id": "12345678",
      "name": "Favorites",
      "type": "collection"
  "limit": 100,
  "offset": 0,
  "total_count": 1