Skip to documentation
Browse documentation

Promotions List

List current Asda rollbacks, price drops, and structured multi-buy offers with normalized product and promotion metadata.

Capability ID asda.promotions.list
Cost 1 credit per request
Maximum runtime 30 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

hits_per_page integer optional

No additional description is provided for this parameter.

Example 10
page integer optional

1-based results page

Example 1
promotion_type string optional

Promotion class to return

Example all
Available values allrollbackprice_dropmultibuy
store_id string optional

Asda store id used for stock boosting and in_stock flags

Example 4565

Response

Successful output is returned in results[0].data. Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

PathObserved typeExample
items array 3 items
items array 3 items
page object 5 fields
page.hits_per_page integer 10
page.nb_hits integer 12454
page.nb_pages integer 1246
page.page integer 1
page.source_counts object 3 fields
raw object 2 fields
raw.count_queries object 3 fields
raw.result_queries object 1 fields

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.