List variants by SKU

GET 
/openapi/2025-06/products/sku/:sku/variants

Retrieve a list of all variants for a specific SKU.

Request

Path Parameters

sku stringrequired

The variant SKU to list

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object
variants object[]
The list of variants
Array [
idstring
The unique identifier of the variant
product_idstring
The product ID this variant belongs to
image_idstring
The image ID of the variant
created_atstring
The time of the variant was created
updated_atstring
The time of the variant was updated
titlestring
Title of the variant
option1string
The first option of the variant
option2string
The second option of the variant
option3string
The third option of the variant
image object
The image of the variant
srcstring
Image's URL
widthint32
Image's width in px
heightint32
Image's height in px
altstring
Image's alt
pathstring
Image's path
positionint64
The position of the variant in the product
compare_at_pricedouble
The compare at price of the variant
pricedouble
The price of the variant
skustring
The SKU of the variant
barcodestring
The barcode of the variant
notestring
The note of the variant
inventory_quantityint64
The inventory quantity of the variant
weightdouble
The weight of the variant
weight_unitstring
The weight unit of the variant, possible value are: kg, g, lb, oz
cost_pricedouble
The cost price of the variant
whole_prices object[]
The whole prices of the variant
Array [
pricedoublerequired
Price
min_quantityint64required
Mini Order Quantity
]
retail_pricedouble
The retail price of the variant
is_discountboolean
Whether the variant is discount
origin_pricedouble
The origin price of the variant
extend object
Extend of the variant
lengthdouble
The length of the variant
widthdouble
The width of the variant
heightdouble
The height of the variant
dimension_unitstring
The dimension unit
origin_country_codestring
Origin_country_code
hs_codestring
Hs_code
]

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "variants": [
      {
        "id": "string",
        "product_id": "string",
        "image_id": "string",
        "created_at": "string",
        "updated_at": "string",
        "title": "string",
        "option1": "string",
        "option2": "string",
        "option3": "string",
        "image": {
          "src": "string",
          "width": 0,
          "height": 0,
          "alt": "string",
          "path": "string"
        },
        "position": 0,
        "compare_at_price": 0,
        "price": 0,
        "sku": "string",
        "barcode": "string",
        "note": "string",
        "inventory_quantity": 0,
        "weight": 0,
        "weight_unit": "string",
        "cost_price": 0,
        "whole_prices": [
          {
            "price": 0,
            "min_quantity": 0
          }
        ],
        "retail_price": 0,
        "is_discount": true,
        "origin_price": 0,
        "extend": {
          "length": 0,
          "width": 0,
          "height": 0,
          "dimension_unit": "string",
          "origin_country_code": "string",
          "hs_code": "string"
        }
      }
    ]
  }
}