Get promotions
get_promotionsRead-only
List promotions (e.g. '2 for 30₪', club-member price, second-unit discount), optionally filtered by store_id or product_id, and by active=true to only return promotions currently running. Use this to explain why an optimize_delivery line price is lower than list_price.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name in Hebrew or English (also accepts CBS locality codes). Restricts to promotions at stores in that city plus chain-wide promotions of chains present there. | |
| limit | No | Max promotions to return, ordered by soonest end date. Defaults to 50, max 200. | |
| active | No | If true, only currently-active promotions. Defaults to true. | |
| store_id | No | Filter to promotions at this store. | |
| product_id | No | Filter to promotions covering this canonical product. |