GET{shop_id}/variants/{id or sku}

Retrieve a product variant.

This relation is only available for products owned by your current access token (admin scope).


$ curl -XGET -H'Accept:application/json' -H'Content-Type:application/json' -H "Authorization: Bearer xxxx" -i

Successful response

Status: 200 OK
Content-Type: application/json; charset=utf-8
Connection: keep-alive
ETag: "0728e2965bd03e20a7f1c33add2f8775"
Last-Modified: Fri, 20 Jun 2014 22:34:14 GMT
Cache-Control: must-revalidate, private, max-age=0
Date: Wed, 31 Jul 2013 21:11:52 GMT
X-OAuth-Scopes: admin
  "_class": [
  "_links": {
    "self": {
      "href": ""
    "btc:update_variant": {
      "href": "",
      "title": "Update a product variant",
      "method": "put"
    "btc:delete_variant": {
      "href": "",
      "title": "Remove a product variant",
      "method": "delete"
  "title": "Some variant",
  "id": 145812,
  "stock": 100,
  "available_if_no_stock": true,
  "sku": "sv-123",
  "weight_in_grams": 230,
  "price": 12333,
  "price_comparison": 122234

A succesful response returns a variant entity including links to further actions.
See update_variant,create_variant and delete_variant for more.

Retrieving a variant by SKU

Optionally, you can identify a variant by its SKU (Stock Keeping Unit), which is unique per shop, instead of its :id. So for a variant with SKU “abc” and shop id “123”, do this:


This can be useful when syncronizing data directly from 3rd party data sources.