Skip to content
Get started

Retrieves a paginated list of products.

products.list_products(ProductListProductsParams**kwargs) -> ProductListProductsResponse
GET/api/v2/public/products

Retrieves a paginated list of products.

ParametersExpand Collapse
page_size: Optional[str]

The number of items per page.

page_start: Optional[str]

The starting page index for pagination.

product_number: Optional[SequenceNotStr[str]]

Optional array of product numbers to filter by.

ReturnsExpand Collapse
class ProductListProductsResponse:

Lightweight paginated result set.

page_number: Optional[int]

Current page number (1-based).

formatint64
page_size: Optional[int]

Maximum number of records returned per page.

formatint64
records: Optional[List[ProductItem]]

Collection of records for the current page.

barcode: str
product_name: str

Display name of the product.

product_number: str

Unique product number.

allow_decimal: Optional[bool]
attention_code: Optional[str]
average_weight: Optional[float]
formatdouble
barcodes_array: Optional[str]
base_unit_name: Optional[str]
brand_code: Optional[str]
brand_description: Optional[str]
carrier_item_quantity: Optional[float]
formatdouble
category_code: Optional[str]
color: Optional[str]
color_code: Optional[str]
countries_allowed: Optional[List[str]]
countries_not_allowed: Optional[List[str]]
country_code: Optional[str]
deprecation_date: Optional[datetime]
formatdate-time
edit_min_max_percentage: Optional[int]
formatint32
expiration_min_range: Optional[int]
formatint32
free_fields: Optional[List[FreeField]]
key: Optional[str]
sort_order: Optional[int]
formatint32
value: Optional[str]
general_ledger: Optional[str]
image_url: Optional[str]
is_active: Optional[bool]
is_counted: Optional[bool]
is_edit_min_max: Optional[bool]
is_edit_replenishment: Optional[bool]
is_expiration: Optional[bool]
is_order_manually: Optional[bool]
is_promotion: Optional[bool]
is_set: Optional[bool]
is_stock: Optional[bool]
is_store_product: Optional[bool]
is_template: Optional[bool]
margin_category: Optional[str]
moq: Optional[float]
formatdouble
old_price: Optional[float]
formatdouble
price: Optional[float]
formatdouble
price_compare_multiplier: Optional[float]
formatdouble
price_compare_unit: Optional[str]
price_lines: Optional[str]
product_details: Optional[str]
product_type: Optional[str]
product_url: Optional[str]
promo_stores_allowed: Optional[List[str]]
promo_stores_not_allowed: Optional[List[str]]
promotion: Optional[str]
promotion_week: Optional[str]
purchase_price: Optional[float]
formatdouble
purchase_unit_barcode: Optional[str]
purchase_unit_name: Optional[str]
purchase_unit_product_number: Optional[str]
purchase_unit_quantity: Optional[float]
formatdouble
referral_product_id: Optional[str]
reset_store_stock: Optional[bool]
set_product: Optional[List[SetProduct]]
set_item_quantity: Optional[str]
set_product_number: Optional[str]
shelf_label: Optional[bool]
shelf_label_barcode: Optional[bool]
shelf_label_layout: Optional[int]
formatint32
shelf_label_price: Optional[bool]
shelf_label_quantity: Optional[int]
formatint32
size: Optional[str]
size_code: Optional[str]
smallest_product_number: Optional[str]
smallest_quantity: Optional[float]
formatdouble
special_price: Optional[float]
formatdouble
stores_allowed: Optional[List[str]]
stores_not_allowed: Optional[List[str]]
supplier_id: Optional[str]
supplier_name: Optional[str]
supplier_product_number: Optional[str]
units: Optional[List[Unit]]
unit_barcode: Optional[str]
unit_name: Optional[str]
unit_quantity: Optional[float]
formatdouble
variant_code: Optional[str]
variant_factor: Optional[float]
formatdouble
variant_family: Optional[str]
volume: Optional[str]
total_record_count: Optional[int]

Total number of records matching the query across all pages.

formatint64

Retrieves a paginated list of products.

import os
from colleqtive_sdk import Colleqtive

