Collections - Management

List all collections

Retrieve all active collections accessible to the authenticated user with pagination support.

This endpoint returns collections that the user has read access to, including:

  • User-owned collections (scope: User)
  • Customer collections (scope: Customer) - organization-wide collections accessible to the user
  • Team-shared collections (via collection roles)

Note:

  • Only active (non-deactivated) collections are returned
  • Featured collections (scope: Featured) are excluded from this endpoint
  • Inactive (deactivated) collections are automatically filtered out

Response: Returns a paginated list of collection objects. Each collection includes basic information such as id, uuid, scope, type, name, count, lanes, tiersEnabled, and optional parentId and children fields. See the PublicCollectionDTO schema for complete field definitions.

Note: Fields with null values (parentId, updatedAt) are omitted from the JSON response. This is standard JSON serialization behavior. In the list endpoint, children arrays are typically empty - use GET /public/v1/collections/{collectionId} to retrieve a collection with its full children tree populated.

    **Pagination:**
    - Results are paginated for efficient data retrieval
    - Use query parameters to control pagination:
  • page: Page number (0-indexed, default: 0)
  • size: Number of items per page (default: 500) - Results are sorted alphabetically by collection name - Only active collections are included in pagination (inactive/deactivated collections are filtered out)

Access Control:

  • Collections are filtered to include only those accessible to you:
    • Collections owned by you (scope: User)
    • Customer collections accessible to your organization (scope: Customer)
    • Collections where you have been granted access (via collection roles)
  • Featured collections are excluded from this endpoint
  • Inactive (deactivated) collections are automatically excluded

Required Permission: ACCESS_COLLECTION

get/public/v1/collections

Query parameters

pageinteger

Zero-based page index (0..N)

sizeinteger

The size of the page to be returned

sortstring[]

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response

200 OK - Successfully retrieved collections

sizeinteger
numberinteger
totalElementsinteger
totalPagesinteger
numberOfElementsinteger
firstboolean
lastboolean
emptyboolean