> ## 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 a paginated list of master catalog products.
Returns all products across the marketplace, with optional filtering by status, seller, category, and more.
## Query parameters
Maximum number of records to return.
Number of records to skip.
Field to sort by, prefix with `-` for descending order.
Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.
Search term matched against product fields.
Filter by product ID(s).
Filter by product title.
Filter by product handle.
Filter by the seller(s) eligible to sell the product.
Filter by status: `draft`, `proposed`, `published`, or `rejected`.
Filter by collection ID(s).
Filter by product type ID(s).
Filter by category ID(s).
Filter by tag ID(s).
Filter by variant SKU.
Filter by variant EAN.
Filter by variant UPC.
Filter by variant barcode.
Filter to products that have (or don't have) seller offers.
Filter by creation date with operators like `$gte`, `$lte`.
Filter by update date with operators like `$gte`, `$lte`.
Filter by deletion date with operators like `$gte`, `$lte`.
## Response
The product's ID.
Product title.
Product subtitle.
One of `draft`, `proposed`, `published`, `rejected`.
Product description.
Unique URL-safe handle.
Whether the product is a gift card.
Whether discounts can apply to the product.
URL of the product thumbnail.
ID of the product in an external system.
ID of the product's collection.
ID of the product's type.
The collection with `id`, `title`, and `handle`.
Categories with `id`, `name`, and `handle`.
Variants with `id`, `title`, `sku`, `manage_inventory`, `allow_backorder`, and `variant_rank`.
Attribute values selected on the product, each with its parent `attribute`.
Product-scoped (inline) attributes with their `values`.
Computed attribute groups, each with the selected `values` and the attribute's full `all_values`.
Product weight.
Product length.
Product height.
Product width.
Harmonized System code.
Manufacturer identification code.
Country of origin.
Product material.
Custom key-value data.
Creation timestamp.
Last update timestamp.
Total number of matching products.
Number of records skipped.
Number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/admin/products?status[]=published&limit=20' \
-H 'Authorization: Bearer '
```
```ts JS Client theme={null}
const { products, count } = await client.admin.products.query({
status: ["published"],
limit: 20,
})
```
```json 200 theme={null}
{
"products": [
{
"id": "prod_01HXYZABCDEF",
"title": "Linen Shirt",
"handle": "linen-shirt",
"status": "published",
"thumbnail": "https://cdn.example.com/linen-shirt.png",
"variants": [
{ "id": "variant_01HXYZABCDEF", "title": "M", "sku": "LS-M", "variant_rank": 0 }
],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:00:00.000Z"
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```