Accept quote

curl --request POST \
  --url https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "notes": "Please expedite processing",
  "purchase_order_number": "PO-2026-00142"
}
'

import requests

url = "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm"

payload = {
    "notes": "Please expedite processing",
    "purchase_order_number": "PO-2026-00142"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({notes: 'Please expedite processing', purchase_order_number: 'PO-2026-00142'})
};

fetch('https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'notes' => 'Please expedite processing',
    'purchase_order_number' => 'PO-2026-00142'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm"

	payload := strings.NewReader("{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "status": "draft",
  "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678",
  "invoice_id": "<string>",
  "payment": {
    "kind": "hosted_invoice",
    "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678",
    "methods": [
      "x402-exact",
      "mpp-spt"
    ],
    "pay_url": "/api/v1/invoices/in_1OqLk2LkdIwHu7ix6OboRpXl/pay"
  }
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

quotes

Accept quote

Finalizes and accepts a Stripe quote, creating the (open, unpaid) invoice and advancing the linked experiment to WaitingForMaterials. Optionally attach a purchase order number for your records.

A JSON body is required. Every field of ConfirmQuoteRequest is optional, so a caller with no purchase-order number and no notes sends {} — the refusal says so if they forget (BUG-0059).

This endpoint is categorically non-settling: it never settles a payment and never emits a payment 402. The 200 response carries the finalized invoice plus a HATEOAS payment pointer telling you where and how to pay — the Stripe-hosted page for an async-invoice quote, or POST /invoices/{invoice_id}/pay for a machine rail (x402-exact / mpp-spt), where the 402 challenge is answered.

The quote must be in a confirmable state (“Waiting for confirmation” or “Quote sent”) and must not already have an invoice. Expired or otherwise non-confirmable quotes return 409.

POST

api

quotes

{quote_id}

confirm

Accept quote

curl --request POST \
  --url https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "notes": "Please expedite processing",
  "purchase_order_number": "PO-2026-00142"
}
'

import requests

url = "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm"

payload = {
    "notes": "Please expedite processing",
    "purchase_order_number": "PO-2026-00142"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({notes: 'Please expedite processing', purchase_order_number: 'PO-2026-00142'})
};

fetch('https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'notes' => 'Please expedite processing',
    'purchase_order_number' => 'PO-2026-00142'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm"

	payload := strings.NewReader("{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://devs.adaptyvbio.com/api/v1/quotes/{quote_id}/confirm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"notes\": \"Please expedite processing\",\n  \"purchase_order_number\": \"PO-2026-00142\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "status": "draft",
  "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678",
  "invoice_id": "<string>",
  "payment": {
    "kind": "hosted_invoice",
    "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678",
    "methods": [
      "x402-exact",
      "mpp-spt"
    ],
    "pay_url": "/api/v1/invoices/in_1OqLk2LkdIwHu7ix6OboRpXl/pay"
  }
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

{
  "error": "experiment not found",
  "request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}

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.

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).

Show child attributes

Getting Started

Payments

API Endpoints

Accept quote

Authorizations

Path Parameters

Body

Response