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

# List products (optional)

> Backs product recommendations. Omit it if the widget never shows catalog cards.

Backs product recommendations. Omit it if the widget never shows catalog cards.

### Query parameters

<ParamField query="limit" type="integer">
  Maximum products to return
</ParamField>

### Response

`ProductList`

<ResponseField name="products" type="object[]">
  <Expandable title="products">
    <ResponseField name="id" type="string" />

    <ResponseField name="title" type="string" />

    <ResponseField name="price" type="string" />

    <ResponseField name="url" type="string" />

    <ResponseField name="image" type="string" />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning |
| ----- | ------- |
| `200` | OK      |
| `400` | Error   |
| `401` | Error   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.example.com/api/products' \
    --header 'x-widget-token: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "products": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "title": "Replacement tent pole set",
        "price": "49.00",
        "url": "https://example.com/webhooks/stateset",
        "image": "https://cdn.example.com/products/tent-2p.jpg"
      }
    ]
  }
  ```
</ResponseExample>