getSelection

get

https://sellingpartnerapi-na.amazon.com/promotions/2025-12-01/promotions/{promotionId}/selections/{selectionId}

Retrieve up to 100 product items that are associated with a specified promotion. This operation only supports items found in SelectionType.ITEMS. Items found in SelectionType.CATALOG are not supported. Selection objects always include selectionDetails with item information.

Path Params

promotionId

string

required

The ID of the promotion.

selectionId

string

required

The ID of the selection.

Query Params

revisionId

integer

required

≥ 1

The revision identifier for the selection. Use the revisionId from the getPromotion response. A promotion may have multiple selection revisions when an update is in progress. Passing the correct revisionId ensures you retrieve the expected data.

locale

string

^[a-z]{2}_[A-Z]{2}$

Defaults to en_US

The locale of the promotion. Formatted as an ISO 639 language code, followed by an underscore, followed by an ISO 3166-1 alpha-2 country code.

paginationToken

string

A token that you use to retrieve the next page of results. The response includes paginationToken when the number of results exceeds the specified limit value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until paginationToken is null. Note that this operation can return empty pages.

limit

int64

1 to 100

Defaults to 20

The maximum number of response results per page.

includedData

array of strings

A comma-delimited list of datasets to include in the response.

includedData

Allowed:

Responses

Language

Loading…

Response

Choose an example:

application/json

200Successfully retrieved the item selection for the promotion.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.