---
title: "Get Markers"
method: GET
path: "/v3/lab_tests/markers"
tags: ["lab_tests"]
---

# Get Markers

`GET /v3/lab_tests/markers`

List active and orderable markers for a given Lab. Note that reflex markers are not included.

## Query parameters

- `lab_id` integer[], nullable — The identifier Vital assigned to a lab partner.
- `lab_slug` string, nullable — The slug of the lab for these markers. If both lab_id and lab_slug are provided, lab_slug will be used.
- `name` string — The name or test code of an individual biomarker or a panel.
- `a_la_carte_enabled` boolean, nullable
- `include_pricing` boolean
- `lab_account_id` string, uuid, nullable — The lab account ID. This lab account is used to determine the availability of markers and lab tests.
- `page` integer
- `size` integer

## Response `200`

Successful Response

- GetMarkersResponse
  - `markers` ClientFacingMarkerComplete[], required
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `description` string, nullable
    - `lab_id` integer, nullable
    - `provider_id` string, nullable
    - `type` 'biomarker' | 'panel' — ℹ️ This enum is non-exhaustive.
    - `unit` string, nullable
    - `price` string, nullable
    - `aoe` AoE
      - `questions` Question[], required
        - `id` integer, required
        - `required` boolean, required
        - `code` string, required
        - `value` string, required
        - `type` 'choice' | 'text' | 'numeric' | 'multi_choice', required — ℹ️ This enum is non-exhaustive.
        - `sequence` integer, required
        - `answers` Answer[], required
          - `id` integer, required
          - `code` string, required
          - `value` string, required
        - `constraint` string, nullable
        - `default` string, nullable
    - `a_la_carte_enabled` boolean
    - `common_tat_days` integer, nullable
    - `worst_case_tat_days` integer, nullable
    - `is_orderable` boolean, nullable
    - `expected_results` ClientFacingResult[], required
      - `id` integer, required
      - `name` string, required
      - `slug` string, required
      - `lab_id` integer, nullable
      - `provider_id` string, nullable
      - `required` boolean, required
      - `loinc` ClientFacingLoinc
        - `id` integer, required
        - `name` string, required
        - `slug` string, required
        - `code` string, required
        - `unit` string, nullable
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable, required
  - `pricing` MarkerPricingResponse — Per-marker pricing, keyed by marker ID.
    - `currency` 'USD'
    - `data` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryvital/apis/junction-api.md) · [All operations](https://skmtc.net/tryvital/apis/junction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryvital/junction-api/revisions/034402e2bbe3/schema)