Multi Basket

List Active Baskets

get

This method retrieves a list of all active baskets for the current session.

Returns basic information about each basket including the primary key and namespace. This is useful for displaying available baskets to users or for basket management interfaces.

Use Cases:

• Display user's available baskets

• Basket switching interfaces

• Administrative basket overview

Authorizations

commerceSessionAuth

osessionidstringRequired

Session-based authentication using osessionid cookie

Responses

200

Successfully retrieved basket list

application/json

get

/basket-list/

HTTPcURLJavaScriptPython

GET /baskets/basket-list/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

200

Successfully retrieved basket list

{
  "baskets": [
    {
      "pk": 123,
      "namespace": "main"
    },
    {
      "pk": 124,
      "namespace": "wishlist"
    },
    {
      "pk": 125,
      "namespace": null
    }
  ]
}

Set Main Basket by ID

post

This method sets a specific basket as the main/active basket using its primary key (ID).

When a basket is set as main, it becomes the default basket for the current session. The basket's namespace is stored in the user's session for subsequent operations.

Use Cases:

• Switch between different user baskets

• Set a saved basket as the current active basket

• Restore a previous shopping session

Authorizations

commerceSessionAuth & csrfCookie

osessionidstringRequired

Session-based authentication using osessionid cookie

csrftokenstringRequired

CSRF token for state-changing requests (POST/PUT/PATCH/DELETE)

Path parameters

pkintegerRequired

Primary key (ID) of the basket to set as main

Responses

200

Successfully set basket as main

application/json

404

Basket not found

application/json

post

/basket-list/id/{pk}/main/

HTTPcURLJavaScriptPython

POST /baskets/basket-list/id/{pk}/main/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "basket": {
    "pk": 123,
    "namespace": "main",
    "total_quantity": 3,
    "total_amount": 89.97,
    "total_discount_amount": 0,
    "total_product_amount": 89.97,
    "basketitem_set": [
      {
        "id": 456,
        "product": {
          "pk": 789,
          "sku": "MSE-001-BLK",
          "name": "Wireless Mouse",
          "base_code": "MSE-001",
          "product_type": "simple",
          "productimage_set": [
            {
              "image": "https://example.com/images/mouse.jpg"
            },
            {
              "image": "https://example.com/images/mouse-side.jpg"
            }
          ],
          "attributes": {
            "color": "Black",
            "brand": "TechPeripherals",
            "connectivity": "Wireless 2.4GHz"
          },
          "is_active": true,
          "attribute_set": 1
        },
        "quantity": 3,
        "unit_price": 29.99,
        "price": 89.97,
        "retail_price": 29.99,
        "discounted_price": null,
        "tax_rate": 0.18,
        "currency_type": "try",
        "total_amount": 89.97,
        "discount_amount": 0,
        "stock": 100,
        "attributes": {},
        "attributes_kwargs": {},
        "shipping_discount": 0,
        "offer_badges": [],
        "image": "https://example.com/images/mouse.jpg",
        "parent": null,
        "datasource": null,
        "extra_product_stock_detailed": null,
        "extra_product_price_detailed": null
      }
    ],
    "discounts": [],
    "voucher_code": null,
    "unavailable_basket_products": [],
    "upsell_details": [],
    "created_date": "2025-01-15T10:30:00Z",
    "modified_date": "2025-01-15T10:30:00Z",
    "segment": null
  }
}

Get Detailed Basket Discounts

get

This method retrieves detailed information about discounts applied to a specific basket.

Returns comprehensive discount information including sample products, allowed quantities, and detailed breakdown of promotional benefits. This is particularly useful for understanding complex promotional structures and sample product offerings.

Use Cases:

• Display detailed discount information to users

• Promotional analysis and reporting

• Sample product management

• Marketing campaign effectiveness tracking

Authorizations

commerceSessionAuth

osessionidstringRequired

Session-based authentication using osessionid cookie

Path parameters

pkintegerRequired

Primary key (ID) of the basket

Responses

200

Successfully retrieved detailed discounts

application/json

descriptionstringOptional

Description of the discount

Example: 10% off on electronics

discountstringOptional

Discount amount

Example: 5.99

affectsstring · enumOptional

Type of discount application result that determines what the discount affects.

Application types:

