Get promotions for basket

Returns the promotion activations currently on record for a basket. Unlike the /preorder/ endpoints, this does not assign a card — it queries existing PreOrderCall records matching basket_id + basket_modified_date.

Use this to re-fetch the promotion list after the card was already assigned (e.g. when re-rendering the checkout summary).

When voucher_code is provided, only promotions with usable_with_voucher_code: true are returned, preventing non-stackable promotions from being shown alongside a voucher.

post

Body

idintegerRequired

Omnitron basket ID

Example: 12345

modified_datestring · date-timeRequired

Last modification timestamp of the basket (ISO 8601)

Example: 2025-06-26T10:30:00Z

voucher_codestring · nullableOptional

Optional voucher code applied to the basket. When provided, only promotions with usable_with_voucher_code: true are returned.

Example: SUMMER2025

Responses

200

Active promotion activations for the basket

application/json

422

Validation error

application/json

post/promotions/

POST /api/v1/promotions/ HTTP/1.1
Host: your-bankaci-instance.example.com
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "id": 12345,
  "modified_date": "2025-06-26T10:30:00Z",
  "voucher_code": null
}

{
  "basket_offers": [
    {
      "basket_offer_id": 123,
      "session_code": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ]
}