Price history and Omnibus

The lowest price of the last 30 days. From one API call.

Quantaprice is a pricing engine that keeps the earlier versions of your prices. Ask for a SKU and it returns the lowest price in force during the 30 days before a price reduction, with the pricelist and the dates the figure comes from.

What you get

The prior price, the history behind it and the campaign itself

30-day lowest price

POST /price/historical-best returns the lowest price in force during a period, 30 days by default, across the pricelists you select. The lowest price over a period

Price history

Every change keeps the version it replaces. Query any past moment with as_of, or list the changes to one price with who wrote each. Historical pricing

Scheduled campaigns

Write a campaign price today with a start_date. It takes effect at that moment, and the price it replaces becomes history you can query. Scheduled updates

Price reductions in the EU

What the rule asks for, and what Quantaprice returns

The EU price-reduction rule (Omnibus) concerns announced price reductions to consumers and refers to the lowest price of the 30 days before the reduction. Member states apply it with their own exceptions. Quantaprice calculates the lowest price over a period from the price history it stores for you.

  • You choose the pricelists. The request takes the same pricelist filter as a price query: pricelist codes, metadata such as audience: public, or both. The pricelists are not limited to public ones, so you decide which prices count. Building a pricelist filter
  • You choose the period. The default is the 30 days before now. Send as_of to end the period at another moment, such as the start of the reduction, or from and to for exact dates.
  • The first day counts. The price in force when the period begins is included even if it was set earlier, because it is the price a price query returned on the first day.
  • Prices are compared as a price query showed them. Each price is converted to the requested currency and rounded, with the exchange rates, VAT rates and rounding profiles that applied when it was in force. The comparison uses the base price, without quantity breaks, excluding VAT.

The figure is a calculation on your data. How the rule applies to your shop, for example which pricelists hold prices your customers saw, is for you and your adviser to decide. Quantaprice does not give legal advice.

Example

One request for the figure and where it comes from

A chair costs 199.00 EUR on the retail pricelist and was on a one-week campaign at 179.00 EUR earlier in the period.

Ask for the lowest price

The request names one SKU, the pricelists that count, the currency of the answer and the tax area. Here the filter selects every pricelist tagged audience: public. Without days or as_of, the period is the 30 days before now.

POST /price/historical-best
{
  "sku": "SKU-CHAIR-001",
  "pricelist_filter": { "metadata": { "audience": ["public"] } },
  "currency_code": "EUR",
  "tax_area": "SE"
}

Read the answer

Response
{
  "sku": "SKU-CHAIR-001",
  "currency_code": "EUR",
  "from": "2026-10-02T09:00:00Z",
  "to": "2026-11-01T09:00:00Z",
  "sales_price_ex_vat": 179.0,
  "pricelist": "campaign-eur",
  "pricelists": [
    { "pricelist": "campaign-eur", "currency_code": "EUR", "sales": 179.0, "sales_price_ex_vat": 179.0, "start_at": "2026-10-10T00:00:00Z", "end_at": "2026-10-17T00:00:00Z", "inherited": false },
    { "pricelist": "retail-eur", "currency_code": "EUR", "sales": 199.0, "sales_price_ex_vat": 199.0, "start_at": "2026-09-01T00:00:00Z", "end_at": null, "inherited": false }
  ]
}

sales_price_ex_vat and pricelist give the lowest price in force at any moment in the period, and the pricelist it was on. pricelists lists the lowest price on each pricelist, lowest first, with start_at and end_at for the time that price was in force.

PricelistLowest price, excl. VATIn force fromIn force until
campaign-eur179.0010 October 202617 October 2026
retail-eur199.001 September 2026Still in force

The retail price was set before the period began and counts because it was in force on the first day. end_at is null while a price is still in force. For a SKU without a price in the period, the values are null. The lowest price over a period

The figure excludes VAT

The response gives the price excluding VAT, in the currency you asked for, and no price including VAT. A storefront that shows prices including VAT adds the VAT itself before it shows the figure beside the reduced price. The dates in pricelists let you show a colleague or an auditor where the figure comes from.

Price history

Every price change is kept and can be queried

The 30-day figure is one reading of a history you can query in other ways: the price at a past moment, and the list of changes to one price.

  • The price at any past moment. Add as_of to a price query and you get the price that was in force then, calculated with the pricelist settings, article data, rounding, exchange rates and VAT rates that applied at that moment. Use it to verify an invoice or reproduce the price behind an old order. Historical queries
  • The changes to one price. GET /changes/{pricelist}/{sku}?days=30 lists the versions written in the period, newest first: the fields, sales price and quantity breaks after each change, when it took effect, and who wrote it. The console shows the same list under History on a price's page. The changes to one price
  • Campaigns written in advance. A scheduled price takes effect at its start_date, to the second. You can check it before it goes live with a query whose as_of is after its start, and a campaign pricelist can stay in your filter after it ends. Scheduled updates
POST /price/query with as_of
{
  "skus": ["SKU-CHAIR-001"],
  "pricelist_filter": { "pricelists": ["customer-acme"] },
  "currency_code": "SEK",
  "tax_area": "SE",
  "as_of": "2026-01-15T00:00:00Z"
}

Retention

How long price history is kept on each plan

The lowest price is calculated from stored history, so a price that retention has removed does not count. By default every version is kept, and each kept version counts towards your plan's price limit. Each plan keeps price history for at least the period below. Plan and limits

PlanPrice history kept, at least
Evaluation30 days
Starter90 days
Growth1 year
Scale3 years
EnterpriseCustom

If your plan includes history retention and you turn it on to hold fewer versions, also turn on retention.keep.reference.prices. It keeps every version that was in force during the 30 days before the start of a price that is in force now or scheduled, per SKU across all pricelists. How long history is kept The plans and their prices are on the pricing page.

FAQ

Questions about the 30-day lowest price

What does the 30-day lowest price endpoint return?

POST /price/historical-best returns the lowest price of a SKU that was in force at any moment in the period, excluding VAT and in the currency you ask for, with the pricelist it was on. It also lists the lowest price on each selected pricelist, with the dates when that price was in force.

Does using Quantaprice make our price reductions compliant?

Quantaprice returns a figure from your stored price history, for the period and the pricelists you choose. How the price-reduction rule applies to your shop, and which prices count as prices your customers saw, is for you and your adviser to decide.

Which prices count towards the lowest price?

The prices on the pricelists your filter selects, by code or by metadata, that were in force during the period. The price in force when the period begins counts even if it was set earlier. Inherited prices and bundle prices count like any other price.

Is the lowest price returned including VAT?

The response gives the price excluding VAT, in the currency of the request. Prices are compared as a price query showed them at the time: converted, rounded with the rounding profile, and with VAT calculated for the tax area you name.

Can I use a period other than 30 days?

Yes. Send from and to, or days with as_of. The default is the 30 days before now, and days can be at most 3650. The answer covers the price history that is still stored.

How long is price history kept?

By default every price version is kept, and each kept version counts towards your plan's price limit. Each plan keeps price history for at least a set period, from 30 days on Evaluation to 3 years on Scale. If you turn on history retention, a setting keeps every price needed for the 30 days before a price reduction.

Can I try it with my own catalogue?

Yes. The Evaluation plan is free for 90 days with 100,000 articles and 1M prices, includes every API, and keeps price history for at least 30 days.

Get started

Try it with your own prices.

The Evaluation plan is free for 90 days: load your pricelists, schedule a campaign price, and ask for the lowest price of the 30 days before it.