2025-07-07

Changed

Market specific End Date Sales: Changed from +175 days to +360 days

All the API endpoints are updated to include products for the range of sale end date + 360 days in the response when enableMarketSalesDate is set to true in request query parameter. Please refer to the API specification for details.

2025-06-18

Changed

Host Name: Changed from knowledge.api.inter.ikea.com to knowledge.api.inter.ikea.net

API Gateway migration: Moved from Akamai to Azure APIM

Base url is changed to https://knowledge.api.inter.ikea.net/cbr/rosd/ikg/api/back-off-to-hero/v2

Action Required: Update all API client configurations to point to the new base URL

Authentication Header Format: Minor update – use Subscription-Key instead of X-Client-Id header

Action Required: Modify all requests to use the new header key: Subscription-Key

2024-12-11

Decommission v1

v1 of the back-off-to-hero API has now been decommissioned, please use v2 of the API going forward.

2024-11-04

Updated:

Included enableMarketSalesDate as a query parameter in request of all endpoints of v2.

Included enableMarketSalesDate as a query parameter in all endpoints of v2. It is an optional boolean parameter, when set to true, it indicates that products for the range of sale start date - 56 days to sale end date + 175 days, should be considered in the response. Please refer to the API specification for details.

Sorted retailUnits in the response

Retail Units in the response are sorted in all endpoints of v2.

Removed:

Removed ignoreSaleDates as a query parameter in request of all endpoints of v2.

Removed ignoreSaleDates as a query parameter in all endpoints of v2.

2024-05-17

Updated:

Included ignoreSaleDates as a query parameter in request of all endpoints of v2.

Included ignoreSaleDates as a query parameter in all endpoints of v2. It is an optional boolean parameter, which if true indicates that products, regardless of sale start date and sale end date, should be considered in response. Please refer to the API specification for details.

2024-05-03

Added:

Added a new version v2 which has all endpoints similar to v1, but different response schema.

Added a new version v2 which has all endpoints similar to v1. This new version v2 is introduced to fix an issue existing in v1. The response schema of v1 does not support when a hero is protected by multiple backoffs and does not show all the backoffs in response. The response schema of necessary endpoints have been modified in v2 to support an array displaying multiple backoffs and their retail units in response. The request schema remains the same in both v1 and v2.

Removed:

Removed itemIdentifier field from response schema of v2 endpoints.

Removed the itemIdentifier field from response schema of all v2 endpoints since it contained redundant information. The itemIdentifier is still present for v1 endpoints.

2024-03-01

Updated:

Included retailUnits as a query parameter in request of all endpoints.

Included retailUnits as a query parameter in all endpoints. Retail Units can be specified in input as a comma-separated list. Retail units associated with each back-off/ hero product is also returned as an array in response of all endpoints. Please refer to the API specification for details.

2023-09-04

Added:

Get back-off/hero properties for multiple products

Added an endpoint to return the back-off/hero properties associated with one or more products specified as input (via a comma-separated list of item numbers). Please refer to the API specification for details.

2023-06

Added:

Range update

2023-04

Added:

Range update

2023-02

Added:

Range update

2022-05-06

Back-off to hero v1.0.0 release features

Added:

• API specification using open api 3.
• Fully functioning back-off to hero serverless API implementation.
• CI/CD to deploy API specification to akamai and API implementation to azure.