Get asset character
Get asset character for the authenticated user’s fal Assets library.
Required permissions: assets:read. Key presets that include them: API, SERVERLESS, READONLY, FULL. See key permissions.
curl --request GET \
--url https://api.fal.ai/v1/assets/characters/{character_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/characters/{character_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fal.ai/v1/assets/characters/{character_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"character": {
"id": "d7tatpsregjaga2cf3d0",
"type": "character",
"name": "Alice",
"description": "A character with red hair and a blue jacket",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": "alice",
"parent_collection_id": null,
"is_favorited": false,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z",
"asset_count": null,
"reference_images": [
"https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png"
]
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "authorization_error",
"message": "Authentication required"
}
}{
"error": {
"type": "authorization_error",
"message": "Access denied"
}
}{
"error": {
"type": "not_found",
"message": "Resource not found"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "rate_limited",
"message": "Rate limit exceeded"
}
}{
"error": {
"type": "server_error",
"message": "An unexpected error occurred"
}
}{
"error": {
"type": "server_error",
"message": "Upstream asset service failed"
}
}Authorizations
Key on the READONLY preset, or any key whose permissions include the ones this API lists. Prefix it with "Key ", e.g. Authorization: Key YOUR_API_KEY
Path Parameters
Character collection ID
1"d7tatpsregjaga2cf3d0"
Response
Character details
Asset character
Hide child attributes
Hide child attributes
Collection ID
Collection type
character Collection display name
Collection description
Optional collection icon
Optional collection color
Optional cover image URL for the collection
Character @mention identifier for character collections
Parent collection ID for a nested (manual) collection; null when top-level
Whether the collection is favorited
Collection creation time
Collection update time
Reference images used for character matching
Exact asset count when available; null for smart/character collections
Was this page helpful?
curl --request GET \
--url https://api.fal.ai/v1/assets/characters/{character_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/characters/{character_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fal.ai/v1/assets/characters/{character_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"character": {
"id": "d7tatpsregjaga2cf3d0",
"type": "character",
"name": "Alice",
"description": "A character with red hair and a blue jacket",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": "alice",
"parent_collection_id": null,
"is_favorited": false,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z",
"asset_count": null,
"reference_images": [
"https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png"
]
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "authorization_error",
"message": "Authentication required"
}
}{
"error": {
"type": "authorization_error",
"message": "Access denied"
}
}{
"error": {
"type": "not_found",
"message": "Resource not found"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "rate_limited",
"message": "Rate limit exceeded"
}
}{
"error": {
"type": "server_error",
"message": "An unexpected error occurred"
}
}{
"error": {
"type": "server_error",
"message": "Upstream asset service failed"
}
}