Skip to main content
GET
/
admin
/
products
/
{id}
/
variants
curl 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/variants?limit=20' \
  -H 'Authorization: Bearer <token>'

{
  "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
}
Returns the variants of a single product, with optional filtering by SKU and identifiers.

​
Path parameters

​
id
string
required
The product’s ID.

​
Query parameters

​
limit
number
default:"50"
Maximum number of records to return.
​
offset
number
default:"0"
Number of records to skip.
​
order
string
Field to sort by, prefix with - for descending order.
​
fields
string
Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.
​
q
string
Search term matched against variant fields.
​
id
string | string[]
Filter by variant ID(s).
​
sku
string
Filter by SKU.
​
ean
string
Filter by EAN.
​
upc
string
Filter by UPC.
​
barcode
string
Filter by barcode.

​
Response

​
variants
object[]
​
count
number
Total number of matching variants.
​
offset
number
Number of records skipped.
​
limit
number
Number of records returned.
curl 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/variants?limit=20' \
  -H 'Authorization: Bearer <token>'

{
  "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
}