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

# Get Collection

`GET /library/{libraryId}/collections/{collectionId}`

## Request

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

Returns the details of a collection. Collections can group both videos and live streams, reflected separately in VideoCount and LiveStreamCount; PreviewImageUrls only reflects the videos in the collection.

## Path parameters

- `libraryId` integer, required
- `collectionId` string, required

## Query parameters

- `includeThumbnails` boolean

## Response `200`

The details of the requested collection

- CollectionModel
  - `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
- `404`: The requested collection was not found
- `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 `liveStreamCount` to the response with the `200` status

[Operation history](https://skmtc.dev/bunny/apis/stream-api/changes/library/:libraryId/collections/:collectionId/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)