Skip to main content
POST
Accept quote

Authorizations

Authorization
string
header
required

Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the /tokens endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use /tokens/attenuate to create restricted tokens for delegation.

Path Parameters

quote_id
string
required

Unique identifier of the quote to accept

Body

application/json

Request payload for accepting a quote

Used when a customer decides to accept a quoted price.

notes
string | null

Reserved for future use. Currently accepted but not acted upon.

Example:

"Please expedite processing"

purchase_order_number
string | null

Purchase order number from your organization (optional)

Example:

"PO-2026-00142"

Response

Quote accepted; the (open, unpaid) invoice is finalized and the payment block points at where/how to pay

Response after accepting a quote

Confirms the quote acceptance and provides invoice information if applicable.

id
string
required

Quote ID that was accepted

status
enum<string>
required

New status (accepted after confirmation)

Available options:
draft,
open,
accepted,
canceled,
stale
hosted_invoice_url
string | null

Stripe-hosted URL where the customer can view and pay the generated invoice

Example:

"https://invoice.stripe.com/i/acct_1234/test_5678"

invoice_id
string | null

ID of the invoice generated from this quote (if applicable)

payment
null | object

Hypermedia pointer to where and how to pay the finalized (open, unpaid) invoice. Present on the non-settling confirm response — hosted_invoice for an async-invoice quote, machine for a machine rail. Absent on other uses of this DTO (e.g. an already-settled response).