---
title: "Get Collection List"
method: GET
path: "/library/{libraryId}/collections"
tags: ["Manage Collections"]
---

# Get Collection List

`GET /library/{libraryId}/collections`

## Request

- Base URL: `https://video.bunnycdn.com`
- URL: `https://video.bunnycdn.com/library/{libraryId}/collections`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/stream-api/docs/library/:libraryId/collections/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of collections for the library. Collections can group both videos and live streams, reflected separately in VideoCount and LiveStreamCount; preview thumbnails only reflect the videos in each collection. When includeThumbnails is true, preview thumbnails are only populated for the first 60 collections of the returned page — later items in a larger page are returned without thumbnails.

## Path parameters

- `libraryId` integer, required

## Query parameters

- `page` integer
- `itemsPerPage` integer
- `search` string, nullable
- `orderBy` string, nullable
- `includeThumbnails` boolean

## Response `200`

The list of videos for the current parameters

- PaginationListOfCollectionModel
  - `totalItems` integer: The total number of items across all pages matching the query, not just the current page.
  - `currentPage` integer: The current page number of the result set (1-based).
  - `itemsPerPage` integer: The effective page size after clamping the requested value; the last page may contain fewer items.
  - `items` CollectionModel[], nullable: The items on the current page, in the order returned by the query; an empty list if no results match.
    - `videoLibraryId` integer: The video library ID that contains the collection
    - `guid` string, nullable: The unique ID of the collection
    - `name` string, nullable: The name of the collection
    - `videoCount` integer: The number of on-demand videos in the collection. Live streams in the collection are not included in this count.
    - `liveStreamCount` integer: The number of live streams in the collection. On-demand videos are not included in this count.
    - `totalSize` integer: The total storage size of all videos in the collection, in bytes.
    - `previewVideoIds` string, nullable: Comma-separated list of video GUIDs used as preview thumbnails for the collection.
    - `previewImageUrls` string[], nullable: The URLs of preview images of videos in the collection

## Other responses

- `401`: The request authentication failed
- `500`: Internal Server Error

## Changes

- **2026-11-12** `83116184952f`: 2 info
  - added the media type `application/json` for the response with the status `401`
  - added the optional property `items/items/liveStreamCount` to the response with the `200` status

[Operation history](https://skmtc.dev/bunny/apis/stream-api/changes/library/:libraryId/collections/get.md)

---

[API](https://skmtc.dev/bunny/apis/stream-api.md) - [All operations](https://skmtc.dev/bunny/apis/stream-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/stream-api/revisions/83116184952f?raw)