> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Collection List

> 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.



## OpenAPI

````yaml https://video.bunnycdn.com/openapi/bunnynet-video-api.public.json get /library/{libraryId}/collections
openapi: 3.0.0
info:
  title: Stream API
  termsOfService: https://bunny.net/tos
  contact:
    name: bunny.net
    url: https://docs.bunny.net
    email: support@bunny.net
  version: 1.6.21
servers:
  - url: https://video.bunnycdn.com
security: []
tags:
  - name: Manage Collections
  - name: Encoding Statistics
  - name: Manage Videos
paths:
  /library/{libraryId}/collections:
    get:
      tags:
        - Manage Collections
      summary: Get Collection List
      description: >-
        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.
      operationId: Collection_List
      parameters:
        - name: libraryId
          in: path
          required: true
          description: The ID of the video library.
          schema:
            type: integer
            format: int64
          x-position: 1
        - name: page
          in: query
          description: The page number to return, 1-based; values below 1 are treated as 1.
          schema:
            type: integer
            format: int32
            default: 1
          x-position: 2
        - name: itemsPerPage
          in: query
          description: >-
            The number of items to return per page, clamped to a range of
            10-1000.
          schema:
            type: integer
            format: int32
            default: 100
          x-position: 3
        - name: search
          in: query
          description: Filters collections by name, case-insensitive substring match.
          schema:
            type: string
            default: ''
            nullable: true
          x-position: 4
        - name: orderBy
          in: query
          description: >-
            The field to order results by. Possible values: date, title — any
            other value falls back to date.
          schema:
            type: string
            default: date
            nullable: true
          x-position: 5
        - name: includeThumbnails
          in: query
          description: >-
            If set to true, populates PreviewImageUrls for each collection (only
            for the first 60 collections of the page).
          schema:
            type: boolean
            default: false
          x-position: 6
      responses:
        '200':
          description: The list of videos for the current parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginationListOfCollectionModel'
        '401':
          description: The request authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusModel'
        '500':
          description: Internal Server Error
      security:
        - AccessKey: []
components:
  schemas:
    PaginationListOfCollectionModel:
      type: object
      additionalProperties: false
      properties:
        totalItems:
          type: integer
          description: >-
            The total number of items across all pages matching the query, not
            just the current page.
          format: int64
        currentPage:
          type: integer
          description: The current page number of the result set (1-based).
          format: int64
        itemsPerPage:
          type: integer
          description: >-
            The effective page size after clamping the requested value; the last
            page may contain fewer items.
          format: int32
        items:
          type: array
          description: >-
            The items on the current page, in the order returned by the query;
            an empty list if no results match.
          nullable: true
          items:
            $ref: '#/components/schemas/CollectionModel'
    StatusModel:
      type: object
      additionalProperties: false
      properties:
        success:
          type: boolean
          description: Determines if the request was successful
        message:
          type: string
          description: >-
            Human-readable message describing the result, typically populated
            with error details when Success is false.
          nullable: true
        statusCode:
          type: integer
          description: The HTTP status code corresponding to the result of the request.
          format: int32
    CollectionModel:
      type: object
      additionalProperties: false
      properties:
        videoLibraryId:
          type: integer
          description: The video library ID that contains the collection
          format: int64
        guid:
          type: string
          description: The unique ID of the collection
          nullable: true
        name:
          type: string
          description: The name of the collection
          nullable: true
        videoCount:
          type: integer
          description: >-
            The number of on-demand videos in the collection. Live streams in
            the collection are not included in this count.
          format: int64
        liveStreamCount:
          type: integer
          description: >-
            The number of live streams in the collection. On-demand videos are
            not included in this count.
          format: int64
        totalSize:
          type: integer
          description: The total storage size of all videos in the collection, in bytes.
          format: int64
        previewVideoIds:
          type: string
          description: >-
            Comma-separated list of video GUIDs used as preview thumbnails for
            the collection.
          nullable: true
        previewImageUrls:
          type: array
          description: The URLs of preview images of videos in the collection
          nullable: true
          items:
            type: string
  securitySchemes:
    AccessKey:
      type: apiKey
      description: AccessKey based authentication
      name: AccessKey
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.