• basket - Discount applied to basket items (reduces product prices)
• shipping - Discount applied to shipping costs (free or reduced shipping)
• post_order - Discount applied after order completion (cashback, loyalty points)
• sample_product - Free sample product added to basket as promotional item

Usage in responses:

• Basket discounts reduce the total_amount
• Shipping discounts appear in shipping_discount field on items
• Sample products appear as separate basket items with special pricing
• Post-order benefits are tracked separately for future application

Example: basketPossible values:

sample_productsobject[]Optional

Sample products for the discount

allowed_quantityintegerOptional

Allowed quantity for the discount

Example: 5

404

Basket not found

application/json

get

/basket-list/id/{pk}/detailed_discounts/

HTTPcURLJavaScriptPython

GET /baskets/basket-list/id/{pk}/detailed_discounts/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

[
  {
    "description": "10% off electronics",
    "discount": "15.00",
    "affects": "basket",
    "sample_products": [],
    "allowed_quantity": 5
  },
  {
    "description": "Free sample with purchase",
    "discount": "0.00",
    "affects": "item",
    "sample_products": [
      {
        "name": "Sample Product",
        "sku": "SAMPLE001"
      }
    ],
    "allowed_quantity": 1
  }
]

Set Main Basket by Namespace

post

This method sets a specific basket as the main/active basket using its namespace identifier.

Namespaces allow for logical separation of baskets (e.g., "main", "wishlist", "saved"). When a basket is set as main by namespace, it becomes the default basket for the current session.

Special handling:

• Use "null" as namespace parameter to select baskets with null namespace

• The namespace is stored in the user's session for subsequent operations

Use Cases:

• Switch between thematic baskets (main cart vs wishlist)

• Restore namespace-specific shopping sessions

• Multi-store or multi-context basket management

Authorizations

commerceSessionAuth & csrfCookie

osessionidstringRequired

Session-based authentication using osessionid cookie

csrftokenstringRequired

CSRF token for state-changing requests (POST/PUT/PATCH/DELETE)

Path parameters

namespacestringRequired

Namespace identifier for the basket. Use "null" for baskets with null namespace.

Responses

200

Successfully set basket as main

application/json

404

Basket not found for the specified namespace

application/json

post

/basket-list/ns/{namespace}/main/

HTTPcURLJavaScriptPython

POST /baskets/basket-list/ns/{namespace}/main/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "basket": {
    "pk": 124,
    "namespace": "main",
    "total_quantity": 2,
    "total_amount": 59.98,
    "total_discount_amount": 0,
    "total_product_amount": 59.98,
    "basketitem_set": [
      {
        "id": 457,
        "product": {
          "pk": 790,
          "sku": "CBL-001-WHT",
          "name": "USB Cable",
          "base_code": "CBL-001",
          "product_type": "simple",
          "productimage_set": [
            {
              "image": "https://example.com/images/cable.jpg"
            },
            {
              "image": "https://example.com/images/cable-pack.jpg"
            }
          ],
          "attributes": {
            "color": "White",
            "length": "2m",
            "type": "USB-C to USB-A"
          },
          "is_active": true,
          "attribute_set": 1
        },
        "quantity": 2,
        "unit_price": 29.99,
        "price": 59.98,
        "retail_price": 29.99,
        "discounted_price": null,
        "tax_rate": 0.18,
        "currency_type": "try",
        "total_amount": 59.98,
        "discount_amount": 0,
        "stock": 200,
        "attributes": {},
        "attributes_kwargs": {},
        "shipping_discount": 0,
        "offer_badges": [],
        "image": "https://example.com/images/cable.jpg",
        "parent": null,
        "datasource": null,
        "extra_product_stock_detailed": null,
        "extra_product_price_detailed": null
      }
    ],
    "discounts": [],
    "voucher_code": null,
    "unavailable_basket_products": [],
    "upsell_details": [],
    "created_date": "2025-01-15T08:45:00Z",
    "modified_date": "2025-01-15T08:45:00Z",
    "segment": null
  }
}

Delete Basket

delete

This method permanently deletes a specific basket identified by its ID.

Once deleted, the basket and all its items are removed from the system. This operation cannot be undone, so use with caution.

Use Cases:

• Clean up abandoned or unwanted baskets

• User-initiated basket deletion

• Administrative basket management

• Session cleanup operations

Authorizations

