Request a Quote
POST/api/portal/quotes
Create a request-for-quote from the active cart (source: cart) or an explicit items list ([{product_id|sku, quantity}]). An optional note seeds the negotiation thread; an optional file attachment may be sent as multipart. Items need not be in the catalog or in stock. Returns the created quote.
Called by a B2B portal buyer with the bearer token POST /api/portal/auth/login returns (or the buyer's feed key) — not with a staff Personal Access Token.
Pricing pending: when the merchant hides requested-quote pricing until sending (Portal Settings → Quote requests), a quote still being worked on (draft or revised) has pricing_pending: true and every money field — subtotal, discount_total, tax_total, total, deposit, and each line's unit_price / line_total — is null. Quantities, products and the thread are still returned.
Each line starts at the price the buyer sees in the portal (contract, customer-specific, volume break or price-tier price) in the currency of their price list. Items that match no live product (unknown id or SKU, or an archived product) are skipped; the request fails with 422 only when none match.
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
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.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.