Grouped Product

Grouped product (product set) operations

Retrieve grouped product detail

get

Returns detail information for a grouped product, including all member products and combined pricing.

Grouped Products: A grouped product represents a collection of related products sold together, such as:

• Furniture sets (table + chairs)

• Outfit combinations (shirt + pants + accessories)

• Kit products (main product + accessories)

Response Includes:

• Main grouped product information

• List of all member products with individual details

• Combined total price and retail price for the group

• Stock availability across all group members

Pricing:

• group_products_total_price: Sum of all member product prices

• group_products_total_retail_price: Sum of all member retail prices

Path parameters

product_idintegerRequired

Unique identifier of the grouped product.

Must be a product with type "grouped".

Example: 5678

Responses

200

Grouped product detail retrieved successfully

application/json

Response for grouped product detail page.

Contains the main grouped product and all its member products.

in_stockbooleanRequired

Aggregate stock status across all group members.

True if at least one member product is in stock.

Example: true

group_products_total_pricestringRequired

Sum of all member product prices.

Calculated as: sum(product.price × initial_quantity) for all members.

Example: 549.99

group_products_total_retail_pricestringRequired

Sum of all member retail prices.

Useful for showing total savings on the group.

Example: 699.99

404

Grouped product not found.

Occurs when:

• No product exists with the specified ID
• Product exists but is not of type "grouped"
• Product is marked as end-of-life

get

/group-product/{product_id}/

HTTPcURLJavaScriptPython

GET /group-product/{product_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "in_stock": true,
  "product": {
    "pk": 12345,
    "name": "Premium Running Shoes - Blue/White",
    "sku": "SHOE-RUN-BLU-42",
    "base_code": "SHOE-RUN-BLU",
    "attributes": {
      "color": "Blue",
      "size": "42",
      "material": "Synthetic"
    },
    "attribute_set": 15,
    "attributes_kwargs": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "extra_attributes": null,
    "productimage_set": [
      {
        "pk": 98765,
        "status": "active",
        "image": "https://cdn.akinon.com/products/shoe-main.jpg",
        "order": 1,
        "thumbnail": "https://cdn.akinon.com/products/shoe-main-thumb.jpg",
        "mid_thumbnail": "https://example.com",
        "detailed_thumbnail": "https://example.com"
      }
    ],
    "productvideo_set": [
      {
        "pk": 1,
        "video_type": "text",
        "video": "https://example.com"
      }
    ],
    "price": "149.99",
    "retail_price": "199.99",
    "currency_type": "try",
    "price_type": "default",
    "tax_rate": "18.00",
    "in_stock": true,
    "stock": 25,
    "unit_type": "quantity",
    "product_type": "0",
    "absolute_url": "/products/premium-running-shoes-12345/",
    "form_schema": [
      {
        "key": "text",
        "label": "text",
        "type": "text",
        "required": true,
        "options": [
          {}
        ]
      }
    ],
    "is_ready_to_basket": true,
    "data_source": {
      "pk": 42,
      "name": "seller-123",
      "title": "Premium Electronics Store",
      "slug": "premium-electronics"
    },
    "basket_offers": [
      {}
    ],
    "is_listable": true,
    "listing_code": "SHOE-RUN-BLU"
  },
  "group_products": [
    {
      "pk": 12345,
      "name": "Premium Running Shoes - Blue/White",
      "sku": "SHOE-RUN-BLU-42",
      "base_code": "SHOE-RUN-BLU",
      "attributes": {
        "color": "Blue",
        "size": "42",
        "material": "Synthetic"
      },
      "attribute_set": 15,
      "attributes_kwargs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "extra_attributes": null,
      "productimage_set": [
        {
          "pk": 98765,
          "status": "active",
          "image": "https://cdn.akinon.com/products/shoe-main.jpg",
          "order": 1,
          "thumbnail": "https://cdn.akinon.com/products/shoe-main-thumb.jpg",
          "mid_thumbnail": "https://example.com",
          "detailed_thumbnail": "https://example.com"
        }
      ],
      "productvideo_set": [
        {
          "pk": 1,
          "video_type": "text",
          "video": "https://example.com"
        }
      ],
      "price": "149.99",
      "retail_price": "199.99",
      "currency_type": "try",
      "price_type": "default",
      "tax_rate": "18.00",
      "in_stock": true,
      "stock": 25,
      "unit_type": "quantity",
      "product_type": "0",
      "absolute_url": "/products/premium-running-shoes-12345/",
      "form_schema": [
        {
          "key": "text",
          "label": "text",
          "type": "text",
          "required": true,
          "options": [
            {}
          ]
        }
      ],
      "is_ready_to_basket": true,
      "data_source": {
        "pk": 42,
        "name": "seller-123",
        "title": "Premium Electronics Store",
        "slug": "premium-electronics"
      },
      "basket_offers": [
        {}
      ],
      "is_listable": true,
      "listing_code": "SHOE-RUN-BLU",
      "initial_quantity": 1
    }
  ],
  "group_products_total_price": "549.99",
  "group_products_total_retail_price": "699.99"
}