GET
/
v1
/
collections
/
{id}
/
assets
List assets
curl --request GET \
  --url https://api.getbluma.com/api/v1/collections/{id}/assets \
  --header 'Authorization: Bearer <token>'
{
  "assets": [
    {
      "id": "asset_abc123",
      "display_name": "product-hero.jpg",
      "s3_url": "https://s3.amazonaws.com/bluma-images/abc123.jpg",
      "cloudfront_url": "https://cdn.getbluma.com/assets/abc123.jpg",
      "file_type": "image/jpeg",
      "width": 1920,
      "height": 1080,
      "file_size_bytes": 245678,
      "source_type": "uploaded",
      "user_id": "user_xyz789",
      "brand_id": null,
      "created_at": "2025-01-15T10:30:00Z",
      "deleted_at": null
    }
  ],
  "total": 123
}

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

Query Parameters

limit
integer
default:50

Maximum number of assets to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of assets to skip

Required range: x >= 0

Response

List of assets

assets
object[]
total
number