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

# List Store Items

> Browse your store catalogue, paginated

<span style={{display:"none"}}>For the complete documentation index, see [llms.txt](/llms.txt).</span>

Returns your store catalogue, paginated. The API key identifies which business's items to return. Add items to your store from the [dashboard](https://users.shakesco.com/store) or see the [Store guide](/payment-links/store).

### Query Parameters

<ParamField query="page" type="integer">
  Page number for pagination. Defaults to `1`.
</ParamField>

### Response

<ResponseField name="current_page" type="integer">
  Page returned
</ResponseField>

<ResponseField name="per_page" type="integer">
  Items per page (currently `20`)
</ResponseField>

<ResponseField name="total" type="integer">
  Total items in your catalogue
</ResponseField>

<ResponseField name="data" type="array">
  Array of store item objects, each with `id`, `name`, `description`, `price`, `quantity`, `image`, and timestamps
</ResponseField>

```javascript theme={null}
const res = await fetch("https://payments.shakesco.com/store?page=1", {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
const catalogue = await res.json();
```

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "current_page": 1,
    "per_page": 20,
    "total": 3,
    "data": [
      {
        "id": 101,
        "user_id": 42,
        "name": "Wireless Headphones",
        "description": "High-quality wireless headphones",
        "price": "149.99000000",
        "quantity": 50,
        "image": "https://example.com/headphones.jpg",
        "created_at": "2026-05-01T10:00:00.000000Z",
        "updated_at": "2026-05-01T10:00:00.000000Z"
      },
      {
        "id": 102,
        "user_id": 42,
        "name": "Laptop Stand",
        "description": "Adjustable aluminium stand",
        "price": "49.99000000",
        "quantity": null,
        "image": null,
        "created_at": "2026-05-02T10:00:00.000000Z",
        "updated_at": "2026-05-02T10:00:00.000000Z"
      }
    ]
  }
  ```
</ResponseExample>
