Get Labs

get_labs Parameters

Required Parameters

None - all parameters are optional

Optional Parameters

1. count (integer or null)

   • Default: 300
   • Description: Number of raw FHIR records to fetch BEFORE filtering. MINIMUM: 300 (automatically enforced). This parameter controls the raw fetch size to ensure sufficient data exists for filtering. Always use high values (≥300) for initial queries. Increase to 1000-5000 for comprehensive historical search scenarios.

2. end_date (date string or null)

3. • Default: null
   • Format: YYYY-MM-DD
   • Description: The latest date (inclusive) to include lab result records. If not provided, no upper date bound is applied.

4. labs (array of strings or null)

   • Default: null
   • Available lab types:
     • "Basic Metabolic Panel"
     • "Comprehensive Metabolic Panel"
     • "Complete Blood Count"
     • "Hemoglobin"
     • "Hematocrit"
     • "White Blood Cell Count"
     • "Platelet Count"
     • "Glucose"
     • "HbA1c"
     • "Creatinine"
     • "Blood Urea Nitrogen"
     • "Sodium"
     • "Potassium"
     • "Chloride"
     • "Calcium"
     • "Magnesium"
     • "Phosphate"
     • "Albumin"
     • "Total Protein"
     • "Bilirubin"
     • "Alkaline Phosphatase"
     • "AST"
     • "ALT"
     • "GGT"
     • "TSH"
     • "Free T4"
     • "Total T4"
     • "Free T3"
     • "Total T3"
     • "Lipid Panel"
     • "Cholesterol Total"
     • "HDL Cholesterol"
     • "LDL Cholesterol"
     • "Triglycerides"
     • "PT"
     • "INR"
     • "PTT"
     • "Fibrinogen"
     • "D-Dimer"
     • "Troponin I"
     • "Troponin T"
     • "BNP"
     • "NT-proBNP"
     • "CK-MB"
     • "CRP"
     • "ESR"
     • "Vitamin D"
     • "Vitamin B12"
     • "Folate"
     • "Iron"
     • "Ferritin"
     • "TIBC"
     • "PSA"
     • "Uric Acid"
     • "LDH"
     • "Amylase"
     • "Lipase"
     • "hCG"
     • "Urinalysis"
   • Description: Optional list of specific laboratory test types to filter by. If not specified, all available laboratory results will be retrieved. Use this to focus on specific tests the user is asking about.

5. output_formats (array of strings or null)

   • Default: null
   • Available formats: ["table", "markdown", "timeline", "statistics", "csv"]
   • Description: List of output formats for the lab data:
     • "table": Structured table format for detailed records
     • "markdown": Markdown-formatted table for documentation
     • "timeline": Chronological view of results
     • "statistics": Summary statistics and aggregated insights
     • "csv": Comma-separated values format for spreadsheet import
   • Examples of when to use:
     • 'table' for "Show me my cholesterol results from the last year"
     • 'statistics' for "What is my average glucose over the past 6 months?"
     • 'csv' for "Export my labs to a spreadsheet" or "Give me lab results in CSV format"
     • 'markdown' for "Format my lab results for documentation"
     • Multiple formats for comprehensive requests

6. start_date (date string or null)

7. • Default: null
   • Format: YYYY-MM-DD
   • Description: The earliest date (inclusive) to include lab result records. If not provided, no lower date bound is applied.

When to Use get_labs

This tool is designed for retrieving laboratory results (lab tests) from FHIR Observation resources. Use when users ask about:

• Lab results, blood tests, panels, or specific laboratory measurements
• CBC, metabolic panel, cholesterol, glucose, hemoglobin A1c
• Any laboratory test over time
• Requests like "Show me my cholesterol results from the last year" or "What is my average glucose over the past 6 months?"