Get image assets
Retrieves a list of image assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your product environment.
Query Parameters
The delivery type to filter by. When omitted, returns assets of all delivery types.
A public_id prefix. When specified, all assets with that prefix are returned.
An array of public IDs to return.
items <= 100Cursor for pagination.
Maximum number of results to return (1-500).
1 <= value <= 500The sort direction for the results. Default is "desc".
Value in
- "asc"
- "desc"
An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither prefix nor public_ids were passed.
date-timeAdditional 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/image?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}