---
title: "Get a test or panel"
method: POST
path: "/api/agent/get_test"
tags: ["catalog"]
---

# Get a test or panel

`POST /api/agent/get_test`

## Request

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

Full public detail for one TestWell test or panel by slug or id: description, biomarkers, CPT, per-lab prices, labs, fasting/prep, turnaround, included tests (panels), FAQ, related conditions, order URL and a Markdown page URL.

## Request body

- object
  - `slug` string, required: Catalog slug (from search_tests) or id, e.g. 'tsh', 'general-wellness-panel'
  - `lang` 'en' | 'es': Spanish prose where a translation exists (default en)

## Response `200`

Tool result

- object
  - `tool` 'get_test', required
  - `result` object, required
    - `found` boolean
    - `item` object
      - `id` string
      - `slug` string
      - `type` 'test' | 'panel'
      - `name` string
      - `category` string
      - `description` string
      - `aliases` string[]
      - `cpt` string, nullable: CPT code when verified
      - `biomarkers` string[]
      - `biomarkerCount` number
      - `sampleType` string
      - `fastingRequired` boolean
      - `resultsIn` string: Turnaround, e.g. '1-3 business days'
      - `measuredTurnaround` object[]: Measured medians from real orders (specimen at lab → results), per lab; published only when n ≥ 30. Empty until enough data exists.
        - `lab` string, required
        - `n` number, required
        - `medianDays` number, required
        - `p90Days` number, nullable
        - `asOf` string, required
      - `prepInstructions` string, nullable
      - `labs` string[]: Labs that run it: Quest, Labcorp, BioReference
      - `prices` object: Sticker price per lab; null where the lab does not run the item
        - `quest` number, nullable: USD
        - `labcorp` number, nullable: USD
        - `bioreference` number, nullable: USD
      - `labFee` number: Flat per-order lab processing fee (charged once per order)
      - `currency` string
      - `orderable` boolean
      - `url` string: Absolute https URL on test-well.com
      - `markdownUrl` string: Absolute https URL on test-well.com
      - `orderUrl` string: Prefilled cart link
      - `reviewedAt` string, nullable
      - `popular` boolean
    - `suggestions` 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)