v71

OpenAPI 3.1.0raw.githubusercontent.com2026-08-032076961.5 MB

lab_tests

Get Lab Tests For Team

GET all the lab tests the team has access to.

get/v3/lab_tests

Query parameters

generation_method'auto' | 'manual' | 'all'

ℹ️ This enum is non-exhaustive.

Filter on whether auto-generated lab tests created by Vital, manually created lab tests, or all lab tests should be returned.

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

Filter by the collection method for these lab tests.

status'active' | 'pending_approval' | 'inactive'

ℹ️ This enum is non-exhaustive.

Filter by the status of these lab tests.

marker_idsinteger[] nullable

Filter to only include lab tests containing these marker IDs.

provider_idsstring[] nullable

Filter to only include lab tests containing these provider IDs.

namestring 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

Successful Response

idstring uuid required

slugstring required

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

pricenumber required

is_activeboolean required

Deprecated. Use status instead.

status'active' | 'pending_approval' | 'inactive' required

ℹ️ This enum is non-exhaustive.

fastingboolean

Defines whether a lab test requires fasting.

is_delegatedboolean

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_generatedboolean

Whether the lab test was auto-generated by Vital

has_collection_instructionsboolean nullable

Whether or not the lab test has collection instructions.

common_tat_daysinteger 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_daysinteger 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.

Example response

[
  {
    "lab_test": {
      "description": "Cholesterol test",
      "fasting": false,
      "has_collection_instructions": false,
      "is_delegated": false,
      "lab": {
        "city": "New York",
        "first_line_address": "123 Main St",
        "name": "US Specialty Lab",
        "slug": "USSL",
        "zipcode": "10001"
      },
      "markers": [
        {
          "description": "Hemoglobin A1c is a form of hemoglobin that is measured identify your average blood sugar levels over the past 3 months.",
          "id": 1,
          "lab_id": 1,
          "name": "Hemoglobin A1c",
          "price": "10.00",
          "provider_id": "1234",
          "slug": "hemoglobin-a1c",
          "type": "biomarker",
          "unit": "%"
        }
      ],
      "method": "testkit",
      "name": "Lipids Panel",
      "price": 10,
      "sample_type": "dried blood spot",
      "status": "active"
    }
  }
]