Get promotion item selection

Learn how to retrieve the product items associated with a promotion, including item-level benefits, budgets, and validation issues using pagination.

Prerequisites

To complete this tutorial, you must have:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API applications for more information.
• The Pricing or Product Listing roles assigned to your developer profile.
• The Pricing or Product Listing role selected in the app registration page for your application.
• A promotionId and selectionId obtained from the searchPromotions or getPromotion operations.

Get the item selection

Call the getSelection operation with the promotionId of the promotion and the selectionId of the selection to retrieve up to 100 product items associated with a promotion. You can optionally specify the following parameters:

• revisionId: The revision ID for the selection.
• locale: The locale for the response (for example, en_US). Defaults to en_US.
• includedData: Set to ISSUES to include item-level validation issues in the response.
• limit: The maximum number of items per page (1–100, default 20).

📘

Note

This operation only supports selections of type ITEMS. Selections of type CATALOG are not supported for item retrieval.

The response includes the selection object with selectionDetails, which contains the following:

• items: An array of items, each with asin, optional sku, and for DEAL and PRICE_DISCOUNT promotions, item-level benefit and budget configurations.
• issues: Item-level validation issues (only when ISSUES is specified in includedData). Each issue includes an identifier field indicating the affected item.

Item-level benefits

For DEAL and PRICE_DISCOUNT promotions, each item can have its own benefit configuration:

• type: Either FIXED_PRICE (item offered at a set price) or DISCOUNTED_PRICE (discount applied to the item).
• discount: The discount details including type (PERCENTAGE_OFF, AMOUNT_OFF), percentage or amount, and currency code.
• price: The fixed price (when type is FIXED_PRICE).