---
title: "All-in order quote"
method: POST
path: "/api/agent/quote_order"
tags: ["quote"]
---

# All-in order quote

`POST /api/agent/quote_order`

## Request

- Base URL: `https://www.test-well.com`
- URL: `https://www.test-well.com/api/agent/quote_order`
- Auth: none declared

Price a set of tests/panels exactly as TestWell's checkout would: per-lab prices for the user's state (New York and New Jersey route to BioReference; Rhode Island is not served), the single $6 lab processing fee, the total, items that can't be ordered and why, and a prefilled cart URL.

## Request body

- object
  - `items` string[], required: Catalog slugs or ids, e.g. ['tsh', 'vitamin-d']
  - `state` string: US state code or name where the user will be drawn, e.g. 'FL' or 'Florida'
  - `lab` 'quest' | 'labcorp' | 'bioreference': Preferred lab outside NY/NJ (default quest)

## Response `200`

Tool result

- object
  - `tool` 'quote_order', required
  - `result` object, required
    - `ok` boolean
    - `error` string: Present when ok=false, e.g. state not served
    - `state` string
    - `lab` string
    - `labName` string
    - `lines` object[]
      - `id` string
      - `slug` string
      - `type` string
      - `name` string
      - `lab` string
      - `price` number: USD
      - `url` string: Absolute https URL on test-well.com
    - `unavailable` unknown[]: Requested items the routed lab cannot run in this state
      - unknown
    - `subtotal` number: USD
    - `labFee` number: USD
    - `total` number: All-in total: subtotal + the single lab processing fee
    - `currency` string
    - `checkoutUrl` string, nullable: Absolute https URL on test-well.com
    - `notes` string[]

## Other responses

- `400`: Invalid input
- `429`: Rate limited

---

[API](https://skmtc.dev/test-well/apis/testwell-agent-api.md) · [All operations](https://skmtc.dev/test-well/apis/testwell-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/test-well/apis/testwell-agent-api/revisions/6e260731dfa4?raw)