Vitality Blueprint Public API

{
  "report_id": "rpt_sb_9e4d8f1a",
  "order_id": "ord_sb_7f3a1b2c",
  "status": "completed",
  "environment": "sandbox",
  "client": {
    "external_id": "user_12345",
    "first_name": "John",
    "last_name": "Doe",
    "sex": "male",
    "age": 34
  },
  "blood_draw_date": "2026-03-01",
  "vitality_score": 72.4,
  "biological_age": 31.2,
  "functional_areas": [
    {
      "key": "energy", "name": "Energy", "score": 81.3,
      "description": "Energy is the summation of all the systems in the body.",
      "deeper_explanation": "Understanding which systems are working efficiently reveals opportunities for improvement.",
      "implication": "Your energy systems are functioning well overall, with room for targeted improvement.",
      "most_impactful_markers": [
        { "key": "ferritin", "name": "Ferritin", "flag": "low", "significance": "individually_significant" },
        { "key": "vitamin_d_25_oh", "name": "Vitamin D, 25-OH", "flag": "low", "significance": "individually_significant" }
      ]
    },
    {
      "key": "micronutrients", "name": "Micronutrients", "score": 48.9,
      "description": "Critical vitamins and minerals that form the backbone of human performance.",
      "deeper_explanation": "Even mild insufficiencies can cascade across multiple systems.",
      "implication": "Multiple key micronutrients are below optimal levels.",
      "most_impactful_markers": [
        { "key": "vitamin_d_25_oh", "name": "Vitamin D, 25-OH", "flag": "low", "significance": "critically_significant" },
        { "key": "magnesium_rbc", "name": "Magnesium, RBC", "flag": "low", "significance": "critically_significant" },
        { "key": "ferritin", "name": "Ferritin", "flag": "low", "significance": "individually_significant" }
      ]
    },
    { "key": "inflammation", "name": "Inflammation", "score": 55.8, "description": "The body is constantly working to maintain balance.", "deeper_explanation": "Chronic low-grade inflammation is pervasive.", "implication": "Elevated inflammatory markers suggest systemic inflammation.", "most_impactful_markers": [{ "key": "hs_crp", "name": "hs-CRP", "flag": "high", "significance": "critically_significant" }] },
    { "key": "resilience", "name": "Resilience", "score": 62.5, "description": "The ability to respond to challenges.", "deeper_explanation": "Repeated performance requires exceptional recovery.", "implication": "Moderately impacted by micronutrient gaps and inflammation.", "most_impactful_markers": [] },
    { "key": "cardiovascular", "name": "Cardiovascular Health", "score": 65.3, "description": "Supports every cell in the body.", "deeper_explanation": "Assessed through lipid profiles and inflammatory markers.", "implication": "Elevated LDL and inflammation create moderate risk.", "most_impactful_markers": [{ "key": "ldl_cholesterol", "name": "LDL Cholesterol", "flag": "high", "significance": "individually_significant" }] },
    { "key": "hormone_profile", "name": "Hormone Profile", "score": 71.0, "description": "Primary messengers in the body.", "deeper_explanation": "Key driver of energy, composition, and recovery.", "implication": "Testosterone normal but below optimal.", "most_impactful_markers": [] },
    { "key": "cellular_health", "name": "Cellular Health", "score": 78.2, "description": "The most basic working unit.", "deeper_explanation": "Energy production and repair efficiency.", "implication": "In good standing.", "most_impactful_markers": [] },
    { "key": "brain_chemistry", "name": "Brain Chemistry", "score": 82.5, "description": "Controls mental and physical performance.", "deeper_explanation": "Neurotransmitter precursors and nutrient availability.", "implication": "Performing well.", "most_impactful_markers": [] },
    { "key": "sleep", "name": "Sleep", "score": 88.0, "description": "Foundational pillar of performance.", "deeper_explanation": "How well biochemistry supports restorative sleep.", "implication": "In strong shape.", "most_impactful_markers": [] },
    { "key": "gut_health", "name": "Gut Health", "score": 85.0, "description": "Billions of microorganisms.", "deeper_explanation": "Inflammatory load and nutrient absorption.", "implication": "Strong position.", "most_impactful_markers": [] },
    { "key": "hydration", "name": "Hydration", "score": 90.1, "description": "Crucial for performance.", "deeper_explanation": "Electrolyte balance and kidney function.", "implication": "Excellent.", "most_impactful_markers": [] },
    { "key": "stress", "name": "Stress", "score": 76.4, "description": "Can facilitate growth when managed.", "deeper_explanation": "How the body copes with demands.", "implication": "Acceptable.", "most_impactful_markers": [] },
    { "key": "toxic_load", "name": "Toxic Load", "score": 88.7, "description": "Strains filtration processes.", "deeper_explanation": "Liver and kidney clearance.", "implication": "Functioning well.", "most_impactful_markers": [] }
  ],
  "biomarkers": [
    { "key": "vitamin_d_25_oh", "name": "Vitamin D, 25-OH", "result": 22.5, "unit": "ng/mL", "status": "out_of_range", "flag": "low", "ranges": { "optimal": "50 - 80 ng/mL", "normal": "30 - 100 ng/mL" }, "description": "Critical for calcium absorption, immune function, and muscle performance.", "explanation": "At 22.5 ng/mL, significantly below optimal.", "explanation_sources": ["Holick MF. N Engl J Med. 2007;357:266-281"], "functional_areas": [{ "key": "micronutrients", "score": 48.9 }, { "key": "resilience", "score": 62.5 }, { "key": "inflammation", "score": 55.8 }], "performance_goals": [{ "key": "endurance" }, { "key": "muscle_strength" }] },
    { "key": "magnesium_rbc", "name": "Magnesium, RBC", "result": 4.1, "unit": "mg/dL", "status": "out_of_range", "flag": "low", "ranges": { "optimal": "5.0 - 6.5 mg/dL", "normal": "4.2 - 6.8 mg/dL" }, "description": "Involved in 300+ enzymatic reactions.", "explanation": "Below optimal, impairs ATP production.", "explanation_sources": [], "functional_areas": [{ "key": "micronutrients", "score": 48.9 }], "performance_goals": [{ "key": "muscle_strength" }] },
    { "key": "ferritin", "name": "Ferritin", "result": 28, "unit": "ng/mL", "status": "out_of_range", "flag": "low", "ranges": { "optimal": "75 - 150 ng/mL", "normal": "30 - 400 ng/mL" }, "description": "Primary iron storage marker.", "explanation": "Depleted iron stores impair oxygen transport.", "explanation_sources": [], "functional_areas": [{ "key": "micronutrients", "score": 48.9 }, { "key": "energy", "score": 81.3 }], "performance_goals": [{ "key": "endurance" }] },
    { "key": "hs_crp", "name": "hs-CRP", "result": 3.8, "unit": "mg/L", "status": "out_of_range", "flag": "high", "ranges": { "optimal": "< 1.0 mg/L", "normal": "< 3.0 mg/L" }, "description": "Most reliable inflammation indicator.", "explanation": "Elevated systemic inflammation.", "explanation_sources": [], "functional_areas": [{ "key": "inflammation", "score": 55.8 }, { "key": "cardiovascular", "score": 65.3 }], "performance_goals": [{ "key": "endurance" }] },
    { "key": "ldl_cholesterol", "name": "LDL Cholesterol", "result": 158, "unit": "mg/dL", "status": "out_of_range", "flag": "high", "ranges": { "optimal": "< 100 mg/dL", "normal": "< 130 mg/dL" }, "description": "Primary cardiovascular risk factor.", "explanation": "Elevated, increases arterial plaque risk.", "explanation_sources": [], "functional_areas": [{ "key": "cardiovascular", "score": 65.3 }], "performance_goals": [{ "key": "endurance" }] },
    { "key": "hdl_cholesterol", "name": "HDL Cholesterol", "result": 58, "unit": "mg/dL", "status": "optimal", "flag": "ok", "ranges": { "optimal": "50 - 90 mg/dL", "normal": "40 - 100 mg/dL" }, "description": "Protective cholesterol.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "cardiovascular", "score": 65.3 }], "performance_goals": [] },
    { "key": "testosterone_total", "name": "Testosterone, Total", "result": 485, "unit": "ng/dL", "status": "normal", "flag": "ok", "ranges": { "optimal": "550 - 900 ng/dL", "normal": "264 - 916 ng/dL" }, "description": "Primary male sex hormone.", "explanation": "Normal but below optimal.", "explanation_sources": [], "functional_areas": [{ "key": "hormone_profile", "score": 71.0 }], "performance_goals": [{ "key": "muscle_strength" }] },
    { "key": "hemoglobin_a1c", "name": "Hemoglobin A1C", "result": 5.1, "unit": "%", "status": "optimal", "flag": "ok", "ranges": { "optimal": "4.0 - 5.3 %", "normal": "4.0 - 5.6 %" }, "description": "Average blood sugar control.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "cellular_health", "score": 78.2 }], "performance_goals": [{ "key": "fat_loss" }] },
    { "key": "tsh", "name": "TSH", "result": 1.8, "unit": "uIU/mL", "status": "optimal", "flag": "ok", "ranges": { "optimal": "1.0 - 2.5 uIU/mL", "normal": "0.45 - 4.5 uIU/mL" }, "description": "Thyroid function marker.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "hormone_profile", "score": 71.0 }], "performance_goals": [{ "key": "fat_loss" }] },
    { "key": "vitamin_b12", "name": "Vitamin B12", "result": 650, "unit": "pg/mL", "status": "optimal", "flag": "ok", "ranges": { "optimal": "500 - 1000 pg/mL", "normal": "232 - 1245 pg/mL" }, "description": "Essential for red blood cells and neurological function.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "micronutrients", "score": 48.9 }], "performance_goals": [{ "key": "cognitive_performance" }] }
  ],
  "ratios": [
    { "key": "total_cholesterol_hdl_ratio", "name": "Total Cholesterol / HDL Ratio", "result": 4.2, "unit": null, "status": "normal", "flag": "ok", "ranges": { "optimal": "< 3.5", "normal": "< 5.0" }, "components": ["total_cholesterol", "hdl_cholesterol"], "description": "Cardiovascular risk predictor.", "explanation": "Normal but above optimal.", "explanation_sources": [], "functional_areas": [{ "key": "cardiovascular", "score": 65.3 }] },
    { "key": "triglyceride_hdl_ratio", "name": "Triglyceride / HDL Ratio", "result": 1.4, "unit": null, "status": "optimal", "flag": "ok", "ranges": { "optimal": "< 2.0", "normal": "< 3.0" }, "components": ["triglycerides", "hdl_cholesterol"], "description": "Insulin resistance surrogate.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "cardiovascular", "score": 65.3 }] }
  ],
  "calculations": [
    { "key": "egfr", "name": "eGFR", "result": 105, "unit": "mL/min/1.73m²", "status": "optimal", "flag": "ok", "ranges": { "optimal": "> 90", "normal": "> 60" }, "components": ["creatinine"], "description": "Kidney function.", "explanation": null, "explanation_sources": [], "functional_areas": [{ "key": "toxic_load", "score": 88.7 }] },
    { "key": "homa_ir", "name": "HOMA-IR", "result": 1.8, "unit": null, "status": "normal", "flag": "ok", "ranges": { "optimal": "< 1.0", "normal": "< 2.5" }, "components": ["glucose_fasting", "insulin_fasting"], "description": "Insulin resistance estimate.", "explanation": "Normal but above optimal.", "explanation_sources": [], "functional_areas": [{ "key": "cellular_health", "score": 78.2 }] }
  ],
  "key_constraint": {
    "key": "micronutrient_deficiency",
    "name": "Micronutrient Deficiency",
    "what_is": "Critical vitamins and minerals fall below levels needed for optimal function.",
    "how_it_impacts_physiology": "Depleted stores force the body to triage resources, reducing energy, immune response, and recovery.",
    "how_it_impacts_performance": "Directly limits training adaptations, cognitive sharpness, and resilience to stress.",
    "symptoms": [
      { "text": "Persistent fatigue despite adequate sleep" },
      { "text": "Slow recovery between training sessions" },
      { "text": "Muscle cramps or tightness" },
      { "text": "Difficulty maintaining focus" },
      { "text": "Frequent illness or prolonged colds" }
    ],
    "related_biomarkers": [
      { "key": "vitamin_d_25_oh", "name": "Vitamin D, 25-OH", "flag": "low" },
      { "key": "magnesium_rbc", "name": "Magnesium, RBC", "flag": "low" },
      { "key": "ferritin", "name": "Ferritin", "flag": "low" }
    ],
    "impacted_functional_areas": [
      { "key": "micronutrients", "name": "Micronutrients", "score": 48.9 },
      { "key": "energy", "name": "Energy", "score": 81.3 },
      { "key": "resilience", "name": "Resilience", "score": 62.5 }
    ]
  },
  "recommendations": [
    { "type": "supplementation", "key": "vitamin_d3_supplement", "what": "Vitamin D3 Supplement", "how": "Take 5,000 IU daily with a fat-containing meal. Pair with K2 (MK-7, 100mcg).", "why": "Vitamin D at 22.5 ng/mL is significantly below optimal (50-80 ng/mL).", "priority": "key_constraint", "targets": [{ "type": "biomarker", "key": "vitamin_d_25_oh" }, { "type": "constraint", "key": "micronutrient_deficiency" }], "impact_functional_areas": [{ "key": "micronutrients" }, { "key": "resilience" }], "impact_performance_goals": [{ "key": "endurance" }], "sources": [{ "title": "Holick MF. Vitamin D deficiency.", "link": "https://pubmed.ncbi.nlm.nih.gov/17634462/" }] },
    { "type": "supplementation", "key": "magnesium_glycinate_supplement", "what": "Magnesium Glycinate Supplement", "how": "Take 400mg 30-60 min before bed.", "why": "RBC Magnesium at 4.1 mg/dL is below optimal.", "priority": "key_constraint", "targets": [{ "type": "biomarker", "key": "magnesium_rbc" }], "impact_functional_areas": [{ "key": "micronutrients" }, { "key": "sleep" }], "impact_performance_goals": [{ "key": "muscle_strength" }], "sources": [{ "title": "Magnesium and exercise", "link": "https://pubmed.ncbi.nlm.nih.gov/28986916/" }] },
    { "type": "nutrition", "key": "iron_rich_diet", "what": "Iron-Rich Dietary Protocol", "how": "2-3 servings/week of heme iron sources. Pair with Vitamin C.", "why": "Ferritin at 28 ng/mL indicates depleted iron stores.", "priority": "key_constraint", "targets": [{ "type": "biomarker", "key": "ferritin" }], "impact_functional_areas": [{ "key": "micronutrients" }, { "key": "energy" }], "impact_performance_goals": [{ "key": "endurance" }], "sources": [{ "title": "Iron bioavailability", "link": "https://pubmed.ncbi.nlm.nih.gov/20200263/" }] },
    { "type": "nutrition", "key": "anti_inflammatory_nutrition", "what": "Anti-Inflammatory Nutrition Protocol", "how": "Increase omega-3 to 3-4g EPA/DHA daily. Add turmeric, berries, leafy greens.", "why": "hs-CRP at 3.8 mg/L indicates elevated inflammation.", "priority": "biomarker", "targets": [{ "type": "biomarker", "key": "hs_crp" }], "impact_functional_areas": [{ "key": "inflammation" }, { "key": "cardiovascular" }], "impact_performance_goals": [{ "key": "endurance" }], "sources": [{ "title": "Omega-3 and inflammation", "link": "https://pubmed.ncbi.nlm.nih.gov/20500789/" }] },
    { "type": "lifestyle", "key": "zone_2_cardiovascular_training", "what": "Zone 2 Cardiovascular Training", "how": "3 sessions/week, 30-45 min at conversational effort (120-140 BPM).", "why": "Improves mitochondrial density and lipid profiles.", "priority": "biomarker", "targets": [{ "type": "biomarker", "key": "ldl_cholesterol" }], "impact_functional_areas": [{ "key": "cardiovascular" }, { "key": "inflammation" }], "impact_performance_goals": [{ "key": "endurance" }, { "key": "fat_loss" }], "sources": [{ "title": "Zone 2 and metabolic health", "link": "https://pubmed.ncbi.nlm.nih.gov/29934424/" }] }
  ],
  "created_at": "2026-03-08T14:30:00Z"
}