Skip to main content
GET
/
api
/
libraries
/
{library_id}
Get a library
curl --request GET \
  --url https://api.example.com/api/libraries/{library_id}
{
  "id": "<string>",
  "name": "<string>",
  "user_id": "<string>",
  "asset_count": 123,
  "storage_used_bytes": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "storage_limit_bytes": 123
}

Path Parameters

​
library_id
string
required

Library ID (with lib_ prefix) to fetch. Obtain from list_libraries or any response containing a library reference.

Response

Successful Response

Represents a user's photo library.

​
id
string
required

Unique library identifier with 'lib_' prefix

​
name
string
required

Display name of the library

​
user_id
string
required

ID of the user who owns this library

​
asset_count
integer
required

Total number of assets in this library

​
storage_used_bytes
integer
required

Bytes of assets currently stored in this library

​
created_at
string<date-time>
required

When this library was created

​
updated_at
string<date-time>
required

When this library was last updated

​
description
string | null

Optional description text for the library

​
storage_limit_bytes
integer | null

Maximum bytes this library may store, or null if no per-library limit applies