Assets

Get raw assets

GET
/v1_1/{cloud_name}/resources/raw

Retrieves a list of raw assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

Query Parameters

type?|||||

The delivery type to filter by. When omitted, returns assets of all delivery types.

prefix?string

A public_id prefix. When specified, all assets with that prefix are returned.

public_ids?array<string>

An array of public IDs to return.

Itemsitems <= 100
tags?boolean

Whether to include the list of tag names assigned to each asset. Default is false.

Defaultfalse
next_cursor?string

Cursor for pagination.

max_results?integer

Maximum number of results to return (1-500).

Range1 <= value <= 500
direction?string

The sort direction for the results. Default is "desc".

Value in

  • "asc"
  • "desc"
start_at?string

An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither prefix nor public_ids were passed.

Formatdate-time
fields?|array<>

Additional fields to include in the response. The fields public_id and asset_id are always included.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/resources/raw?public_ids=sample%2Cproduct_image%2Cbanner_2023"
{  "resources": [    {      "asset_id": "string",      "public_id": "string",      "asset_folder": "string",      "display_name": "string",      "folder": "string",      "filename": "string",      "format": "string",      "version": 0,      "resource_type": "string",      "type": "upload",      "created_at": "2019-08-24T14:15:22Z",      "uploaded_at": "2019-08-24T14:15:22Z",      "bytes": 0,      "backup_bytes": 0,      "width": 0,      "height": 0,      "aspect_ratio": 0,      "pixels": 0,      "tags": [        "string"      ],      "context": {        "custom": {          "property1": "string",          "property2": "string"        },        "property1": {          "property1": "string",          "property2": "string"        },        "property2": {          "property1": "string",          "property2": "string"        }      },      "metadata": {},      "moderation_kind": "string",      "moderation_status": "string",      "moderation": [        {          "kind": "string",          "status": "string",          "updated_at": "2019-08-24T14:15:22Z"        }      ],      "backup": true,      "url": "http://example.com",      "secure_url": "http://example.com",      "status": "string",      "access_control": [        {          "access_type": "token",          "key": "string",          "start": "string",          "end": "string"        }      ],      "etag": "string",      "animated": true,      "duration": 0,      "resource_subtype": "string",      "substatus": "string",      "related_assets": [        {}      ],      "last_updated": {        "access_control_updated_at": "2019-08-24T14:15:22Z",        "context_updated_at": "2019-08-24T14:15:22Z",        "metadata_updated_at": "2019-08-24T14:15:22Z",        "public_id_updated_at": "2019-08-24T14:15:22Z",        "tags_updated_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z"      },      "next_cursor": "string",      "derived": [        {          "transformation": "string",          "format": "string",          "bytes": 0,          "id": "string",          "url": "http://example.com",          "secure_url": "http://example.com"        }      ],      "faces": [        [          0        ]      ],      "coordinates": {        "faces": [          [            0          ]        ],        "custom": [          [            0          ]        ]      },      "illustration_score": 0,      "semi_transparent": true,      "grayscale": true,      "colors": [        []      ],      "predominant": {        "property1": [          []        ],        "property2": [          []        ]      },      "versions": [        {          "version_id": "string",          "version": "string",          "format": "string",          "size": 0,          "time": "2019-08-24T14:15:22Z",          "restorable": true        }      ],      "info": {},      "derivatives": [        {          "id": "string",          "transformation": "string",          "transformation_signature": "string",          "secure_url": "http://example.com"        }      ]    }  ],  "next_cursor": "string",  "total_count": 0}