Skip to main content
GET
/
api
/
album-assets
List album-asset link records
curl --request GET \
  --url https://api.example.com/api/album-assets
{
  "data": [
    {
      "id": "<string>",
      "album_id": "<string>",
      "asset_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true
}

Query Parameters

​
album_id
string | null

Return only link records for this album ID. Equivalent to 'list the assets in this album' — in most cases prefer list_assets with album_id to get the asset metadata directly instead of the lightweight link records.

​
asset_id
string | null

Return only link records for this asset ID. Equivalent to 'which albums contain this asset' — in most cases prefer list_albums with asset_id to get the album metadata directly.

​
ids
string[] | null

Look up specific album-asset link records by ID (max 100). The ID has the album_asset_ prefix. Accepts multiple ids= query params or a single comma-delimited value (e.g., ids=album_asset_1,album_asset_2).

​
limit
integer
default:20

Maximum number of link records per page (1–200). Defaults to 20.

Required range: 1 <= x <= 200
​
starting_after_id
string | null

Cursor for pagination. Pass the id of the last album-asset in the previous response's data to fetch the next page. Omit for the first page.

​
library_id
string | null

Library to list from. Optional if the user has a single library; required when they have multiple.

Response

Successful Response

​
data
AlbumAssetResponse · object[]
required

List of album-asset links

​
has_more
boolean
required

True if there are more album-asset links after this page. Pass the last album-asset's id as starting_after_id to fetch the next page.