---
title: "Get asset character"
method: GET
path: "/assets/characters/{character_id}"
tags: ["Assets"]
---

# Get asset character

`GET /assets/characters/{character_id}`

Get asset character for the authenticated user's fal Assets library.

## Path parameters

- `character_id` string, required — Character collection ID

## Response `200`

Character details

- object
  - `character` object, required — Asset character
    - `id` string, required — Collection ID
    - `type` '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
    - `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
    - `reference_images` string[], required — Reference images used for character matching

## 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)