List albums in a library
Returns a paginated list of albums ordered by creation time (newest first), optionally filtered by asset membership or ID. Use this to enumerate a user's albums or to find which albums contain a specific asset (via asset_id).
list_albums returns album metadata only — to list the assets inside a particular album, use list_album_assets or list_assets with album_id.
Pagination is cursor-based: when has_more is true, pass the id of the last album in data as starting_after_id to fetch the next page.
Query parameters
Library to list albums from. Optional if the user has a single library; required when they have multiple.
Library to list albums from. Optional if the user has a single library; required when they have multiple.
Return only albums that contain this asset. Useful for answering 'which albums is this photo in?' without calling list_album_assets.
Return only albums that contain this asset. Useful for answering 'which albums is this photo in?' without calling list_album_assets.
Look up specific albums by ID (max 200; each ID has the album_ prefix). Accepts multiple ids= query params or a single comma-delimited value (e.g., ids=album_1,album_2).
Look up specific albums by ID (max 200; each ID has the album_ prefix). Accepts multiple ids= query params or a single comma-delimited value (e.g., ids=album_1,album_2).
Maximum number of albums to return per page (1–200). Defaults to 20.
Maximum number of albums to return per page (1–200). Defaults to 20.
Cursor for pagination. Pass the id of the last album in the previous response's data to fetch the next page. Omit for the first page.
Cursor for pagination. Pass the id of the last album in the previous response's data to fetch the next page. Omit for the first page.
Response
Successful Response