# List collections

Returns a paginated list of collections within your organization's help center.

Collections are used to organize articles into logical groups.

### Query Parameters

- limit - Number of items to return (1-100, default 10)
- cursor - Cursor for pagination

### Response Format

Returns a list object with:
- object - Always "list"
- data - Array of collection objects
- nextCursor - Cursor for next page (null if no more results)

### Collection Object

Each collection includes:
- id - Unique identifier
- name - Collection name
- description - Collection description
- slug - URL slug
- icon - Collection icon (emoji or custom)
- parentId - Parent collection ID (null for root collections)
- helpCenterId - ID of the help center this collection belongs to
- organization - Organization ID
- defaultLocale - Default locale for content
- locale - Current locale
- availableLocales - Array of available locales
- featurebaseUrl - Featurebase URL for the collection
- externalUrl - External URL if custom domain is configured
- articleCount - Number of articles in this collection
- authorCount - Number of authors who contributed
- order - Display order
- translations - Translations for different locales
- createdAt - ISO 8601 timestamp when created
- updatedAt - ISO 8601 timestamp when last updated

Endpoint: GET /v2/help_center/collections
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Query parameters:

  - `limit` (integer)
    A limit on the number of objects to be returned, between 1 and 100.
    Example: 10

  - `cursor` (string)
    An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page.
    Example: "eyJpZCI6IjY0NzQ2ODQifQ"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "list"

  - `data` (array, required)
    Array of collections
    Example: []

  - `data.id` (string, required)
    Collection unique identifier
    Example: "6474684"

  - `data.name` (string)
    Collection name
    Example: "English Collection Name"

  - `data.description` (string)
    Collection description
    Example: "A description in English"

  - `data.slug` (string)
    URL slug
    Example: "6474684-english-version"

  - `data.icon` (object,null)
    Collection icon

  - `data.icon.type` (string, required)
    Icon type
    Example: "emoji"

  - `data.icon.value` (string, required)
    Icon value
    Example: "🥾"

  - `data.parentId` (string,null, required)
    Parent collection ID

  - `data.helpCenterId` (string, required)
    Help center ID
    Example: "j7c5g8ah3ewxp4lo"

  - `data.organization` (string, required)
    Organization ID
    Example: "6595518396205e06b897ad65"

  - `data.defaultLocale` (string)
    Default locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.locale` (string, required)
    Current locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.availableLocales` (array, required)
    Available locales
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.featurebaseUrl` (string)
    Featurebase URL
    Example: "https://yourorg.featurebase.app/en/help/collections/6474684-english-version"

  - `data.externalUrl` (string)
    External URL
    Example: "https://help.yourdomain.com/en/collections/6474684-english-version"

  - `data.articleCount` (number)
    Number of articles
    Example: 15

  - `data.authorCount` (number)
    Number of authors
    Example: 3

  - `data.order` (number,null)
    Display order
    Example: 1

  - `data.path` (string)
    Collection path
    Example: "ox6qrqprmsuqaunj/3876752/3513543"

  - `data.collapseSidebar` (boolean)
    Whether to collapse sidebar

  - `data.translations` (object)
    Translations by locale code

  - `data.translations.bn` (object)

  - `data.translations.bn.authors` (array)
    List of authors

  - `data.translations.bn.authors.name` (string)
    Author name
    Example: "John Doe"

  - `data.translations.bn.authors.authorId` (string)
    Author ID
    Example: "507f1f77bcf86cd799439011"

  - `data.translations.bn.authors.avatarUrl` (string,null)
    Author avatar URL
    Example: "https://example.com/avatar.png"

  - `data.translations.bs` (object)

  - `data.translations.pt-BR` (object)

  - `data.translations.bg` (object)

  - `data.translations.ca` (object)

  - `data.translations.hr` (object)

  - `data.translations.cs` (object)

  - `data.translations.da` (object)

  - `data.translations.nl` (object)

  - `data.translations.en` (object)

  - `data.translations.et` (object)

  - `data.translations.fi` (object)

  - `data.translations.fr` (object)

  - `data.translations.de` (object)

  - `data.translations.el` (object)

  - `data.translations.hi` (object)

  - `data.translations.hu` (object)

  - `data.translations.id` (object)

  - `data.translations.it` (object)

  - `data.translations.ja` (object)

  - `data.translations.ko` (object)

  - `data.translations.lv` (object)

  - `data.translations.lt` (object)

  - `data.translations.ms` (object)

  - `data.translations.mn` (object)

  - `data.translations.nb` (object)

  - `data.translations.pl` (object)

  - `data.translations.pt` (object)

  - `data.translations.ro` (object)

  - `data.translations.ru` (object)

  - `data.translations.sr` (object)

  - `data.translations.zh-CN` (object)

  - `data.translations.sk` (object)

  - `data.translations.sl` (object)

  - `data.translations.es` (object)

  - `data.translations.sw` (object)

  - `data.translations.sv` (object)

  - `data.translations.th` (object)

  - `data.translations.zh-TW` (object)

  - `data.translations.tr` (object)

  - `data.translations.uk` (object)

  - `data.translations.vi` (object)

  - `data.createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2024-10-18T12:33:09.099Z"

  - `data.updatedAt` (string, required)
    ISO 8601 timestamp when last updated
    Example: "2024-10-18T13:03:25.921Z"

  - `nextCursor` (string,null, required)
    Cursor for fetching the next page (cursor-based pagination)

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_cursor"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400