**Version: 202601**

# List product images

**GET** `/openapi/2026-01/products/:product_id/images`

Retrieve a list of all product image with pagination.

## Request

**Path Parameters**

- `product_id` string (required)

  The unique identifier for the product

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `images` object[]

    Array of image object

    *   Array \[

    - `id` string

      The unique identifier for the image
    - `product_id` string

      The unique identifier for the product associated with the image
    - `position` int32

      The position of the image relative to other images in the product gallery
    - `src` string

      The URL of the image
    - `width` int32

      The width of the image in pixels
    - `height` int32

      The height of the image in pixels
    - `alt` string

      Alternative text for the image (used for accessibility or descriptions)
    - `created_at` string

      Image creation time
    - `updated_at` string

      Image last updated time
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "images": [
      {
        "id": "string",
        "product_id": "string",
        "position": 0,
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ]
  }
}
```