SKUs

What is a SKU?

A SKU (Stock Keeping Unit) represents an individual item that a shopper can purchase. One Offer can have multiple SKUs. Shoppers cannot purchase an Offer directly, only a SKU, since a SKU is a specific combination of ‘variants’ that represent an actual item.

For instance, an Offer may represent a t-shirt. This shirt may have variant options for COLOR and SIZE. The combination of the RED color variant option and the MEDIUM size variant option creates the individual SKU.

SKU Data

Each SKU has its own unique ID. SKU data includes specific details about a product, such as quantity available and pricing information.

You can access individual SKU data within the Offer Object, or retrieve data for a specific SKU by using its ID.

Here is an example of a SKU as part of the Offer object:

{
    "id": 39045,
    "product_id": "8d8c749c469b45e795f458360e2fc4be",
    "external_id": "8335172993325",
    "external_url": "https://the-violet-garden.myshopify.com/products/rouge-fire-flower-t-shirt",
    "name": "Shirt",
    "description": "Pastel-red flower design, short-sleeved t-shirt. Designed to keep you cool when you need to be cool and hot when you need to be hot. This shirt looks great on a sunny day under a blue sky.",
    "source": "SHOPIFY",
    "seller": "the violet garden",
    "vendor": "The Violet Garden",
    "merchant_id": 10189,
    "available": true,
    "visible": true,
    "min_price": 3000,
    "max_price": 3000,
    "currency": "USD",
    "source_category_name": "",
    "meta": [],
    "variants": [ ... ],
    "skus": [
        {
            "id": 196701,
            "offer_id": 39045,
            "merchant_id": 10189,
            "external_id": "45101095092525",
            "name": "Shirt - Large / Design Three / Red",
            "gtin": "",
            "upc": "",
            "in_stock": true,
            "qty_available": 100,
            "inventory_tracked": true,
            "sale_price": 3000,
            "retail_price": 3000,
            "currency": "USD",
            "taxable": true,
            "tax_type": "DEFAULT",
            "albums": [],
            "variant_values": [
                {
                    "variant": "Style",
                    "value": "Design Three"
                },
                {
                    "variant": "Size",
                    "value": "Large"
                },
                {
                    "variant": "Color",
                    "value": "Red"
                }
            ],
            "type": "PHYSICAL",
            "status": "AVAILABLE",
            "date_created": "2023-05-01T20:08:25+0000",
            "date_last_modified": "2023-06-29T23:58:33+0000",
            "sku_dimensions": {
                "weight": 0.0,
                "type": "SKU"
            }
        },
        {
            "id": 196697,
            "offer_id": 39045,
            "merchant_id": 10189,
            "external_id": "45101095059757",
            "name": "Shirt - Large / Design Two / Red",
            "gtin": "",
            "upc": "",
            "in_stock": true,
            "qty_available": 100,
            "inventory_tracked": true,
            "sale_price": 3000,
            "retail_price": 3000,
            "currency": "USD",
            "taxable": true,
            "tax_type": "DEFAULT",
            "albums": [],
            "variant_values": [
                {
                    "variant": "Size",
                    "value": "Large"
                },
                {
                    "variant": "Color",
                    "value": "Red"
                },
                {
                    "variant": "Style",
                    "value": "Design Two"
                }
            ],
            "type": "PHYSICAL",
            "status": "AVAILABLE",
            "date_created": "2023-05-01T20:08:25+0000",
            "date_last_modified": "2023-06-29T23:58:33+0000",
            "sku_dimensions": {
                "weight": 0.0,
                "type": "SKU"
            }
        },
        {
            "id": 196705,
            "offer_id": 39045,
            "merchant_id": 10189,
            "external_id": "45101094797613",
            "name": "Shirt - Small / Design Two / Red",
            "gtin": "",
            "upc": "",
            "in_stock": true,
            "qty_available": 99,
            "inventory_tracked": true,
            "sale_price": 3000,
            "retail_price": 3000,
            "currency": "USD",
            "taxable": true,
            "tax_type": "DEFAULT",
            "albums": [
                {
                    "id": 90993,
                    "parent_id": 196705,
                    "type": "SKU",
                    "name": "Rouge Fire Flower T-Shirt - Small / Design Two Media",
                    "media": [
                        {
                            "id": 185704,
                            "album_id": 90993,
                            "external_id": "41483613471021",
                            "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                            "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                            "type": "IMAGE",
                            "display_order": 1,
                            "primary": true
                        }
                    ],
                    "primary_media": {
                        "id": 185704,
                        "album_id": 90993,
                        "external_id": "41483613471021",
                        "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                        "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                        "type": "IMAGE",
                        "display_order": 1,
                        "primary": true
                    }
                }
            ],
            "variant_values": [
                {
                    "variant": "Size",
                    "value": "Small"
                },
                {
                    "variant": "Color",
                    "value": "Red"
                },
                {
                    "variant": "Style",
                    "value": "Design Two"
                }
            ],
            "type": "PHYSICAL",
            "status": "AVAILABLE",
            "date_created": "2023-05-01T20:08:25+0000",
            "date_last_modified": "2023-06-29T23:58:33+0000",
            "sku_dimensions": {
                "weight": 0.0,
                "type": "SKU"
            }
        },
        ...
    ],
    "albums": [
        {
            "id": 90990,
            "parent_id": 39045,
            "type": "OFFER",
            "name": "Primary Album",
            "media": [
                {
                    "id": 185779,
                    "album_id": 90990,
                    "external_id": "41483613339949",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_e963dc9b-12e7-4b1e-96bb-97dc1b061cbc.png",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_e963dc9b-12e7-4b1e-96bb-97dc1b061cbc.png",
                    "type": "IMAGE",
                    "display_order": 1,
                    "primary": true
                },
                {
                    "id": 185780,
                    "album_id": 90990,
                    "external_id": "41483613405485",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_a80ec00e-eae1-41e4-8d6b-81c64bbc8f52.png",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_a80ec00e-eae1-41e4-8d6b-81c64bbc8f52.png",
                    "type": "IMAGE",
                    "display_order": 2,
                    "primary": false
                },
                {
                    "id": 185781,
                    "album_id": 90990,
                    "external_id": "41483613274413",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/grid_0.webp",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/grid_0.webp",
                    "type": "IMAGE",
                    "display_order": 3,
                    "primary": false
                },
                {
                    "id": 185782,
                    "album_id": 90990,
                    "external_id": "41483613372717",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_d2f90fab-7ac4-4161-b710-5363f1b4e244.png",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_d2f90fab-7ac4-4161-b710-5363f1b4e244.png",
                    "type": "IMAGE",
                    "display_order": 5,
                    "primary": false
                },
                {
                    "id": 185783,
                    "album_id": 90990,
                    "external_id": "41483613438253",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_d90ec5f7-a1a7-43c6-bdf9-38f7ff5764b9_1.png",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_d90ec5f7-a1a7-43c6-bdf9-38f7ff5764b9_1.png",
                    "type": "IMAGE",
                    "display_order": 6,
                    "primary": false
                },
                {
                    "id": 185778,
                    "album_id": 90990,
                    "external_id": "41483613471021",
                    "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                    "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_b6d58e24-200e-42b9-86c4-8feeaf4bc8e6.png",
                    "type": "IMAGE",
                    "display_order": 4,
                    "primary": false
                }
            ],
            "primary_media": {
                "id": 185779,
                "album_id": 90990,
                "external_id": "41483613339949",
                "url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_e963dc9b-12e7-4b1e-96bb-97dc1b061cbc.png",
                "source_url": "https://cdn.shopify.com/s/files/1/0758/9363/7421/files/wealthy_floral_design_tshirt_with_a_red_pastel_colour_backgroun_e963dc9b-12e7-4b1e-96bb-97dc1b061cbc.png",
                "type": "IMAGE",
                "display_order": 1,
                "primary": true
            }
        }
    ],
    "three_denabled": false,
    "type": "PHYSICAL",
    "status": "AVAILABLE",
    "publishing_status": "PUBLISHED",
    "date_created": "2023-05-01T20:08:25+0000",
    "date_last_modified": "2023-06-29T23:58:33+0000",
    "commission_rate": 25.0,
    "currency_symbol": "$",
    "subscription_status": "NOT_SUBSCRIBED",
    "tags": [
        "madebymidjourney"
    ]
}

