> ## 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 Product Variants
> Retrieve a paginated list of a product's variants.
Returns the variants of a single product, with optional filtering by SKU and identifiers.
## Path parameters
The product's ID.
## 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 variant fields.
Filter by variant ID(s).
Filter by SKU.
Filter by EAN.
Filter by UPC.
Filter by barcode.
## Response
The variant's ID.
Variant title.
Variant SKU.
Variant EAN.
Variant UPC.
Variant barcode.
Harmonized System code.
Manufacturer identification code.
Sort rank of the variant.
Variant weight.
Variant length.
Variant height.
Variant width.
Country of origin.
Variant material.
ID of the parent product.
Whether inventory is tracked for the variant.
Whether the variant can be ordered when out of stock.
The variant's option values.
Custom key-value data.
Creation timestamp.
Last update timestamp.
Total number of matching variants.
Number of records skipped.
Number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/variants?limit=20' \
-H 'Authorization: Bearer '
```
```ts JS Client theme={null}
const { variants, count } = await client.admin.products.$id.variants.query({
$id: "prod_01HXYZABCDEF",
limit: 20,
})
```
```json 200 theme={null}
{
"variants": [
{
"id": "variant_01HXYZABCDEF",
"title": "M",
"sku": "LS-M",
"product_id": "prod_01HXYZABCDEF",
"manage_inventory": false,
"allow_backorder": false,
"variant_rank": 0
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```