Skip to main content

Preview Quote Line Prices

POST 

/api/quotes/price-preview

Previews the unit price each product line would get on a NEW quote for this customer and currency, before the quote exists — the same pricing ladder POST /api/quotes applies to a product line sent without unit_price: contract price → customer price → tier volume break → tier base price (less the customer's discount %).

Required scope: orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Used by the New Quote dialog so its line totals match the quote it creates. Nothing is saved.

Body

  • customer_id (integer, optional) — the customer to price for. Without one, lines take the default tier's price.
  • currency_code (string, optional) — the quote currency; blank means the tenant default, as on create. The ladder applies only in the customer's tier currency; in another currency the line takes the tier base price.
  • lines (array, required, 1–500) — {product_id, quantity}.

Response {data: [{product_id, quantity, unit_price, price_source, price_min_quantity}]}. price_source is one of contract, customer, volume_break, tier, default or unconfigured (no price set: unit_price 0). Lines whose product does not exist are left out.

Authentication: Requires Bearer token. Permission: quotes.create.

Request​

Responses​

OK

Response Headers
    Content-Type