Here is an example of a SKU object in isolation:

{
            "id": 196701,
            "offer_id": 39045,
            "merchant_id": 10189,
            "external_id": "45101095092525",
            "name": "Shirt - Large / Design Three / Red",
            "gtin": "",
            "upc": "",
            "in_stock": true,
            "qty_available": 100,
            "inventory_tracked": true,
            "sale_price": 3000,
            "retail_price": 3000,
            "currency": "USD",
            "taxable": true,
            "tax_type": "DEFAULT",
            "albums": [],
            "variant_values": [
                {
                    "variant": "Style",
                    "value": "Design Three"
                },
                {
                    "variant": "Size",
                    "value": "Large"
                },
                {
                    "variant": "Color",
                    "value": "Red"
                }
            ],
            "type": "PHYSICAL",
            "status": "AVAILABLE",
            "date_created": "2023-05-01T20:08:25+0000",
            "date_last_modified": "2023-06-29T23:58:33+0000",
            "sku_dimensions": {
                "weight": 0.0,
                "type": "SKU"
            }
        }

You can learn more about how to interact with SKUs in our API Reference.

Introduction

Getting Started

Checkout

Violet Connect

Relay

Product Info

Support

What is a SKU?

SKU Data

Introduction

Getting Started

Checkout

Violet Connect

Relay

Product Info

Support

​What is a SKU?

​SKU Data

What is a SKU?

SKU Data