---
title: "Get Paginated Lab Tests For Team"
method: GET
path: "/v3/lab_test"
tags: ["lab_tests"]
---

# Get Paginated Lab Tests For Team

`GET /v3/lab_test`

GET lab tests the team has access to as a paginated list.

## Query parameters

- `lab_test_limit` integer
- `next_cursor` string, nullable — The cursor for fetching the next page, or `null` to fetch the first page.
- `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.
- `generation_method` 'auto' | 'manual' | 'all' — ℹ️ This enum is non-exhaustive.
- `lab_slug` string, nullable — Filter by the slug of the lab for these lab tests.
- `collection_method` 'testkit' | 'walk_in_test' | 'at_home_phlebotomy' | 'on_site_collection' — The method used to perform a lab test. ℹ️ This enum is non-exhaustive.
- `status` 'active' | 'pending_approval' | 'inactive' — ℹ️ This enum is non-exhaustive.
- `marker_ids` integer[], nullable — Filter to only include lab tests containing these marker IDs.
- `provider_ids` string[], nullable — Filter to only include lab tests containing these provider IDs.
- `name` string, nullable — Filter by the name of the lab test (a case-insensitive substring search).
- `order_key` 'price' | 'created_at' | 'updated_at', nullable
- `order_direction` 'asc' | 'desc'

## Response `200`

Successful Response

- LabTestResourcesResponse
  - `data` ClientFacingLabTest[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `sample_type` 'dried_blood_spot' | 'arm_collector' | 'serum' | 'saliva' | 'urine' | 'stool', required — The type of sample used to perform a lab test. ℹ️ This enum is non-exhaustive.
    - `method` 'testkit' | 'walk_in_test' | 'at_home_phlebotomy' | 'on_site_collection', required — The method used to perform a lab test. ℹ️ This enum is non-exhaustive.
    - `price` number, required
    - `is_active` boolean, required — Deprecated. Use status instead.
    - `status` 'active' | 'pending_approval' | 'inactive', required — ℹ️ This enum is non-exhaustive.
    - `fasting` boolean — Defines whether a lab test requires fasting.
    - `lab` ClientFacingLab, required
      - `id` integer, required
      - `slug` string, required
      - `name` string, required
      - `first_line_address` string, required
      - `city` string, required
      - `zipcode` string, required
      - `collection_methods` LabTestCollectionMethod[], required
      - `sample_types` LabTestSampleType[], required
      - `logo_url` string, nullable
    - `markers` ClientFacingMarker[], nullable, 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
    - `is_delegated` boolean — Deprecated and always false. Delegation is now at the lab account level. Used to denote whether a lab test requires using non-Vital physician networks.
    - `auto_generated` boolean — Whether the lab test was auto-generated by Vital
    - `has_collection_instructions` boolean, nullable — Whether or not the lab test has collection instructions.
    - `common_tat_days` integer, nullable — The common turnaround time in days for the lab test. This is the expected time for the lab to process the test and return results.
    - `worst_case_tat_days` integer, nullable — The worst-case turnaround time in days for the lab test. This is the maximum time the lab may take to process the test and return results.
  - `next_cursor` string, nullable, required — The cursor for fetching the next page, or `null` to fetch the first page.
  - `pricing` GetLabTestPricingResponse — Aggregated per-panel pricing, keyed by lab test 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/versions/d28f5cec7d79/schema)