> ## 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 Prices

> Retrieve the individual product prices that belong to price lists.

This endpoint retrieves the individual **prices** stored across all price lists. Each entry maps a product to its price within a specific price list, letting you read product pricing per channel without loading every list separately.

<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 prices to return per page (1-999).
</ParamField>

<ParamField query="filters" type="array">
  Filter prices by specific fields. Use array notation: `filters[0][0]=field_name&filters[0][1]=value`. Supported fields: `id`, `product_id`, `list_id`.
</ParamField>

<ParamField query="with[]" type="array">
  Include related data in the response. Supported values: `product` (embeds the related product) and `list` (embeds the related price list).
</ParamField>

## Request Example

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://integrations.clopos.com/open-api/v2/price-lists/prices?filters[0][0]=list_id&filters[0][1]=1",
    { 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/prices",
      params={"filters[0][0]": "list_id", "filters[0][1]": "1"},
      headers={"x-token": "YOUR_ACCESS_TOKEN"},
  )
  data = response.json()
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "data": [
    {
      "id": 10,
      "list_id": 1,
      "product_id": 105,
      "price": 12.5
    },
    {
      "id": 11,
      "list_id": 1,
      "product_id": 106,
      "price": 8.0
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 2,
    "total_pages": 1
  }
}
```

## Field Reference

### Price Object

| Field        | Type              | Description                                                                                                                                     |
| ------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`         | integer           | Unique identifier for the price entry.                                                                                                          |
| `list_id`    | integer           | ID of the [price list](/api-reference/v2/price-lists/get-price-lists) this price belongs to.                                                    |
| `product_id` | integer           | ID of the product this price applies to.                                                                                                        |
| `price`      | number            | The product's price within this price list.                                                                                                     |
| `product`    | object (nullable) | The related product. Included only when requested via `with[]=product`. See [Product object](/api-reference/v2/products/get-all-products).      |
| `list`       | object (nullable) | The related price list. Included only when requested via `with[]=list`. See [Price List object](/api-reference/v2/price-lists/get-price-lists). |