Get information about a product’s variants

How to get details for each variant of a specified product including an image and whether each variant is in stock.

A product can have one or more variants with each size / colour permutation as a different variant. For example, if a dress we stock is available in black or red and sizes 8, 10, 12 that product will have 6 variants, each representing a different combination. Variants are what the user actually adds to the basket and they relate directly to physical items of stock in our warehouse.

Think of the Product item as representing the idea of a product (eg “ASOS Wrap Dress with Tie Waist”) and its variants being the detail or the ‘tangible’ items people buy (eg Black, size UK 10). Variants of the same product can have different prices.

URL

HTTP Get

http://api1.asos.com/variants/{productId}/en_API/{currency}?locale={locale}&country={country}&api_key={apiKey}

Parameters

 

Name Type Description Default Value Example Value Optional
currency string The currency to show prices in (more info). GBP EUR no
locale string A parameter to identify the location set on the user's mobile device, which can be used to customize content based on that location. en_GB en_US yes
country string Current geographical location of the device user GB AU yes
productId int Id for the required product. On the ASOS website productId is the same as iid found in the url for a product page
1964745 no
apiKey string Your API key. Request yours here 1a2b3c4d5e6f7g8h9i no

Example Request

http://api1.asos.com/variants/1703489/en_API/GBP?locale=en_US&country=AU&api_key=1a2b3c4d5e6f7g8h9i

Example Response

 

[
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716611,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 6",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1708382,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 8",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1717210,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 10",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716628,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 12",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1713266,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 14",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716809,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 16",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Beige",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1708725,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/beige\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 18",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1709563,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 6",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716593,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 8",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1708412,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 10",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716869,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 12",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716650,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 14",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1710150,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 16",
      "Sku":null,
      "Title":null
   },
   {
      "BasePrice":35.00,
      "Brand":null,
      "Colour":"Red",
      "CurrentPrice":"£35.00",
      "InStock":true,
      "IsInSet":false,
      "PreviousPrice":"",
      "PriceType":"Full",
      "ProductId":1716849,
      "ProductImageUrls":[
         "http:\/\/images.asos.com\/\/inv\/media\/9\/8\/4\/3\/1703489\/red\/image1xxl.jpg"
      ],
      "RRP":"",
      "Size":"UK 18",
      "Sku":null,
      "Title":null
   }
]