Skip to main content
GET
/
api
/
albums
/
{album_id}
Get an album
curl --request GET \
  --url https://api.example.com/api/albums/{album_id}
{
  "id": "<string>",
  "name": "<string>",
  "asset_count": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "album_cover_asset_id": "<string>",
  "asset_urls": {},
  "start_date": "2023-11-07T05:31:56Z",
  "end_date": "2023-11-07T05:31:56Z"
}

Path Parameters

​
album_id
string
required

Album ID (with album_ prefix) to fetch. Obtain from list_albums (optionally filtered by asset_id to find albums containing a specific asset), list_album_assets, or any response containing an album reference.

Response

Successful Response

Represents a collection of assets organized by the user.

​
id
string
required

Unique album identifier with 'album_' prefix

​
name
string
required

Display name of the album

​
asset_count
integer
required

Total number of assets in this album

​
created_at
string<date-time>
required

When this album was created

​
updated_at
string<date-time>
required

When this album was last updated

​
description
string | null

Optional description text for the album

​
album_cover_asset_id
string | null

ID of the asset displayed as the album cover. May be a server-selected default when the album has no explicit cover set, or null when the album has no live assets.

​
asset_urls
Asset Urls · object

Asset variants for the album cover: 'thumbnail'

​
start_date
string<date-time> | null

The oldest asset date (local_datetime) in the album, or null if empty

​
end_date
string<date-time> | null

The newest asset date (local_datetime) in the album, or null if empty