GET
/
v1
/
assets
/
{id}
Get asset
curl --request GET \
  --url https://api.getbluma.com/api/v1/assets/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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
}

Authorizations

​
Authorization
string
header
required

Use your API key in the format: Bearer bluma_live_your_api_key_here

Path Parameters

​
id
string
required

Asset identifier

Response

Asset details

​
id
string
required

Asset identifier

​
display_name
string
required

Human-readable asset name

​
s3_url
string<uri>
required

S3 storage URL

​
cloudfront_url
string<uri>
required

CDN delivery URL

​
file_type
string
required

MIME type (e.g., image/jpeg, video/mp4)

​
source_type
enum<string>
required

How the asset was created

Available options:
uploaded,
ai_generated
​
user_id
string
required

Owner user ID

​
created_at
string<date-time>
required

Creation timestamp

​
width
number | null

Width in pixels (for images/videos)

​
height
number | null

Height in pixels (for images/videos)

​
file_size_bytes
number | null

File size in bytes

​
brand_id
string | null

Associated brand ID (if any)

​
deleted_at
string<date-time> | null

Soft delete timestamp