> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# Item object

This data model is used to store crucial product details. The `price` field represents the unit price of the individual item. The `quantity` field shows the number of units of the item. The `name` field denotes the name of the product, while `sku` holds the Stock Keeping Unit identifier. 100 is the maximum number of item objects in the items array.

## Attributes

| Attribute               | Type                               | Description                                                                                                                                                                                             |
| :---------------------- | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `name`                  | string `required`                  | Product name. Limited to 255 characters.                                                                                                                                                                |
| `sku`                   | string                             | Product SKU. Limited to 128 characters.                                                                                                                                                                 |
| `quantity`              | integer `required`                 | The quantity of the item, stored as a signed 32-bit integer.                                                                                                                                            |
| `pageUrl`               | string                             | The canonical URL for the item's Product Detail Page. Limited to 2048 characters.                                                                                                                       |
| `imageUrl`              | string                             | A URL for a web-optimised photo of the item, suitable for use directly as the `src` attribute of an `img` tag. Limited to 2048 characters.                                                              |
| `price`                 | [Money](/money-object)  `required` | The unit price of the individual item. Must be a positive value.                                                                                                                                        |
| `categories`            | \[]\[]                             | An array of arrays to accommodate multiple categories that apply to the item. Each array represents a hierarchical path to a category, with the left-most category being the top-level parent category. |
| `estimatedShipmentDate` | string                             | The estimated date when the order will be shipped, in `YYYY-MM` or `YYYY-MM-DD` format.                                                                                                                 |

> **Warning**
>
> It is crucial that the `price` represents the unit price of the individual item.
>
> Never populate the `price` by multiplying the quantity by the unit cost. Always enter the price for a single unit to maintain data accuracy.

## Example Item object

```json
{
  "name": "Blue Carabiner",
  "sku": "12341234",
  "quantity": 1,
  "pageUrl": "https://merchant.example.com/carabiner-354193.html",
  "imageUrl": "https://merchant.example.com/carabiner-7378-391453-1.jpg",
  "price": {
    "amount": "40.00",
    "currency": "GBP"
  },
  "categories": [
    ["Sporting Goods", "Climbing Equipment", "Climbing", "Climbing Carabiners"],
    ["Sale", "Climbing"]
  ],
	"estimatedShipmentDate": "2021-03-01"
}
```