Skip to main content
GET
/
products
List products
curl --request GET \
  --url https://integrations.clopos.com/open-api/products \
  --header 'x-brand: <api-key>' \
  --header 'x-token: <api-key>' \
  --header 'x-venue: <api-key>'
{
  "data": [
    {
      "id": 123,
      "type": "GOODS",
      "name": "<string>",
      "full_name": "<string>",
      "status": 123,
      "price": 123,
      "cost_price": 123,
      "has_modifications": true,
      "modifications": [
        {
          "id": 123,
          "parent_id": 123,
          "type": "MODIFICATION",
          "name": "<string>",
          "price": 123,
          "cost_price": 123,
          "barcode": "<string>",
          "full_name": "<string>",
          "status": 123
        }
      ],
      "modificator_groups": [
        {
          "id": 123,
          "name": "<string>",
          "type": 123,
          "min_select": 123,
          "max_select": 123,
          "modificators": [
            {
              "id": 123,
              "name": "<string>",
              "price": 123,
              "cost_price": 123,
              "max_count": 123,
              "status": true,
              "ingredient": {}
            }
          ]
        }
      ],
      "recipe": [
        {
          "id": 123,
          "type": "PREPARATION",
          "name": "<string>",
          "cost_price": 123,
          "pivot": {
            "gross": "<string>"
          }
        }
      ],
      "packages": [
        {
          "id": 123,
          "name": "<string>",
          "equal": 123
        }
      ],
      "setting": {
        "interval": 123,
        "prices": [
          {
            "price": 123,
            "from": 123
          }
        ]
      },
      "taxes": [
        {
          "id": 123,
          "name": "<string>",
          "rate": 123
        }
      ],
      "tags": [
        {}
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total": 123,
    "total_pages": 123
  }
}

Authorizations

x-token
string
header
required

Access token obtained from /auth endpoint

x-brand
string
header
required

Brand identifier

x-venue
string
header
required

Venue identifier

Query Parameters

page
integer
default:1

Page number for pagination (starts at 1)

Required range: x >= 1
limit
integer
default:50

Maximum number of products to return (1-100)

Required range: 1 <= x <= 100
filters
string

JSON-stringified filter array. Each filter is an array of [field, value] or [field, operator, value]. Example: [["type", "PRODUCT"]]

Example:

"[[\"type\",\"PRODUCT\"]]"

selects
string

Comma-separated list of fields to include in the response. The fields id, name, and type are always included regardless of this parameter.

Example:

"id,name,type,price,image"

Response

Products retrieved successfully

data
object[]
pagination
object