# 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"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/commerce-openapis/products/product.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.