eBay Trading APIVersion 1161

GetPromotionalSaleDetailsRequestType ( AbstractRequestType )

Note: While the Trading API continues to support item promotions for an eBay store owner, the Trading API will no longer be enhanced with any new item promotion capabilities as they are developed by eBay. In addition, Promoted Listings are also not supported by the Trading API. For these two reasons, it is recommended that sellers/developers make plans to migrate to the Marketing API, which provides all Promotions Manager and Promoted Listings capabilities, and this API will continue to be improved and enhanced as more marketing features become available to sellers. The base request type for the GetPromotionalSaleDetails call. This call retrieves information about promotional sales set up by an eBay store owner. The eBay store owner has the option to retrieve all promotional sales, a specific promotional sale, or promotional sales in a specific state.

Call that uses GetPromotionalSaleDetailsRequestType:

Fields

PromotionalSaleID ( long ) [0..1]
The unique identifier of the promotional sale to retrieve. This field is used if the eBay store owner only wants to retrieve a specific promotional sale. Any PromotionalSaleStatus fields that are included will be ignored if the PromotionalSaleID field is used.

If neither the PromotionalSaleID nor a PromotionalSaleStatus field is used, then all promotional sales for the eBay store owner are returned.
See the Field Index to learn which calls use PromotionalSaleID.

PromotionalSaleStatus ( PromotionalSaleStatusCodeType ) [0..*]
One or more PromotionalSaleStatus fields are used if the eBay store owner wants to retrieve promotional sales in a specific state, such as Active, Scheduled, or Deleted. A PromotionalSaleStatus field is included for each status. See PromotionalSaleStatusCodeType for a description of the status values that can be used in this field.

If neither the PromotionalSaleID nor a PromotionalSaleStatus field is used, then all promotional sales for the eBay store owner are returned.
See the Field Index to learn which calls use PromotionalSaleStatus.