commerceSessionAuth & csrfCookie

osessionidstringRequired

Session-based authentication using osessionid cookie

csrftokenstringRequired

CSRF token for state-changing requests (POST/PUT/PATCH/DELETE)

Path parameters

basket_idintegerRequired

Unique identifier of the basket to delete

Responses

204

Basket successfully deleted (no content returned)

404

Basket not found

application/json

delete

/basket-list/{basket_id}/

HTTPcURLJavaScriptPython

DELETE /baskets/basket-list/{basket_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

No content

Get Basket Detail by Namespace

get

This method retrieves comprehensive details about a specific basket using its namespace identifier.

Returns complete basket information including all items, pricing, discounts, and metadata. The endpoint also handles unavailable products by removing them from the basket automatically and applies current promotional offers.

Special handling:

• Use "null" as namespace parameter to access baskets with null namespace

• Unavailable products are automatically removed from the basket

• Promotional offers are automatically applied before returning data

Use Cases:

• Display full basket details to users

• Checkout page data loading

• Basket review and modification interfaces

• Order preparation workflows

Authorizations

commerceSessionAuth

osessionidstringRequired

Session-based authentication using osessionid cookie

Path parameters

namespacestringRequired

Namespace identifier for the basket. Use "null" for baskets with null namespace.

Responses

200

Successfully retrieved basket details

application/json

404

Basket not found for the specified namespace

application/json

get

/basket/{namespace}/

HTTPcURLJavaScriptPython

GET /baskets/basket/{namespace}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "basket": {
    "pk": 124,
    "namespace": "main",
    "total_quantity": 3,
    "total_amount": 149.95,
    "total_discount_amount": 15,
    "total_product_amount": 164.95,
    "basketitem_set": [
      {
        "id": 456,
        "product": {
          "pk": 789,
          "sku": "SKU001",
          "name": "Sample Product",
          "base_code": "SPL-001",
          "product_type": "simple",
          "productimage_set": [
            {
              "image": "https://example.com/images/sample.jpg"
            },
            {
              "image": "https://example.com/images/sample-detail.jpg"
            }
          ],
          "attributes": {
            "category": "Electronics",
            "brand": "SampleBrand",
            "model": "SP-2025"
          },
          "is_active": true,
          "attribute_set": 1
        },
        "quantity": 2,
        "unit_price": 29.99,
        "price": 59.98,
        "retail_price": 29.99,
        "discounted_price": null,
        "tax_rate": 0.18,
        "currency_type": "try",
        "total_amount": 59.98,
        "discount_amount": 0,
        "stock": 75,
        "attributes": {},
        "attributes_kwargs": {},
        "shipping_discount": 0,
        "offer_badges": [],
        "image": "https://example.com/images/sample.jpg",
        "parent": null,
        "datasource": null,
        "extra_product_stock_detailed": null,
        "extra_product_price_detailed": null
      }
    ],
    "discounts": [],
    "voucher_code": null,
    "unavailable_basket_products": [],
    "upsell_details": [],
    "created_date": "2025-01-15T09:00:00Z",
    "modified_date": "2025-01-15T11:30:00Z",
    "segment": null
  }
}

Get Mini Basket by Namespace

get

This method retrieves minimal basket information using its namespace identifier.

Returns only essential basket information like primary key and total quantity, optimized for quick loading scenarios such as header cart indicators or navigation elements where full basket details are not needed.

Special handling:

• Use "null" as namespace parameter to access baskets with null namespace

• Lightweight response for performance-critical scenarios

Use Cases:

• Shopping cart icon with item count

• Quick basket status checks

• Mobile app header indicators

• Performance-sensitive basket summaries

Authorizations

commerceSessionAuth

osessionidstringRequired

Session-based authentication using osessionid cookie

Path parameters

namespacestringRequired

Namespace identifier for the basket. Use "null" for baskets with null namespace.

Responses

200

Successfully retrieved mini basket information

application/json

pkintegerOptional

Basket unique identifier

Example: 124

total_quantityintegerOptional

Total quantity of items in basket

Example: 3

404

Basket not found for the specified namespace

application/json

get

/basket/{namespace}/mini/

HTTPcURLJavaScriptPython

GET /baskets/basket/{namespace}/mini/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "pk": 124,
  "total_quantity": 3
}