# Product

Product detail and variant information

## Retrieve product detail page

> Returns comprehensive product information for a detail page, including pricing, stock availability, images, videos, and variant selection options.\
> \
> \*\*Response Behavior:\*\*\
> \
> \*\*1. Standard Product Response\*\*\
> \* Returns complete product data with all variant options\
> \* Includes currently selected variant based on query parameters\
> \* Provides pricing from default or inventory-specific price lists\
> \
> \*\*2. Variant Selection\*\*\
> \* Pass attribute keys as query parameters to pre-select variants\
> \* System returns matching variant as \`selected\_variant\`\
> \* Variant options indicate selectable combinations\
> \
> \*\*3. Automatic Redirects\*\*\
> When a product is not directly listable, the system may redirect:\
> \* Non-listable products redirect to their parent product\
> \* Query parameters are preserved during redirection\
> \* Variant attributes are included in redirect URL\
> \
> \*\*4. Availability Handling\*\*\
> \* Products marked as end-of-life with no stock return 404\
> \* Hidden products are only visible to configured test users \*(Source: Dynamic/Real-time Configuration)\*

```json
{"openapi":"3.1.0","info":{"title":"Product API - Product Catalog & Detail Information","version":"1.0.0"},"tags":[{"name":"Product","description":"Product detail and variant information"}],"servers":[{"description":"Commerce API Server","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL (e.g., your-store.akinon.com)"}}}],"paths":{"/product/{product_id}/":{"get":{"tags":["Product"],"operationId":"getProductDetail","summary":"Retrieve product detail page","description":"Returns comprehensive product information for a detail page, including pricing, stock availability, images, videos, and variant selection options.\n\n**Response Behavior:**\n\n**1. Standard Product Response**\n* Returns complete product data with all variant options\n* Includes currently selected variant based on query parameters\n* Provides pricing from default or inventory-specific price lists\n\n**2. Variant Selection**\n* Pass attribute keys as query parameters to pre-select variants\n* System returns matching variant as `selected_variant`\n* Variant options indicate selectable combinations\n\n**3. Automatic Redirects**\nWhen a product is not directly listable, the system may redirect:\n* Non-listable products redirect to their parent product\n* Query parameters are preserved during redirection\n* Variant attributes are included in redirect URL\n\n**4. Availability Handling**\n* Products marked as end-of-life with no stock return 404\n* Hidden products are only visible to configured test users *(Source: Dynamic/Real-time Configuration)*","parameters":[{"name":"product_id","in":"path","required":true,"description":"Unique identifier of the product to retrieve.\n\nThis ID corresponds to the product's primary key in the catalog system.","schema":{"type":"integer"}},{"name":"seller_id","in":"query","required":false,"description":"Filter product data for a specific seller.\n\nWhen provided, returns seller-specific pricing and stock information. Useful for marketplace scenarios with multiple sellers offering the same product.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Product detail retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"302":{"description":"Redirect to an alternative product URL.\n\nOccurs when:\n* The requested product is not listable but has a listable parent\n* The product type requires redirection to a variant","headers":{"Location":{"description":"URL of the alternative product to display","schema":{"type":"string","format":"uri"}}}},"404":{"description":"Product not found or not accessible.\n\nOccurs when:\n* No product exists with the specified ID\n* Product is hidden and user is not authorized\n* Product is marked as end-of-life with no remaining stock"}}}}},"components":{"schemas":{"ProductDetailResponse":{"type":"object","description":"Complete product detail response including variant selection data.\n\nContains all information needed to render a product detail page.","required":["in_stock","product","variants"],"properties":{"in_stock":{"type":"boolean","description":"Indicates if any variant of this product is currently in stock.\n\nThis is an aggregate status across all sub-products/variants."},"product":{"$ref":"#/components/schemas/Product"},"variants":{"type":"array","description":"List of variant attribute groups with selectable options.\n\nEach item represents one attribute dimension (e.g., Size, Color) with available options.","items":{"$ref":"#/components/schemas/VariantGroup"}},"selected_variant":{"oneOf":[{"$ref":"#/components/schemas/Product"},{"type":"null"}],"description":"The currently selected variant based on query parameters.\n\n**Null Scenarios:**\n* No variant attributes provided in query\n* Provided attributes don't match any available variant\n* Selected combination is out of stock (when stock check is enforced)"},"offers":{"type":"array","description":"Alternative seller offers for this product.\n\nAvailable in marketplace scenarios where multiple sellers offer the same product.","items":{"$ref":"#/components/schemas/ProductOffer"}}}},"Product":{"type":"object","description":"Core product information including pricing, stock, and attributes.","required":["pk","name","sku","base_code","price","in_stock","product_type"],"properties":{"pk":{"type":"integer","description":"Unique product identifier"},"name":{"type":"string","description":"Display name of the product.\n\nMay be translated based on active language settings."},"sku":{"type":"string","description":"Stock Keeping Unit - unique product code for inventory management."},"base_code":{"type":"string","description":"Base product code shared across variants.\n\nAll size/color variants of the same product share this code."},"attributes":{"type":"object","description":"Product attributes as key-value pairs.\n\nContains both variant-defining attributes (size, color) and descriptive attributes (material, weight).","additionalProperties":true},"attribute_set":{"type":"integer","description":"ID of the attribute set that defines this product's attribute schema."},"attributes_kwargs":{"type":"object","description":"Extended attribute metadata including labels and display values.\n\nProvides translated attribute names and formatted values for display.","additionalProperties":true},"extra_attributes":{"type":["object","null"],"description":"Additional custom attributes not part of the standard attribute set.","additionalProperties":true},"productimage_set":{"type":"array","description":"Product images in multiple sizes and formats.","items":{"$ref":"#/components/schemas/ProductImage"}},"productvideo_set":{"type":"array","description":"Product videos for enhanced product presentation.","items":{"$ref":"#/components/schemas/ProductVideo"}},"price":{"type":"string","description":"Current selling price as a decimal string.\n\nFormat: \"123.45\" (two decimal places)"},"retail_price":{"type":"string","description":"Original retail/list price before discounts.\n\nCompare with `price` to calculate discount percentage."},"currency_type":{"type":"string","description":"Currency code for price values.\n\nCommon values: \"try\" (Turkish Lira), \"usd\", \"eur\""},"price_type":{"type":"string","description":"Price category or tier identifier."},"tax_rate":{"type":"string","description":"Applicable tax rate as a decimal percentage.\n\nExample: \"18.00\" represents 18% tax"},"in_stock":{"type":"boolean","description":"Stock availability status for this specific product/variant."},"stock":{"type":"integer","description":"Available stock quantity.\n\nMay be from default stock or inventory-specific stock list."},"unit_type":{"type":"string","description":"Unit of measurement for stock.\n\nCommon values: \"quantity\", \"kg\", \"meter\""},"product_type":{"type":"string","description":"Product classification type.\n\n| Value | Code | Description |\n|-------|------|-------------|\n| 0 | simple | Standard product with optional variants |\n| 1 | product_meta | Parent product that groups variants |\n| 2 | bundle | Configurable product with chapters |\n| 3 | grouped | Collection of related products sold together |\n| 4 | miscellaneous | Special product (services, fees) |\n| 5 | offer | Seller-specific product offer |","enum":["0","1","2","3","4","5"]},"absolute_url":{"type":"string","format":"uri","description":"Canonical URL for this product.\n\nUse this for SEO-friendly product links."},"form_schema":{"type":"array","description":"Form field definitions for products requiring additional input.\n\nUsed for personalized products, custom engravings, etc.","items":{"$ref":"#/components/schemas/AttributeConfigForm"}},"is_ready_to_basket":{"type":"boolean","description":"Indicates if the product can be directly added to basket.\n\nFalse when variant selection or additional input is required."},"data_source":{"oneOf":[{"$ref":"#/components/schemas/DataSource"},{"type":"null"}],"description":"Seller/data source information for marketplace products."},"basket_offers":{"type":"array","description":"Promotional offers applicable when this product is in the basket.","items":{"type":"object"}},"is_listable":{"type":"boolean","description":"Indicates if the product should appear in product listings.\n\nNon-listable products may only be accessible via direct URL."},"listing_code":{"type":"string","description":"Code used for product listing grouping."}}},"ProductImage":{"type":"object","description":"Product image with multiple size variants","properties":{"pk":{"type":"integer","description":"Image identifier"},"status":{"type":"string","description":"Image processing status"},"image":{"type":"string","format":"uri","description":"Original image URL"},"order":{"type":"integer","description":"Display order (lower numbers appear first)"},"thumbnail":{"type":"string","format":"uri","description":"Thumbnail size image URL"},"mid_thumbnail":{"type":"string","format":"uri","description":"Medium thumbnail URL"},"detailed_thumbnail":{"type":"string","format":"uri","description":"Detailed/larger thumbnail URL"}}},"ProductVideo":{"type":"object","description":"Product video information","properties":{"pk":{"type":"integer","description":"Video identifier"},"video_type":{"type":"string","description":"Video hosting platform type.\n\nCommon values: \"youtube\", \"vimeo\", \"self_hosted\""},"video":{"type":"string","format":"uri","description":"Video URL or embed code"}}},"AttributeConfigForm":{"type":"object","description":"Form field configuration for product customization inputs.","properties":{"key":{"type":"string","description":"Field identifier"},"label":{"type":"string","description":"Field display label"},"type":{"type":"string","description":"Input type.\n\nCommon values: \"text\", \"textarea\", \"select\", \"file\""},"required":{"type":"boolean","description":"Whether the field is required"},"options":{"type":"array","items":{"type":"object"},"description":"Available options for select fields"}}},"DataSource":{"type":"object","description":"Seller or data source information.","properties":{"pk":{"type":"integer","description":"Data source identifier"},"name":{"type":"string","description":"Internal name"},"title":{"type":"string","description":"Display title"},"slug":{"type":"string","description":"URL-friendly identifier"}}},"VariantGroup":{"type":"object","description":"A group of variant options for a single attribute dimension.\n\nEach variant group represents one selectable attribute (e.g., all available sizes).","required":["attribute_key","attribute_name","options"],"properties":{"attribute_key":{"type":"string","description":"Internal key for this attribute.\n\nUsed as query parameter name for variant selection."},"attribute_name":{"type":"string","description":"Human-readable attribute name for display.\n\nMay be translated based on language settings."},"options":{"type":"array","description":"Available options within this attribute group.","items":{"$ref":"#/components/schemas/VariantOption"}}}},"VariantOption":{"type":"object","description":"A single selectable variant option within an attribute group.","required":["label","value","is_selected","is_selectable"],"properties":{"is_selected":{"type":"boolean","description":"Indicates if this option is currently selected.\n\nBased on query parameters or default selection logic."},"is_selectable":{"type":"boolean","description":"Indicates if this option can be selected given current selections.\n\nFalse when the combination with other selected attributes is unavailable."},"is_selectable_without_stock":{"type":["boolean","null"],"description":"Indicates if this option would be selectable ignoring stock status.\n\nUseful for showing \"out of stock\" vs. \"invalid combination\" states."},"in_stock":{"type":["boolean","null"],"description":"Stock status for this specific option combination."},"order":{"type":"string","description":"Display order for this option."},"label":{"type":"string","description":"Display label for this option."},"value":{"type":"string","description":"Internal value for this option.\n\nUsed as query parameter value for variant selection."},"product":{"allOf":[{"$ref":"#/components/schemas/Product"}],"description":"Full product details for this variant option.\n\nOnly populated when this specific option is selected or needed."}}},"ProductOffer":{"type":"object","description":"Seller-specific product offer in marketplace scenarios.","properties":{"pk":{"type":"integer","description":"Offer identifier"},"name":{"type":"string","description":"Product name"},"attributes":{"type":"object","additionalProperties":true},"attribute_set":{"type":"integer"},"attributes_kwargs":{"type":"object","additionalProperties":true},"extra_attributes":{"type":["object","null"],"additionalProperties":true},"price":{"type":"string","description":"Seller's price for this product"},"in_stock":{"type":"boolean"},"data_source":{"$ref":"#/components/schemas/DataSourceSummary"},"absolute_url":{"type":"string","format":"uri"}}},"DataSourceSummary":{"type":"object","description":"Abbreviated data source information","properties":{"pk":{"type":"integer"},"name":{"type":"string"},"title":{"type":"string"}}}}}}
```

## Retrieve product variant information

> Returns variant selection data for a product, including all available attribute combinations.\
> \
> \*\*Purpose:\*\*\
> This endpoint is optimized for scenarios where you need variant data without the full product detail response. Useful for:\
> \* Variant selector widgets\
> \* Quick attribute filtering\
> \* Lightweight variant queries\
> \
> \*\*Behavior:\*\*\
> \* If the product is not listable, automatically uses the parent product\
> \* Always passes stock check (returns all variants regardless of availability)\
> \* Returns same variant structure as product detail endpoint

```json
{"openapi":"3.1.0","info":{"title":"Product API - Product Catalog & Detail Information","version":"1.0.0"},"tags":[{"name":"Product","description":"Product detail and variant information"}],"servers":[{"description":"Commerce API Server","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL (e.g., your-store.akinon.com)"}}}],"paths":{"/product/{product_id}/variants/":{"get":{"tags":["Product"],"operationId":"getProductVariants","summary":"Retrieve product variant information","description":"Returns variant selection data for a product, including all available attribute combinations.\n\n**Purpose:**\nThis endpoint is optimized for scenarios where you need variant data without the full product detail response. Useful for:\n* Variant selector widgets\n* Quick attribute filtering\n* Lightweight variant queries\n\n**Behavior:**\n* If the product is not listable, automatically uses the parent product\n* Always passes stock check (returns all variants regardless of availability)\n* Returns same variant structure as product detail endpoint","parameters":[{"name":"product_id","in":"path","required":true,"description":"Unique identifier of the product","schema":{"type":"integer"}}],"responses":{"200":{"description":"Product variant data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"404":{"description":"Product not found"}}}}},"components":{"schemas":{"ProductDetailResponse":{"type":"object","description":"Complete product detail response including variant selection data.\n\nContains all information needed to render a product detail page.","required":["in_stock","product","variants"],"properties":{"in_stock":{"type":"boolean","description":"Indicates if any variant of this product is currently in stock.\n\nThis is an aggregate status across all sub-products/variants."},"product":{"$ref":"#/components/schemas/Product"},"variants":{"type":"array","description":"List of variant attribute groups with selectable options.\n\nEach item represents one attribute dimension (e.g., Size, Color) with available options.","items":{"$ref":"#/components/schemas/VariantGroup"}},"selected_variant":{"oneOf":[{"$ref":"#/components/schemas/Product"},{"type":"null"}],"description":"The currently selected variant based on query parameters.\n\n**Null Scenarios:**\n* No variant attributes provided in query\n* Provided attributes don't match any available variant\n* Selected combination is out of stock (when stock check is enforced)"},"offers":{"type":"array","description":"Alternative seller offers for this product.\n\nAvailable in marketplace scenarios where multiple sellers offer the same product.","items":{"$ref":"#/components/schemas/ProductOffer"}}}},"Product":{"type":"object","description":"Core product information including pricing, stock, and attributes.","required":["pk","name","sku","base_code","price","in_stock","product_type"],"properties":{"pk":{"type":"integer","description":"Unique product identifier"},"name":{"type":"string","description":"Display name of the product.\n\nMay be translated based on active language settings."},"sku":{"type":"string","description":"Stock Keeping Unit - unique product code for inventory management."},"base_code":{"type":"string","description":"Base product code shared across variants.\n\nAll size/color variants of the same product share this code."},"attributes":{"type":"object","description":"Product attributes as key-value pairs.\n\nContains both variant-defining attributes (size, color) and descriptive attributes (material, weight).","additionalProperties":true},"attribute_set":{"type":"integer","description":"ID of the attribute set that defines this product's attribute schema."},"attributes_kwargs":{"type":"object","description":"Extended attribute metadata including labels and display values.\n\nProvides translated attribute names and formatted values for display.","additionalProperties":true},"extra_attributes":{"type":["object","null"],"description":"Additional custom attributes not part of the standard attribute set.","additionalProperties":true},"productimage_set":{"type":"array","description":"Product images in multiple sizes and formats.","items":{"$ref":"#/components/schemas/ProductImage"}},"productvideo_set":{"type":"array","description":"Product videos for enhanced product presentation.","items":{"$ref":"#/components/schemas/ProductVideo"}},"price":{"type":"string","description":"Current selling price as a decimal string.\n\nFormat: \"123.45\" (two decimal places)"},"retail_price":{"type":"string","description":"Original retail/list price before discounts.\n\nCompare with `price` to calculate discount percentage."},"currency_type":{"type":"string","description":"Currency code for price values.\n\nCommon values: \"try\" (Turkish Lira), \"usd\", \"eur\""},"price_type":{"type":"string","description":"Price category or tier identifier."},"tax_rate":{"type":"string","description":"Applicable tax rate as a decimal percentage.\n\nExample: \"18.00\" represents 18% tax"},"in_stock":{"type":"boolean","description":"Stock availability status for this specific product/variant."},"stock":{"type":"integer","description":"Available stock quantity.\n\nMay be from default stock or inventory-specific stock list."},"unit_type":{"type":"string","description":"Unit of measurement for stock.\n\nCommon values: \"quantity\", \"kg\", \"meter\""},"product_type":{"type":"string","description":"Product classification type.\n\n| Value | Code | Description |\n|-------|------|-------------|\n| 0 | simple | Standard product with optional variants |\n| 1 | product_meta | Parent product that groups variants |\n| 2 | bundle | Configurable product with chapters |\n| 3 | grouped | Collection of related products sold together |\n| 4 | miscellaneous | Special product (services, fees) |\n| 5 | offer | Seller-specific product offer |","enum":["0","1","2","3","4","5"]},"absolute_url":{"type":"string","format":"uri","description":"Canonical URL for this product.\n\nUse this for SEO-friendly product links."},"form_schema":{"type":"array","description":"Form field definitions for products requiring additional input.\n\nUsed for personalized products, custom engravings, etc.","items":{"$ref":"#/components/schemas/AttributeConfigForm"}},"is_ready_to_basket":{"type":"boolean","description":"Indicates if the product can be directly added to basket.\n\nFalse when variant selection or additional input is required."},"data_source":{"oneOf":[{"$ref":"#/components/schemas/DataSource"},{"type":"null"}],"description":"Seller/data source information for marketplace products."},"basket_offers":{"type":"array","description":"Promotional offers applicable when this product is in the basket.","items":{"type":"object"}},"is_listable":{"type":"boolean","description":"Indicates if the product should appear in product listings.\n\nNon-listable products may only be accessible via direct URL."},"listing_code":{"type":"string","description":"Code used for product listing grouping."}}},"ProductImage":{"type":"object","description":"Product image with multiple size variants","properties":{"pk":{"type":"integer","description":"Image identifier"},"status":{"type":"string","description":"Image processing status"},"image":{"type":"string","format":"uri","description":"Original image URL"},"order":{"type":"integer","description":"Display order (lower numbers appear first)"},"thumbnail":{"type":"string","format":"uri","description":"Thumbnail size image URL"},"mid_thumbnail":{"type":"string","format":"uri","description":"Medium thumbnail URL"},"detailed_thumbnail":{"type":"string","format":"uri","description":"Detailed/larger thumbnail URL"}}},"ProductVideo":{"type":"object","description":"Product video information","properties":{"pk":{"type":"integer","description":"Video identifier"},"video_type":{"type":"string","description":"Video hosting platform type.\n\nCommon values: \"youtube\", \"vimeo\", \"self_hosted\""},"video":{"type":"string","format":"uri","description":"Video URL or embed code"}}},"AttributeConfigForm":{"type":"object","description":"Form field configuration for product customization inputs.","properties":{"key":{"type":"string","description":"Field identifier"},"label":{"type":"string","description":"Field display label"},"type":{"type":"string","description":"Input type.\n\nCommon values: \"text\", \"textarea\", \"select\", \"file\""},"required":{"type":"boolean","description":"Whether the field is required"},"options":{"type":"array","items":{"type":"object"},"description":"Available options for select fields"}}},"DataSource":{"type":"object","description":"Seller or data source information.","properties":{"pk":{"type":"integer","description":"Data source identifier"},"name":{"type":"string","description":"Internal name"},"title":{"type":"string","description":"Display title"},"slug":{"type":"string","description":"URL-friendly identifier"}}},"VariantGroup":{"type":"object","description":"A group of variant options for a single attribute dimension.\n\nEach variant group represents one selectable attribute (e.g., all available sizes).","required":["attribute_key","attribute_name","options"],"properties":{"attribute_key":{"type":"string","description":"Internal key for this attribute.\n\nUsed as query parameter name for variant selection."},"attribute_name":{"type":"string","description":"Human-readable attribute name for display.\n\nMay be translated based on language settings."},"options":{"type":"array","description":"Available options within this attribute group.","items":{"$ref":"#/components/schemas/VariantOption"}}}},"VariantOption":{"type":"object","description":"A single selectable variant option within an attribute group.","required":["label","value","is_selected","is_selectable"],"properties":{"is_selected":{"type":"boolean","description":"Indicates if this option is currently selected.\n\nBased on query parameters or default selection logic."},"is_selectable":{"type":"boolean","description":"Indicates if this option can be selected given current selections.\n\nFalse when the combination with other selected attributes is unavailable."},"is_selectable_without_stock":{"type":["boolean","null"],"description":"Indicates if this option would be selectable ignoring stock status.\n\nUseful for showing \"out of stock\" vs. \"invalid combination\" states."},"in_stock":{"type":["boolean","null"],"description":"Stock status for this specific option combination."},"order":{"type":"string","description":"Display order for this option."},"label":{"type":"string","description":"Display label for this option."},"value":{"type":"string","description":"Internal value for this option.\n\nUsed as query parameter value for variant selection."},"product":{"allOf":[{"$ref":"#/components/schemas/Product"}],"description":"Full product details for this variant option.\n\nOnly populated when this specific option is selected or needed."}}},"ProductOffer":{"type":"object","description":"Seller-specific product offer in marketplace scenarios.","properties":{"pk":{"type":"integer","description":"Offer identifier"},"name":{"type":"string","description":"Product name"},"attributes":{"type":"object","additionalProperties":true},"attribute_set":{"type":"integer"},"attributes_kwargs":{"type":"object","additionalProperties":true},"extra_attributes":{"type":["object","null"],"additionalProperties":true},"price":{"type":"string","description":"Seller's price for this product"},"in_stock":{"type":"boolean"},"data_source":{"$ref":"#/components/schemas/DataSourceSummary"},"absolute_url":{"type":"string","format":"uri"}}},"DataSourceSummary":{"type":"object","description":"Abbreviated data source information","properties":{"pk":{"type":"integer"},"name":{"type":"string"},"title":{"type":"string"}}}}}}
```

## Retrieve miscellaneous product by SKU

> Returns product information for a miscellaneous product identified by SKU.\
> \
> \*\*Miscellaneous Products:\*\*\
> Special product types that are:\
> \* Identified by SKU rather than ID\
> \* Not part of regular product listings\
> \* Used for services, fees, or special items\
> \
> \*\*Examples:\*\*\
> \* Gift wrapping service\
> \* Extended warranty\
> \* Shipping fees\
> \* Custom services\
> \
> \*\*Requirements:\*\*\
> \* Product must be of type "miscellaneous"\
> \* Product must be active\
> \* SKU must match exactly

```json
{"openapi":"3.1.0","info":{"title":"Product API - Product Catalog & Detail Information","version":"1.0.0"},"tags":[{"name":"Product","description":"Product detail and variant information"}],"servers":[{"description":"Commerce API Server","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL (e.g., your-store.akinon.com)"}}}],"paths":{"/misc-product/{sku}/":{"get":{"tags":["Product"],"operationId":"getMiscProduct","summary":"Retrieve miscellaneous product by SKU","description":"Returns product information for a miscellaneous product identified by SKU.\n\n**Miscellaneous Products:**\nSpecial product types that are:\n* Identified by SKU rather than ID\n* Not part of regular product listings\n* Used for services, fees, or special items\n\n**Examples:**\n* Gift wrapping service\n* Extended warranty\n* Shipping fees\n* Custom services\n\n**Requirements:**\n* Product must be of type \"miscellaneous\"\n* Product must be active\n* SKU must match exactly","parameters":[{"name":"sku","in":"path","required":true,"description":"Stock Keeping Unit (SKU) of the miscellaneous product.\n\nSKUs can contain alphanumeric characters and hyphens.","schema":{"type":"string","pattern":"^[\\w-]+$"}}],"responses":{"200":{"description":"Miscellaneous product retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"Product not found.\n\nOccurs when:\n* No product exists with the specified SKU\n* Product is not of type \"miscellaneous\"\n* Product is not active"}}}}},"components":{"schemas":{"Product":{"type":"object","description":"Core product information including pricing, stock, and attributes.","required":["pk","name","sku","base_code","price","in_stock","product_type"],"properties":{"pk":{"type":"integer","description":"Unique product identifier"},"name":{"type":"string","description":"Display name of the product.\n\nMay be translated based on active language settings."},"sku":{"type":"string","description":"Stock Keeping Unit - unique product code for inventory management."},"base_code":{"type":"string","description":"Base product code shared across variants.\n\nAll size/color variants of the same product share this code."},"attributes":{"type":"object","description":"Product attributes as key-value pairs.\n\nContains both variant-defining attributes (size, color) and descriptive attributes (material, weight).","additionalProperties":true},"attribute_set":{"type":"integer","description":"ID of the attribute set that defines this product's attribute schema."},"attributes_kwargs":{"type":"object","description":"Extended attribute metadata including labels and display values.\n\nProvides translated attribute names and formatted values for display.","additionalProperties":true},"extra_attributes":{"type":["object","null"],"description":"Additional custom attributes not part of the standard attribute set.","additionalProperties":true},"productimage_set":{"type":"array","description":"Product images in multiple sizes and formats.","items":{"$ref":"#/components/schemas/ProductImage"}},"productvideo_set":{"type":"array","description":"Product videos for enhanced product presentation.","items":{"$ref":"#/components/schemas/ProductVideo"}},"price":{"type":"string","description":"Current selling price as a decimal string.\n\nFormat: \"123.45\" (two decimal places)"},"retail_price":{"type":"string","description":"Original retail/list price before discounts.\n\nCompare with `price` to calculate discount percentage."},"currency_type":{"type":"string","description":"Currency code for price values.\n\nCommon values: \"try\" (Turkish Lira), \"usd\", \"eur\""},"price_type":{"type":"string","description":"Price category or tier identifier."},"tax_rate":{"type":"string","description":"Applicable tax rate as a decimal percentage.\n\nExample: \"18.00\" represents 18% tax"},"in_stock":{"type":"boolean","description":"Stock availability status for this specific product/variant."},"stock":{"type":"integer","description":"Available stock quantity.\n\nMay be from default stock or inventory-specific stock list."},"unit_type":{"type":"string","description":"Unit of measurement for stock.\n\nCommon values: \"quantity\", \"kg\", \"meter\""},"product_type":{"type":"string","description":"Product classification type.\n\n| Value | Code | Description |\n|-------|------|-------------|\n| 0 | simple | Standard product with optional variants |\n| 1 | product_meta | Parent product that groups variants |\n| 2 | bundle | Configurable product with chapters |\n| 3 | grouped | Collection of related products sold together |\n| 4 | miscellaneous | Special product (services, fees) |\n| 5 | offer | Seller-specific product offer |","enum":["0","1","2","3","4","5"]},"absolute_url":{"type":"string","format":"uri","description":"Canonical URL for this product.\n\nUse this for SEO-friendly product links."},"form_schema":{"type":"array","description":"Form field definitions for products requiring additional input.\n\nUsed for personalized products, custom engravings, etc.","items":{"$ref":"#/components/schemas/AttributeConfigForm"}},"is_ready_to_basket":{"type":"boolean","description":"Indicates if the product can be directly added to basket.\n\nFalse when variant selection or additional input is required."},"data_source":{"oneOf":[{"$ref":"#/components/schemas/DataSource"},{"type":"null"}],"description":"Seller/data source information for marketplace products."},"basket_offers":{"type":"array","description":"Promotional offers applicable when this product is in the basket.","items":{"type":"object"}},"is_listable":{"type":"boolean","description":"Indicates if the product should appear in product listings.\n\nNon-listable products may only be accessible via direct URL."},"listing_code":{"type":"string","description":"Code used for product listing grouping."}}},"ProductImage":{"type":"object","description":"Product image with multiple size variants","properties":{"pk":{"type":"integer","description":"Image identifier"},"status":{"type":"string","description":"Image processing status"},"image":{"type":"string","format":"uri","description":"Original image URL"},"order":{"type":"integer","description":"Display order (lower numbers appear first)"},"thumbnail":{"type":"string","format":"uri","description":"Thumbnail size image URL"},"mid_thumbnail":{"type":"string","format":"uri","description":"Medium thumbnail URL"},"detailed_thumbnail":{"type":"string","format":"uri","description":"Detailed/larger thumbnail URL"}}},"ProductVideo":{"type":"object","description":"Product video information","properties":{"pk":{"type":"integer","description":"Video identifier"},"video_type":{"type":"string","description":"Video hosting platform type.\n\nCommon values: \"youtube\", \"vimeo\", \"self_hosted\""},"video":{"type":"string","format":"uri","description":"Video URL or embed code"}}},"AttributeConfigForm":{"type":"object","description":"Form field configuration for product customization inputs.","properties":{"key":{"type":"string","description":"Field identifier"},"label":{"type":"string","description":"Field display label"},"type":{"type":"string","description":"Input type.\n\nCommon values: \"text\", \"textarea\", \"select\", \"file\""},"required":{"type":"boolean","description":"Whether the field is required"},"options":{"type":"array","items":{"type":"object"},"description":"Available options for select fields"}}},"DataSource":{"type":"object","description":"Seller or data source information.","properties":{"pk":{"type":"integer","description":"Data source identifier"},"name":{"type":"string","description":"Internal name"},"title":{"type":"string","description":"Display title"},"slug":{"type":"string","description":"URL-friendly identifier"}}}}}}
```