Get SKU by ID

Retrieve information about a specific SKU given the sku_id.

Get Sku by ID

get

Path parameters

sku_idinteger · int64Required

Query parameters

base_currencystringOptional

includestring · enumOptional

Comma-separated list of extra data to be included.

Default: sku_dimensionsPossible values:

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Responses

default

default response

application/json

get

/catalog/skus/{sku_id}

HTTPcURLJavaScriptPython

GET /v1/catalog/skus/{sku_id} HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Accept: */*

default

default response

{
  "id": 1,
  "offer_id": 1,
  "merchant_id": 1,
  "external_id": "text",
  "name": "text",
  "asin": "text",
  "gtin": "text",
  "upc": "text",
  "ean": "text",
  "isbn": "text",
  "in_stock": true,
  "qty_available": 1,
  "inventory_tracked": true,
  "sale_price": 1,
  "retail_price": 1,
  "currency": "text",
  "external_currency": "text",
  "presented_currency": "text",
  "taxable": true,
  "tax_type": "DEFAULT",
  "albums": [
    {
      "id": 1,
      "parent_id": 1,
      "type": "OFFER",
      "name": "text",
      "media": [
        {
          "id": 1,
          "album_id": 1,
          "external_id": "text",
          "cloud_id": "text",
          "url": "text",
          "source_url": "text",
          "type": "IMAGE",
          "display_order": 1,
          "alt_text": "text",
          "primary": true
        }
      ],
      "primary_media": {
        "id": 1,
        "album_id": 1,
        "external_id": "text",
        "cloud_id": "text",
        "url": "text",
        "source_url": "text",
        "type": "IMAGE",
        "display_order": 1,
        "alt_text": "text",
        "primary": true
      }
    }
  ],
  "variant_values": [
    {
      "variant": "text",
      "value": "text"
    }
  ],
  "type": "PHYSICAL",
  "status": "UNAVAILABLE",
  "date_created": "2025-12-23T13:33:22.643Z",
  "date_last_modified": "2025-12-23T13:33:22.643Z",
  "sku_dimensions": {
    "sku_id": 1,
    "weight": 1,
    "height": 1,
    "width": 1,
    "length": 1,
    "type": "SKU"
  },
  "shipping_dimensions": {
    "sku_id": 1,
    "weight": 1,
    "height": 1,
    "width": 1,
    "length": 1,
    "type": "SKU"
  },
  "metadata": [
    {
      "version": 1,
      "type": "STRING",
      "external_type": "text",
      "key": "text",
      "value": {},
      "external_id": "text",
      "source": "INTERNAL"
    }
  ],
  "display_order": 1
}