---
title: "List asset collections"
method: GET
path: "/assets/collections"
tags: ["Assets"]
---

# List asset collections

`GET /assets/collections`

List asset collections for the authenticated user's fal Assets library.

## Query parameters

- `limit` integer — Maximum number of collections to return
- `offset` integer, nullable — Number of collections to skip

## Response `200`

Successfully listed collections

- object
  - `collections` object[], required — Asset collections visible to the authenticated user
    - `id` string, required — Collection ID
    - `type` 'manual' | 'smart' | 'character', required — Collection type
    - `name` string, required — Collection display name
    - `description` string, nullable, required — Collection description
    - `icon` string, nullable, required — Optional collection icon
    - `color` string, nullable, required — Optional collection color
    - `cover_image_url` string, nullable, required — Optional cover image URL for the collection
    - `character_identifier` string, nullable, required — Character @mention identifier for character collections
    - `parent_collection_id` string, nullable, required — Parent collection ID for a nested (manual) collection; null when top-level
    - `is_favorited` boolean, required — Whether the collection is favorited
    - `filters` unknown
    - `asset_count` number, nullable — Exact asset count when available; null for smart/character collections
    - `created_at` string, required — Collection creation time
    - `updated_at` string, required — Collection update time

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Access denied
- `404` — Resource not found
- `409` — Invalid request parameters
- `422` — Invalid request parameters
- `429` — Rate limit exceeded
- `500` — Internal server error
- `502` — Upstream asset service error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)