[POST] .../v1/itemimage/get
Returns images items. Use this method to load image metadata and CDN URLs for catalog items shown in product cards, integrations and POS item lists. The response returns ItemImage records mapped from the common image table; the request supports id and item_id filters. The caller must have item image select permission; missing body, denied access, invalid filters, storage errors or image lookup failures are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| compress_data | Boolean | Optional | Flag indicating whether returned image data is compressed. |
| filters | Array of Filter | Optional | Optional filters by fields available for this API method. |
| include_data | Boolean | Optional | Flag indicating whether binary image data is included in the response. |
Filterable Fields
| Field | Type | Description |
|---|---|---|
| id | int | Image record ID array. |
| item_id | int | Item IDs. |
Request Example
{
"filters": [
{
"Field": "item_id",
"Operator": "In",
"Value": "24,25"
}
]
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Array of ItemImage | Result array. |
Response Example
{
"ok": true,
"result": [
{
"id": 1001,
"item_id": 24,
"width": 900,
"height": 900,
"size": 31896,
"url": "https://cdn.regos.uz/example/item-24.jpg",
"last_update": 1712345600
}
]
}