GET /promotion

This method returns a list of a seller's undeleted promotions.

The call returns up to 200 currently-available promotions on the specified marketplace. While the response body does not include the promotion's discountRules or inventoryCriterion containers, it does include the promotionHref (which you can use to retrieve the complete details of the promotion).

Use query parameters to sort and filter the results by the number of promotions to return, the promotion state or type, and the eBay marketplace. You can also supply keywords to limit the response to the promotions that contain that keywords in the title of the promotion.

Maximum returned: 200

Servers

https://api.ebay.com{basePath}

Query parameters

Name	Type	Required	Description
`limit`	String	No	Specifies the maximum number of promotions returned on a page from the result set. Default: 200 Maximum: 200
`q`	String	No	A string consisting of one or more keywords. eBay filters the response by returning only the promotions that contain the supplied keywords in the promotion title. Example: "iPhone" or "Harry Potter." Commas that separate keywords are ignored. For example, a keyword string of "iPhone, iPad" equals "iPhone iPad", and each results in a response that contains promotions with both "iPhone" and "iPad" in the title.
`sort`	String	No	Specifies the order for how to sort the response. If you precede the supplied value with a dash, the response is sorted in reverse order. Example: `sort=END_DATE` Sorts the promotions in the response by their end dates in ascending order `sort=-PROMOTION_NAME` Sorts the promotions by their promotion name in descending alphabetical order (Z-Az-a) Valid values: `START_DATE` `END_DATE` `PROMOTION_NAME` For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/sell/marketing/types/csb:SortField
`marketplace_id`	String	Yes	The eBay marketplace ID of the site where the promotion is hosted. Valid values: `EBAY_AU` = Australia `EBAY_DE` = Germany `EBAY_ES` = Spain `EBAY_FR` = France `EBAY_GB` = Great Britain `EBAY_IT` = Italy `EBAY_US` = United States
`promotion_type`	String	No	Filters the returned promotions based on their campaign promotion type. Specify one of the following values to indicate the promotion type you want returned: `CODED_COUPON` – A coupon code promotion set with createItemPromotion. `MARKDOWN_SALE` – A markdown promotion set with createItemPriceMarkdownPromotion. `ORDER_DISCOUNT` – A threshold promotion set with createItemPromotion. `VOLUME_DISCOUNT` – A volume pricing promotion set with createItemPromotion.
`offset`	String	No	Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response. Combine offset with the limit query parameter to control the items returned in the response. For example, if you supply an offset of `0` and a limit of `10`, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If offset is `10` and limit is `20`, the first page of the response contains items 11-30 from the complete result set. Default: 0
`promotion_status`	String	No	Specifies the promotion state by which you want to filter the results. The response contains only those promotions that match the state you specify. Valid values: `DRAFT` `SCHEDULED` `RUNNING` `PAUSED` `ENDED` Maximum number of input values: 1

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.