Get asset collection
Get asset collection 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/collections/{collection_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/collections/{collection_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/collections/{collection_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"collection": {
"id": "d8b6elcregj72v34jr8g",
"type": "manual",
"name": "Campaign concepts",
"description": "Reusable campaign imagery",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": null,
"parent_collection_id": null,
"is_favorited": false,
"filters": null,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z"
}
}{
"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
Collection ID
1"d8b6elcregj72v34jr8g"
Response
Collection details
Asset collection
Hide child attributes
Hide child attributes
Collection ID
Collection type
manual, smart, 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
Filter DSL backing smart and character collections
Exact asset count when available; null for smart/character collections
Was this page helpful?
curl --request GET \
--url https://api.fal.ai/v1/assets/collections/{collection_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/collections/{collection_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/collections/{collection_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"collection": {
"id": "d8b6elcregj72v34jr8g",
"type": "manual",
"name": "Campaign concepts",
"description": "Reusable campaign imagery",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": null,
"parent_collection_id": null,
"is_favorited": false,
"filters": null,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z"
}
}{
"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"
}
}