v71

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

lab_tests

Get Lab Test For Team

GET all the lab tests the team has access to.

get/v3/lab_tests/{lab_test_id}

Path parameters

lab_test_idstring uuid required

Query parameters

lab_account_idstring uuid nullable

The lab account ID. This lab account is used to determine the availability of markers and lab tests.

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"
  }
}