Skip to main content

List catalog (efficient product listing)

GET 
/v1/:channel/catalog

High-performance product listing via the default_variant_id JOIN path. Returns a display object with the default variant's price and stock without fetching all variants unless variant_mode=all is specified.

Include flags (comma-separated in include):

  • promotions — compute best applicable promotion per product
  • attributes — product & variant attribute values
  • media — full media gallery
  • collections — associated collections

variant_mode:

  • default (default) — display object only; fastest path
  • all — all published variants returned in variants[]

Request​

Responses​

Catalog product list