> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Products
> Retrieve published products from visible sellers.
Returns a paginated list of published products belonging to open, visible sellers.
Customer authentication is optional. When a customer token is provided, the customer's group memberships are included in the pricing context, which can change `variants.calculated_price` results. Variant prices are only computed when you request `variants.calculated_price` in `fields` (or pass `region_id`); the calculated price reflects the cheapest offer for each variant.
## Query parameters
Maximum number of products to return.
Number of products to skip before collecting results.
Field to sort by, prefixed with `-` for descending order (for example `-created_at`).
Comma-separated fields and relations to include; prefix with `+`/`-` to add to or remove from the defaults.
Free-text search term applied to product fields.
Filter by one or more product IDs.
Filter by exact product title.
Filter by product handle.
Filter by one or more collection IDs.
Filter by one or more product type IDs.
Filter by one or more category IDs; only active, non-internal categories match.
Filter by one or more tag IDs.
Filter by gift-card products.
Region used to build the pricing context for `variants.calculated_price`.
Currency used in the pricing context.
Filter by creation date using operators like `$gt`, `$gte`, `$lt`, `$lte`.
Filter by update date using operators like `$gt`, `$gte`, `$lt`, `$lte`.
Join multiple filter objects with a logical AND.
Join multiple filter objects with a logical OR.
## Response
The product's ID.
The product's title.
The product's subtitle.
Always `published` on the store API.
The product's description.
URL-safe handle.
Whether the product is a gift card.
Whether promotions can apply to the product.
Thumbnail URL.
The product's collection.
The product's type.
The product's tags.
The product's images.
The product's categories.
Product options with their values.
Product variants with their options; `calculated_price` and `offer_id` are added when requested and reflect the cheapest offer.
Attribute values assigned to the product, each with its parent attribute.
Attributes scoped to this product, with their values.
Custom key-value data.
Creation timestamp.
Last update timestamp.
Total number of matching products.
Number of skipped products.
Maximum number of returned products.
```bash cURL theme={null}
curl 'http://localhost:9000/store/products?limit=20®ion_id=reg_01JB2K4S1T&fields=*variants.calculated_price' \
-H 'x-publishable-api-key: pk_01JB2K3XYZ'
```
```ts JS Client theme={null}
const { products, count } = await client.store.products.query({
limit: 20,
region_id: "reg_01JB2K4S1T",
fields: "*variants.calculated_price",
})
```
```json 200 theme={null}
{
"products": [
{
"id": "prod_01JB2K5M8N",
"title": "Linen Shirt",
"subtitle": null,
"status": "published",
"description": "A breathable linen shirt.",
"handle": "linen-shirt",
"is_giftcard": false,
"discountable": true,
"thumbnail": "https://cdn.example.com/linen-shirt.png",
"collection": null,
"type": null,
"tags": [],
"images": [],
"categories": [{ "id": "pcat_01JB2K6A2B", "name": "Shirts" }],
"options": [{ "id": "opt_01JB2K6C3D", "title": "Size", "values": [{ "value": "M" }] }],
"variants": [
{
"id": "variant_01JB2K6E4F",
"title": "M",
"offer_id": "offer_01JB2K6G5H",
"calculated_price": {
"calculated_amount": 4500,
"original_amount": 5000,
"currency_code": "eur"
}
}
],
"product_attribute_values": [],
"scoped_attributes": [],
"metadata": null,
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-01T10:00:00.000Z"
}
],
"count": 42,
"offset": 0,
"limit": 20
}
```