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

# List Price Lists

> Retrieve all price lists configured for the brand.

This endpoint retrieves all price lists. A **price list** is a named set of product prices that can be applied to specific venues or sales channels — for example, a dedicated price list for delivery orders that differs from in-store prices.

<Warning>
  This endpoint requires authentication. Include your JWT in the `x-token` header. See [Authentication](/authentication) for how to obtain a token and [Errors](/errors) for error responses.
</Warning>

## Query Parameters

<ParamField query="limit" type="integer" default="50">
  Maximum number of price lists to return per page (1-999).
</ParamField>

<ParamField query="with[]" type="array">
  Include related data in the response. Supported value: `prices` — embeds the individual product prices that belong to each list.
</ParamField>

<ParamField query="sort" type="array">
  Sort the results. Supported fields: `id`, `name`, `created_at`. Use array notation, e.g. `sort[0][0]=name&sort[0][1]=asc`.
</ParamField>

<ParamField query="selects" type="string">
  Comma-separated list of fields to include in the response (e.g. `id,name,status`).
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://integrations.clopos.com/open-api/v2/price-lists?with[]=prices" \
    -H "x-token: YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://integrations.clopos.com/open-api/v2/price-lists?with[]=prices",
    { headers: { "x-token": "YOUR_ACCESS_TOKEN" } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://integrations.clopos.com/open-api/v2/price-lists",
      params={"with[]": "prices"},
      headers={"x-token": "YOUR_ACCESS_TOKEN"},
  )
  data = response.json()
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "data": [
    {
      "id": 1,
      "name": "Delivery Prices",
      "description": "Prices applied to delivery orders",
      "status": true,
      "prices": [
        {
          "id": 10,
          "list_id": 1,
          "product_id": 105,
          "price": 12.5
        }
      ],
      "created_at": "2026-01-13T14:08:49.000000Z",
      "updated_at": "2026-01-13T10:22:12.000000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}
```

## Field Reference

### Price List Object

| Field         | Type              | Description                                                                                                                                             |
| ------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | integer           | Unique identifier for the price list.                                                                                                                   |
| `name`        | string            | Display name of the price list (e.g., "Delivery Prices").                                                                                               |
| `description` | string (nullable) | Optional description of the price list, or `null`.                                                                                                      |
| `status`      | boolean           | Whether the price list is active.                                                                                                                       |
| `prices`      | array             | Individual product prices in this list. Included only when requested via `with[]=prices`. See [Price object](/api-reference/v2/price-lists/get-prices). |
| `created_at`  | string            | Creation timestamp (ISO 8601).                                                                                                                          |
| `updated_at`  | string            | Last update timestamp (ISO 8601).                                                                                                                       |