client = Colleqtive(
    bearer_token=os.environ.get("COLLEQTIVE_BEARER_TOKEN"),  # This is the default and can be omitted
)
response = client.products.list_products()
print(response.page_number)
{
  "page_number": 1,
  "page_size": 50,
  "records": [
    {
      "barcode": "barcode",
      "product_name": "Organic Milk 1L",
      "product_number": "PRD-001",
      "allow_decimal": true,
      "attention_code": "attention_code",
      "average_weight": 0,
      "barcodes_array": "barcodes_array",
      "base_unit_name": "base_unit_name",
      "brand_code": "brand_code",
      "brand_description": "brand_description",
      "carrier_item_quantity": 0,
      "category_code": "category_code",
      "color": "color",
      "color_code": "color_code",
      "countries_allowed": [
        "string"
      ],
      "countries_not_allowed": [
        "string"
      ],
      "country_code": "country_code",
      "deprecation_date": "2019-12-27T18:11:19.117Z",
      "edit_min_max_percentage": 0,
      "expiration_min_range": 0,
      "free_fields": [
        {
          "key": "key",
          "sort_order": 0,
          "value": "value"
        }
      ],
      "general_ledger": "general_ledger",
      "image_url": "image_url",
      "is_active": true,
      "is_counted": true,
      "is_edit_min_max": true,
      "is_edit_replenishment": true,
      "is_expiration": true,
      "is_order_manually": true,
      "is_promotion": true,
      "is_set": true,
      "is_stock": true,
      "is_store_product": true,
      "is_template": true,
      "margin_category": "margin_category",
      "moq": 0,
      "old_price": 0,
      "price": 0,
      "price_compare_multiplier": 0,
      "price_compare_unit": "price_compare_unit",
      "price_lines": "price_lines",
      "product_details": "product_details",
      "product_type": "product_type",
      "product_url": "product_url",
      "promo_stores_allowed": [
        "string"
      ],
      "promo_stores_not_allowed": [
        "string"
      ],
      "promotion": "promotion",
      "promotion_week": "promotion_week",
      "purchase_price": 0,
      "purchase_unit_barcode": "purchase_unit_barcode",
      "purchase_unit_name": "purchase_unit_name",
      "purchase_unit_product_number": "purchase_unit_product_number",
      "purchase_unit_quantity": 0,
      "referral_product_id": "referral_product_id",
      "reset_store_stock": true,
      "set_product": [
        {
          "set_item_quantity": "set_item_quantity",
          "set_product_number": "set_product_number"
        }
      ],
      "shelf_label": true,
      "shelf_label_barcode": true,
      "shelf_label_layout": 0,
      "shelf_label_price": true,
      "shelf_label_quantity": 0,
      "size": "size",
      "size_code": "size_code",
      "smallest_product_number": "smallest_product_number",
      "smallest_quantity": 0,
      "special_price": 0,
      "stores_allowed": [
        "string"
      ],
      "stores_not_allowed": [
        "string"
      ],
      "supplier_id": "supplier_id",
      "supplier_name": "supplier_name",
      "supplier_product_number": "supplier_product_number",
      "units": [
        {
          "unit_barcode": "unit_barcode",
          "unit_name": "unit_name",
          "unit_quantity": 0
        }
      ],
      "variant_code": "variant_code",
      "variant_factor": 0,
      "variant_family": "variant_family",
      "volume": "volume"
    }
  ],
  "total_record_count": 230
}
Returns Examples
{
  "page_number": 1,
  "page_size": 50,
  "records": [
    {
      "barcode": "barcode",
      "product_name": "Organic Milk 1L",
      "product_number": "PRD-001",
      "allow_decimal": true,
      "attention_code": "attention_code",
      "average_weight": 0,
      "barcodes_array": "barcodes_array",
      "base_unit_name": "base_unit_name",
      "brand_code": "brand_code",
      "brand_description": "brand_description",
      "carrier_item_quantity": 0,
      "category_code": "category_code",
      "color": "color",
      "color_code": "color_code",
      "countries_allowed": [
        "string"
      ],
      "countries_not_allowed": [
        "string"
      ],
      "country_code": "country_code",
      "deprecation_date": "2019-12-27T18:11:19.117Z",
      "edit_min_max_percentage": 0,
      "expiration_min_range": 0,
      "free_fields": [
        {
          "key": "key",
          "sort_order": 0,
          "value": "value"
        }
      ],
      "general_ledger": "general_ledger",
      "image_url": "image_url",
      "is_active": true,
      "is_counted": true,
      "is_edit_min_max": true,
      "is_edit_replenishment": true,
      "is_expiration": true,
      "is_order_manually": true,
      "is_promotion": true,
      "is_set": true,
      "is_stock": true,
      "is_store_product": true,
      "is_template": true,
      "margin_category": "margin_category",
      "moq": 0,
      "old_price": 0,
      "price": 0,
      "price_compare_multiplier": 0,
      "price_compare_unit": "price_compare_unit",
      "price_lines": "price_lines",
      "product_details": "product_details",
      "product_type": "product_type",
      "product_url": "product_url",
      "promo_stores_allowed": [
        "string"
      ],
      "promo_stores_not_allowed": [
        "string"
      ],
      "promotion": "promotion",
      "promotion_week": "promotion_week",
      "purchase_price": 0,
      "purchase_unit_barcode": "purchase_unit_barcode",
      "purchase_unit_name": "purchase_unit_name",
      "purchase_unit_product_number": "purchase_unit_product_number",
      "purchase_unit_quantity": 0,
      "referral_product_id": "referral_product_id",
      "reset_store_stock": true,
      "set_product": [
        {
          "set_item_quantity": "set_item_quantity",
          "set_product_number": "set_product_number"
        }
      ],
      "shelf_label": true,
      "shelf_label_barcode": true,
      "shelf_label_layout": 0,
      "shelf_label_price": true,
      "shelf_label_quantity": 0,
      "size": "size",
      "size_code": "size_code",
      "smallest_product_number": "smallest_product_number",
      "smallest_quantity": 0,
      "special_price": 0,
      "stores_allowed": [
        "string"
      ],
      "stores_not_allowed": [
        "string"
      ],
      "supplier_id": "supplier_id",
      "supplier_name": "supplier_name",
      "supplier_product_number": "supplier_product_number",
      "units": [
        {
          "unit_barcode": "unit_barcode",
          "unit_name": "unit_name",
          "unit_quantity": 0
        }
      ],
      "variant_code": "variant_code",
      "variant_factor": 0,
      "variant_family": "variant_family",
      "volume": "volume"
    }
  ],
  "total_record_count": 230
}