> ## 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 Variants
> Retrieve a paginated list of product variants across products.
Returns product variants regardless of parent product, with the parent product embedded.
## Query parameters
The maximum number of variants to return.
The number of variants to skip before returning results.
The field to sort by, e.g. `created_at` or `-created_at` for descending.
Comma-separated fields to include in the response. Prefix with `+`/`-` to add to or remove from the defaults.
Search term matched against variant fields.
Filter by variant ID(s).
Filter by whether inventory is managed for the variant.
Filter by whether backorders are allowed.
Filter by SKU(s).
Filter by EAN(s).
Filter by UPC(s).
Filter by barcode(s).
Filter by parent product ID(s).
Filter by creation date using operators like `$gt`, `$lt`, `$gte`, `$lte`.
Filter by update date using operators like `$gt`, `$lt`, `$gte`, `$lte`.
Filter by deletion date using operators like `$gt`, `$lt`, `$gte`, `$lte`.
Join multiple filter objects with a logical AND.
Join multiple filter objects with a logical OR.
## Response
The variant's ID.
The variant's title.
The variant's SKU.
EAN barcode.
UPC barcode.
Generic barcode.
ID of the parent product.
The parent product record.
Whether inventory is managed for the variant.
Whether backorders are allowed.
Sort rank of the variant.
Total number of matching variants.
Number of skipped variants.
Maximum number of returned variants.
```bash cURL theme={null}
curl 'http://localhost:9000/vendor/product-variants?sku=ACME-SHIRT-M' \
-H 'Authorization: Bearer ' \
-H 'x-seller-id: '
```
```ts JS Client theme={null}
const { variants, count } = await client.vendor.productVariants.query({
sku: "ACME-SHIRT-M",
})
```
```json 200 theme={null}
{
"variants": [
{
"id": "variant_01HXYZ",
"title": "M",
"sku": "ACME-SHIRT-M",
"product_id": "prod_01HXYZ",
"product": { "id": "prod_01HXYZ", "title": "Acme T-Shirt" }
}
],
"count": 1,
"offset": 0,
"limit": 50
}
```