--- title: "Product Detail" method: GET path: "/v1/products/{product_id}" tags: ["v1"] --- # Product Detail `GET /v1/products/{product_id}` Get detailed information about a specific product by its ID. ## Path parameters - `product_id` string, required ## Query parameters - `website_ids` string[], nullable — Optional list of website IDs to constrain the buy URL to, relevant if multiple merchants exist. Accepts website IDs or domains (e.g. "nike.com"). - `language` 'en' | 'de' | 'fr' | 'it' | 'es' | 'nl' | 'sv' | 'fi' | 'pt' | 'cs' | 'el' | 'ro', nullable — ISO 639-1 language code. Matches any language when unset; defaults to 'en' only when country and currency are also unset. - `country` 'US' | 'GB' | 'EU' | 'AU' | 'CA' | 'IE' | 'DE' | 'AT' | 'FR' | 'BE' | 'IT' | 'ES' | 'NL' | 'SE' | 'FI' | 'PT' | 'CZ' | 'GR' | 'RO', nullable — ISO 3166-1 alpha-2 country code. Matches any country when unset; defaults to 'US' only when language and currency are also unset. - `currency` 'USD' | 'CAD' | 'AUD' | 'GBP' | 'EUR' | 'SEK' | 'CZK' | 'RON', nullable — ISO 4217 currency code. When unset, inferred from `country` (e.g. GB -> GBP); falls back to 'USD' only when all three locale fields are unset. - `length_unit` 'mm' | 'cm' | 'm' | 'in' | 'ft' - `weight_unit` 'mg' | 'g' | 'kg' | 'oz' | 'lb' ## Response `200` Successful Response - Product — Product with detailed information. - `id` string, required - `title` string, required - `description` string, nullable - `brands` ProductBrand[] — Ordered list of brands. - `id` string, required - `name` string, required - `images` ProductImage[] - `url` string, required - `cleaned_url` string, nullable — Background-removed square image on Channel3 CDN when available. Use for product grids; ``url`` is the regular hosted shot. - `is_main_image` boolean - `is_cleaned_image` boolean — Deprecated: always ``false``. Use ``cleaned_url`` for product grids when set; otherwise ``url``. - `shot_type` 'hero' | 'lifestyle' | 'on_model' | 'detail' | 'scale_reference' | 'angle_view' | 'flat_lay' | 'in_use' | 'packaging' | 'size_chart' | 'product_information' | 'merchant_information' — Product image type classification for API responses. - `alt_text` string, nullable - `categories` string[] - `category` CategorySummary — Lean category representation used in search hits and list rows. - `slug` string, required — URL-friendly slug (e.g. 'sofas') - `title` string, required — Human-readable category title - `path` CategoryRef[] — Hierarchical path as a structured list, root first; the last entry is this category itself - `slug` string, required — URL-friendly slug (e.g. 'sofas') - `title` string, required — Human-readable category title - `has_children` boolean, required — Whether this category has subcategories - `gender` 'male' | 'female' | 'unisex', nullable - `age` 'newborn' | 'infant' | 'toddler' | 'kids' | 'adult', nullable — Target age group. Age-agnostic products are typically returned as 'adult'. - `materials` string[], nullable - `key_features` string[], nullable - `offers` ProductOffer[] — All merchant offers for this product in the requested locale. - `url` string, required - `domain` string, required - `price` Price, required - `price` number, required — The current price of the product, including any discounts. - `compare_at_price` number, nullable — The original price of the product before any discounts. - `currency` string, required — The currency code of the product, like USD, EUR, GBP, etc. - `availability` 'InStock' | 'OutOfStock', required - `condition` 'new' | 'refurbished' | 'used', nullable — Condition of this merchant offer (new, used, or refurbished). Null when condition is unknown. - `max_commission_rate` number — The maximum commission rate for the merchant, as a decimal fraction: 0 is no commission, 0.5 is 50% commission. 'Max' because the actual commission rate may be lower due to vendor-specific affiliate rules. - `dimensions` Dimensions — Physical dimensions of a product offer. Members are null when unknown. Values are standardized to the supported unit set; a merchant-stated value whose unit is not one of those units is omitted rather than shown. - `length` LengthDimension — A length measurement, in one of the supported length units. - `number` number, required - `unit` 'mm' | 'cm' | 'm' | 'in' | 'ft', required - `width` LengthDimension — A length measurement, in one of the supported length units. - `number` number, required - `unit` 'mm' | 'cm' | 'm' | 'in' | 'ft', required - `height` LengthDimension — A length measurement, in one of the supported length units. - `number` number, required - `unit` 'mm' | 'cm' | 'm' | 'in' | 'ft', required - `weight` WeightDimension — A weight measurement, in one of the supported weight units. - `number` number, required - `unit` 'mg' | 'g' | 'kg' | 'oz' | 'lb', required - `variants` Variants — Wrapper for variant-interaction state on a Product. Holds `options` and `selected`. `options` represent all of the configuration options for the product. `selected` represents the currently selected option values. - `options` VariantOption[], required - `name` string, required — The name of the option (e.g. 'Color', 'Size') - `values` OptionValue[], required — The values of the option (e.g. ['Blue', 'Red', 'Green']) - `label` string, required — The display value of the option value (e.g. 'Blue') - `exists` boolean, required — Whether the option value exists on the product, or is a configuration only present on another variant of the same product. For example, a shirt that comes in multiple colors, but only one color is available in Size XL. - `available` 'InStock' | 'LimitedAvailability' | 'PreOrder' | 'BackOrder' | 'SoldOut' | 'OutOfStock' | 'Discontinued' | 'Unknown' - `thumbnail_url` string, nullable — For options that reference different products, this is the URL of the thumbnail image for the option value. E.g., a shoe that comes in multiple colors will have an OptionValue for each color with a thumbnail_url set. - `product_id` string, nullable — The product id that represents this value. Variants that point to different products will have this field set, as well as thumbnail_url for displaying selector icons. - `selected` SelectedOption[], required - `name` string, required — The name of the selected option (e.g. 'Color', 'Size') - `label` string, required — The display value of the selected option (e.g. 'Blue', 'XL') - `structured_attributes` object — Structured attributes extracted for this product, keyed by attribute handle (e.g. 'color', 'material'). Values are the canonical allowed values for that handle. ## Other responses - `401` — Unauthorized - Invalid or missing authentication - `402` — Payment required - `404` — Product not found - `422` — Validation Error - `500` — Internal Server Error ## Changes - **2026-07-29** `1200b0ff4724` — 1 info - response property `images/items/is_cleaned_image` deprecated - **2026-07-29** `e235d378571b` — 1 info - added the optional property `images/items/cleaned_url` to the response with the `200` status - **2026-07-09** `5e0c73f4bbb1` — 2 warning, 2 info - deleted the `query` request parameter `preferred_length_unit` - deleted the `query` request parameter `preferred_weight_unit` - added the new optional `query` request parameter `length_unit` - added the new optional `query` request parameter `weight_unit` - **2026-07-09** `cd7de4a95828` — 3 info - added the new optional `query` request parameter `preferred_length_unit` - added the new optional `query` request parameter `preferred_weight_unit` - added the optional property `offers/items/dimensions` to the response with the `200` status - **2026-06-19** `1adfb8c09586` — 1 info - added the optional property `offers/items/condition` to the response with the `200` status [Full history](https://skmtc.dev/channel3-ai/apis/fastapi/changes/v1/products/:product_id/get.md) --- [API](https://skmtc.dev/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.dev/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/channel3-ai/apis/fastapi/revisions/981d371bd83e?raw)