List Products

GET/store/:storeCode/products

publishable key

Retrieve a paginated list of products.

Relations such as `variants` and `options` are included when requested via the `fields` query param — prefix a relation with `*` (e.g. `*variants,*options`). Pass `region_id` to include `calculated_price` on variants.

Path Parameters

storeCoderequiredstring

Store slug in the URL (first argument to every SDK store method).

Query Parameters

limitnumber

Maximum number of items to return.

offsetnumber

Number of items to skip before collecting the result set.

orderstring

Field to sort by. Prefix with `-` for descending order (e.g. `-created_at`).

fieldsstring

Comma-separated fields to include. Prefix with `*` to expand a relation (e.g. `id,*variants`).

qstring

Search query.

idstring | string[]

Filter by product ID(s).

titlestring

Filter by title.

handlestring

Filter by handle.

category_idstring | string[]

Filter by product category ID(s).

collection_idstring | string[]

Filter by collection ID(s).

region_idstring

Region ID for calculated prices.

country_codestring

Country code for pricing context.

cart_idstring

Cart ID for pricing context.

Response

Status

200OK

Schema

Copy

HttpTypes.StoreProductListResponse

Properties

productsrequiredStoreProduct[]

List of products.

countrequirednumber

Total count.

offsetrequirednumber

Offset applied.

limitrequirednumber

Limit applied.