Skip to documentation
Docs
Sign in Get an API key API key
Browse documentation
For AI agents

Connect your agent to live platform data.

Open in
Lidl API Capability

List promotions

List paginated discounted online products from Lidl Germany or France, including current and deleted prices from the public sale assortments.

Capability ID lidl.promotions.list
Maximum runtime 30 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

country string optional

GB item-level Lidl Plus offers require an authenticated consumer session and are not part of this public capability. Allowed values: `DE`, `FR`. Default: `DE`.

Example DE
Available values DEFR
fetchsize integer optional

Number of results per page. From 1 to 100. Default: `24`.

Example 5
offset integer optional

Zero-based number of results to skip. At least 0. Default: `0`.

Example 0

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 example response is shown in the response panel.

Illustrative output fields

Values illustrate one response. Read the guidance above for missing values and limits; fields can vary with the requested operation and the data available.

PathObserved typeExample
country string DE
fetchsize integer 5
items array 3 items
items array 3 items
numFound integer 4442
offset integer 0

Execution behavior

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