List Assets
Retrieve a list of all images uploaded to your account. You can filter by folder and paginate results.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
folder | String | (Optional) Filter assets by folder name. |
limit | Number | (Optional) Max results to return. Default: 50. |
page | Number | (Optional) Page number for pagination. Default: 1. |
Example: cURL
curl "https://imgnodus-api-411853553644.us-central1.run.app/v1/images?folder=products" \
-H "X-API-Key: IR_KEY_xxxxxxxxxx"Example: JavaScript
const res = await fetch('https://imgnodus-api-411853553644.us-central1.run.app/v1/images', {
headers: { 'X-API-Key': process.env.IMGNODUS_API_KEY }
});
const { images, total } = await res.json();Response
{
"success": true,
"total": 142,
"images": [
{
"id": "1775929784157_photo.webp",
"url": "https://storage.googleapis.com/bucket/users/uid/1775929784157_photo.webp",
"size": 12400,
"uploadedAt": "2026-04-12T10:00:00Z",
"folder": "products"
}
]
}