Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Collections

List collections

GET
/v2/asset_management/{cloud_name}/collections

Returns the collections the caller may read, most-recently-updated first by default (updated_at desc). Results are paginated: pass the returned next_cursor back to fetch the next page.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your Cloudinary product environment.

Query Parameters

query?string

Case-insensitive filter on the collection name. Returns collections with a word in their name that starts with this text (for example, sum matches "Summer Campaign").

sort_by?string

Sort expression: <field> <direction>, optionally comma-separated for a multi-key sort (e.g. name asc, created_at desc). field is one of name, created_at, or updated_at, the same field names the response uses, and direction is asc or desc. Defaults to updated_at desc.

max_results?integer

Maximum number of collections to return (1-100, default 20).

Range1 <= value <= 100
next_cursor?string

Opaque cursor from a previous response's next_cursor to fetch the next page.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/asset_management/demo/collections?query=summer&sort_by=name+asc&max_results=20"
{  "data": [    {      "id": "col_8f3a2b1c9d4e",      "name": "Summer Campaign Assets",      "creator_type": "user",      "creator_id": "usr_4a1b2c3d5e6f",      "created_at": "2026-03-14T10:15:00Z",      "updated_at": "2026-03-15T09:30:00Z",      "description": "Approved photography for the summer campaign launch.",      "type": "dynamic",      "configuration": {        "expression": "tags = \"summer-campaign\" AND resource_type:image"      },      "asset_count": 12,      "cover_asset_url": "https://res.cloudinary.com/demo/image/upload/sample.jpg"    }  ],  "next_cursor": "eyJsYXN0X21vZGlmaWVkX2F0IjoxNzQwNTg0MzAwfQ",  "total_count": 42}

Check the status and result of a generation task GET

Check on an image generation running in the background: whether it is pending, processing, completed or failed, and, once it has completed, the generated images with their URLs, size and format.

Create a collection POST

Creates a collection under the given product environment and makes the caller the owner.