List Prices

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.

This endpoint requires authentication. Include your JWT in the x-token header. See Authentication for how to obtain a token and Errors for error responses.

Query Parameters

integer

default:"50"

Maximum number of prices to return per page (1-999).

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.

array

Include related data in the response. Supported values: product (embeds the related product) and list (embeds the related price list).

Request Example

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"

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();

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()

Response Example

{
  "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 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.
`list`	object (nullable)	The related price list. Included only when requested via `with[]=list`. See Price List object.

Overview

Auth

Venues

Users

Customers

Categories

Station

Products

Price Lists

Sales

Orders

Receipts

Tables

Query Parameters

Request Example

Response Example

Field Reference

Price Object

​Query Parameters

​Request Example

​Response Example

​Field Reference

​Price Object

Query Parameters

Request Example

Response Example

Field Reference

Price Object