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 %).
orders:writeGrant 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
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.