Reference

v1 product search

The original flat product endpoints, one row per variant. Still supported; not recommended for new work.

Search

GET/products?search={keyword}&limit=20

One entry per sellable variant. product_id here is the variant SKU — the value POST /orders takes. The variant’s options are folded into name. limit is 1–50.

200 OK

{
  "data": [
    {
      "product_id": "TSHIRT-RED-M",
      "variant_id": "cmg4x2k1p0002qz8h9w3e4r5t",
      "sku": "TSHIRT-RED-M",
      "barcode": "8901234567890",
      "name": "Cotton T-shirt — Red / M",
      "description": "180 GSM combed cotton, regular fit.",
      "unit": "PCS",
      "selling_price": "499.00",
      "mrp": "699.00",
      "currency": "INR",
      "tax_rate": "5",
      "available": "12",
      "available_total": "20",
      "in_stock": true
    }
  ],
  "count": 1
}

One product

GET/products/{id}

{id} is a variant SKU, variant id or barcode. The same object, plus image_url (valid 10 minutes, or null).