Skip to main content
GET
/
api
/
libraries
List libraries
curl --request GET \
  --url https://api.example.com/api/libraries
[
  {
    "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
  }
]

Query Parameters

​
state
enum<string>
default:live

Which set of libraries to return: live (default — excludes trashed), trashed (only trashed, ordered by most recently trashed), or all (both).

Available options:
live,
trashed,
all

Response

Successful Response

​
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