🛒 Products
Item. This is where price, customizations, and merchant-specific details live. It uses the robust "Variant Combinations" model.Fields
| Name | Type | Description |
|---|---|---|
id | string | Unique ID for this specific product listing (e.g., prod_...). |
item_id | string | Link to the Items (Global Catalog) record. |
merchant_id | string | ID of the Merchant selling this product. |
price | number | Base price set by merchant. Can be overridden by variant_combinations. |
currency | string | Currency code (e.g., "SAR", "AED"). Based on merchant's country. |
sku | string | Mandatory. Merchant's internal SKU for the base product or default variant. |
variant_groups | array | Optional. Defines available options (e.g., Size, Color). See Variants & Combinations for details. |
variant_combinations | array | Optional. Crucial. Explicitly lists all purchasable combinations, each with its final sku and price. See Variants & Combinations for details. |
modifier_groups | array | Optional. Defines optional customizations (e.g., Toppings). See Variants & Combinations for details. |
is_active | boolean | When false, the product should not be purchasable, regardless of merchant availability. |
updated_at | string | Timestamp of the last modification (ISO 8601 UTC). |
Understanding Variants & Combinations
variant_groups, variant_combinations, modifier_groups, SKUs, and pricing work together, please refer to the dedicated page Variants & Combinations page.Sample JSON
Simple Retail Product (No Variants) Example
{
"id": "prod_tm_55667",
"item_id": "item_almarai_milk_1l",
"merchant_id": "mer_tamimi_riyadh",
"price": 5.75,
"currency": "SAR",
"sku": "TM-DA-101",
"variant_groups": [],
"variant_combinations": [],
"modifier_groups": [],
"is_active": true,
"updated_at": "2025-10-16T09:00:00Z"
}Simple Restaurant Product (No Variants) Example
{
"id": "prod_rbh_fries",
"item_id": "item_rbh_fries",
"merchant_id": "mer_riyadh_burger_house",
"price": 10.00,
"currency": "SAR",
"sku": "RBH-FRIES-REG",
"variant_groups": [],
"variant_combinations": [],
"modifier_groups": [],
"is_active": true,
"updated_at": "2025-10-17T11:00:00Z"
}