GET
/
v1
/
collections
/
{id}
Get collection
curl --request GET \
  --url https://api.getbluma.com/api/v1/collections/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "asset_type": "images",
  "user_id": "<string>",
  "is_global": true,
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "asset_count": 123,
  "deleted_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Use your API key in the format: Bearer bluma_live_your_api_key_here

Path Parameters

​
id
string
required

Collection identifier

Response

Collection details

​
id
string
required

Collection identifier

​
name
string
required

Collection name

​
asset_type
enum<string>
required

Type of assets allowed

Available options:
images,
videos,
all
​
user_id
string
required

Owner user ID

​
is_global
boolean
required

Whether collection is globally accessible

​
created_at
string<date-time>
required

Creation timestamp

​
description
string | null

Collection description

​
asset_count
number

Number of assets in collection

​
deleted_at
string<date-time> | null

Soft delete timestamp