Skip to main content
GET
/
2026-01
/
product
/
{productId}
/
variants
Get Product Variants
curl --request GET \
  --url https://sandbox-api.shipbob.com/2026-01/product/{productId}/variants \
  --header 'Authorization: Bearer <token>'
[
  {
    "additional_hazmat_attributes": {
      "charge_state_percentage": 0.1,
      "container_metal": true,
      "container_type": "string",
      "lithium_battery_packaging": "string",
      "lithium_battery_type": "string",
      "magnet": true,
      "net_volume": 0.1,
      "net_weight": 0.1
    },
    "associated_bundles": [
      {
        "product_id": 0,
        "product_name": "string",
        "quantity": 0,
        "variant_id": 0,
        "variant_sku": "string"
      }
    ],
    "barcodes": [
      {
        "sticker_url": "string",
        "value": "string"
      }
    ],
    "bundle_definition": [
      {
        "product_id": 0,
        "quantity": 0,
        "variant_id": 0,
        "variant_name": "string",
        "variant_sku": "string"
      }
    ],
    "channel_metadata": [
      {
        "channel_id": 0,
        "channel_name": "string",
        "currency": "string",
        "id": 0,
        "is_inventory_sync_enabled": true,
        "legacy_product_id": 0,
        "platform": "string",
        "platform_identifier": "string",
        "platform_inventory_item_id": "string",
        "price": 0.1,
        "seller_sku": "string"
      }
    ],
    "created_on": "2019-08-24T14:15:22Z",
    "customs": {
      "country_code_of_origin": "string",
      "currency": "string",
      "description": "string",
      "hs_tariff_code": "string",
      "is321_eligible": true,
      "value": 0
    },
    "dimension": {
      "height": 0.1,
      "is_locked": true,
      "length": 0.1,
      "source": "string",
      "unit": "string",
      "width": 0.1
    },
    "fulfillment_settings": {
      "dangerous_goods": true,
      "is_bpm_parcel": true,
      "is_case_pick": true,
      "msds_url": "string",
      "requires_prop65": true,
      "serial_scan": {
        "exact_character_length": 0,
        "is_enabled": true,
        "prefix": "string",
        "suffix": "string"
      }
    },
    "gtin": "string",
    "id": 0,
    "inventory": {
      "inventory_id": 0,
      "on_hand_qty": 0
    },
    "is_digital": true,
    "is_image_uploaded": true,
    "lot_information": {
      "is_lot": true,
      "minimum_shelf_life_days": 0
    },
    "merge_children": [
      {
        "channel_ids": [
          0
        ],
        "completed_at": "2019-08-24T14:15:22Z",
        "inventory_id": 0,
        "variant_id": 0,
        "variant_name": "string"
      }
    ],
    "name": "string",
    "packaging_material_type": {
      "id": 0,
      "name": "string"
    },
    "packaging_requirement": {
      "id": 0,
      "name": "string"
    },
    "return_preferences": {
      "backup_action": {
        "id": 0,
        "name": "string"
      },
      "instructions": "string",
      "primary_action": {
        "id": 0,
        "name": "string"
      },
      "return_to_sender_backup_action": {
        "id": 0,
        "name": "string"
      },
      "return_to_sender_primary_action": {
        "id": 0,
        "name": "string"
      }
    },
    "reviews_pending": [
      "string"
    ],
    "sku": "string",
    "status": "string",
    "upc": "string",
    "updated_on": "2019-08-24T14:15:22Z",
    "weight": {
      "unit": "string",
      "weight": 0.1
    }
  }
]

Authorizations

​
Authorization
string
header
required

Authentication using Personal Access Token (PAT) token

Path Parameters

​
productId
string<int64>
required

The product id

Response

Success

​
additional_hazmat_attributes
object

Additional hazardous materials attributes for lithium batteries and dangerous goods

​
associated_bundles
object[] | null

List of bundle products that include this variant as a component

​
bundle_definition
object[] | null

If this variant is a bundle, defines which variants and quantities make up the bundle

​
created_on
string<date-time>

Timestamp when the variant was created

​
customs
object

Customs and international shipping information (tariff codes, country of origin, declared value)

​
dimension
object

Physical dimensions of the variant (length, width, height)

​
fulfillment_settings
object

Fulfillment-specific settings (Prop 65, dangerous goods, serial scanning, case pick)

​
gtin
string | null

Global Trade Item Number - standardized product identifier

​
id
integer<int64>

Unique identifier for the variant

​
inventory
object

Current inventory information including on-hand quantity

​
is_digital
boolean

Flag indicating whether this is a digital product (no physical fulfillment)

​
is_image_uploaded
boolean

Flag indicating whether a product image has been uploaded for this variant

​
lot_information
object

Lot tracking settings including whether lot tracking is enabled and minimum shelf life requirements

​
merge_children
object[] | null

List of variants that have been merged into this variant

​
name
string | null

Variant name or descriptor

​
packaging_material_type
object

Type of packaging material used for this variant (ID and name)

​
packaging_requirement
object

Special packaging requirements for this variant (ID and name)

​
return_preferences
object

Customer return handling preferences including primary and backup actions

​
reviews_pending
string[] | null

List of pending review types for this variant (e.g., compliance checks, quality reviews)

​
sku
string | null

Stock Keeping Unit - unique identifier for the variant used in inventory management

​
status
string | null

Current status of the variant (e.g., 'Active', 'Inactive')

​
upc
string | null

Universal Product Code - 12-digit barcode identifier

​
updated_on
string<date-time> | null

Timestamp when the variant was last updated

​
weight
object

Weight of the variant including unit of measure

​
barcodes
object[] | null

List of barcodes associated with this variant (UPC, EAN, etc.)

​
channel_metadata
object[] | null

Platform-specific metadata for sales channels (e.g., Amazon ASIN, Shopify product IDs)