WinShopAPI docs
ReferencePromotionsMulti buy promotions

List multi-buy promotions

Returns every multi-buy promotion defined on this instance. Promotions are configured in Winshop and applied automatically when a price is resolved; these endpoints read that configuration. Requires `Permissions.Promotions.View`.

GET
/api/promotions/multi-buy-promotions

Authorization

Bearer
headerAuthorizationBearer <token>

OAuth 2.0 client credentials. Obtain a client id/secret from Winshop support ([email protected]), then POST to the token URL.

Response Body

application/json
  1. response
[index: integer]?
curl -X GET 'https://<your-instance>/api/promotions/multi-buy-promotions' \  -H 'Authorization: Bearer <access-token>'
[  {    "applyOnTheCheapest": true,    "barcode": "string",    "createdAt": "2019-08-24T14:15:22Z",    "daysOfWeek": 0,    "deletedDate": "2019-08-24T14:15:22Z",    "description": "string",    "discountAmount": 0,    "discountGroupId": 0,    "discountPercent": 0,    "discountValidAlways": true,    "hours": 0,    "id": 0,    "isDeleted": true,    "isPrioritized": true,    "name": "string",    "onlyForPos": true,    "onlyForRegisteredCustomers": true,    "price": 0,    "priceWoVat": 0,    "quantityDiscounted": 0,    "quantitySold": 0,    "soldAll": true,    "useWarehousePrice": true,    "validFrom": "2019-08-24T14:15:22Z",    "validTo": "2019-08-24T14:15:22Z",    "filters": [      {        "groupId": 0,        "id": 0,        "modelId": 0,        "productId": 0,        "promotionId": 0,        "seasonId": 0,        "subGroupId": 0,        "supplierId": 0,        "themeId": 0      }    ],    "warehouses": [      {        "id": 0,        "promotionId": 0,        "warehouseId": 0      }    ]  }]