**Version: 202601**

# List procurement items

**GET** `/openapi/2026-01/procurements/:procurement_id/items`

Retrieves the items associated with a given procurement ID.

## Request

**Path Parameters**

- `procurement_id` string (required)

  Provide procurement ID to filter by

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  A limit on the number of objects to return. Range: 1-100 (default is 10)
- `page` int32

  Page number (1-based). Mutually exclusive with cursor

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `items` object[]

    List of items

    *   Array \[

    - `id` string

      Procurement ID
    - `procurement_id` string

      Procurement ID
    - `pending_quantity` int32

      Pending quantity
    - `received_quantity` int32

      Received quantity
    - `rejected_quantity` int32

      Rejected quantity
    - `transfer_quantity` int32

      Transfer quantity
    - `variant_id` string

      Variant ID
    - `product_id` string

      Product ID
    - `product_title` string

      Product title
    - `variant_title` string

      Variant title
    - `variant_sku` string

      Variant SKU
    - `created_at` string

      Creation timestamp, in ISO-8601 format
    - `updated_at` string

      Last update timestamp, in ISO-8601 format
    - `product_image` object

      Product image

      - `src` string

        The source URL of the image
      - `width` int32

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

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

        Alt text for the image
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records
  - `total` int32

    Total number of records across all pages (for page-mode pagination)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "id": "string",
        "procurement_id": "string",
        "pending_quantity": 0,
        "received_quantity": 0,
        "rejected_quantity": 0,
        "transfer_quantity": 0,
        "variant_id": "string",
        "product_id": "string",
        "product_title": "string",
        "variant_title": "string",
        "variant_sku": "string",
        "created_at": "string",
        "updated_at": "string",
        "product_image": {
          "src": "string",
          "width": 0,
          "height": 0,
          "alt": "string"
        }
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```