> ## Documentation Index
> Fetch the complete documentation index at: https://docs.populardemand.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Items and options

> What the buyer needs, and the models they would accept.

Each **item** is one thing the buyer needs, with how many (`quantity`, null when they haven't said). Its **options** are the models they would accept. Several options mean any one of them, not several purchases.

```json theme={null}
{
  "items": [
    {
      "description": "Badminton racket",
      "quantity": 2,
      "options": [
        { "description": "Yonex Astrox 88D", "product": { "brand": "Yonex", "model": "Astrox 88D" } },
        { "description": "Victor Thruster K", "product": { "brand": "Victor", "model": "Thruster K" } }
      ]
    }
  ]
}
```

* Leave options empty until the buyer names a model. Never choose a model for them.
* Open each product link the buyer gives. Send its brand, model and selected attributes; leave unspecified attributes open.
* Sellers can count a Request once each item has the brand and model of every option, and a quantity. Until then `list_requests` flags `details_needed`.
* An item is required unless the buyer says it is optional. With several items, `all_items_required` records whether they want only the whole set.

## Changing items

In `update_request`, a field you leave out stays as it is and null clears it. Listing an item's options replaces that item's options. Name an item by `item_id` to change it, leave `item_id` out to add one, and send `remove: true` to delete one.

The exact rules your agent receives are on [Agent rules](https://docs.populardemand.market/agent-rules.md#field-rules).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.