HIV Viral Load

HIV Viral Load (VL) testing measures the amount of HIV RNA in a patient's blood, serving as the primary indicator for monitoring antiretroviral therapy (ART) effectiveness. Viral suppression (typically defined as fewer than 1,000 copies/mL) confirms successful treatment, while unsuppressed results signal the need for enhanced adherence counseling or regimen changes.

The OpenLDR Analytics API provides 35 VL endpoints organized across three categories, covering the full spectrum of viral load program monitoring — from national dashboard indicators to laboratory-level sample tracking and health facility analytics.

Overview

The VL module tracks viral suppression outcomes across the entire testing pipeline. All endpoints support filtering by date range, geographic location, and facility attributes.

Key analytics provided include:

• Viral suppression rates: Tracking of suppressed vs. not suppressed results across all dimensions
• Gender stratification: Male and female suppression breakdowns for targeted program analysis
• Age group analysis: Stratification across age bands (0-14, 15-19, 20-24, 25-29, 30-34, 35-39, 40-44, 45-49, 50+) for demographic insights
• Test reason analysis: Breakdown by routine monitoring, treatment failure suspicion, and unspecified reasons
• Pregnant and breastfeeding: Dedicated endpoints for PMTCT (Prevention of Mother-to-Child Transmission) program monitoring
• Turnaround time (TAT): Four-segment measurement covering collection-to-reception, reception-to-registration, registration-to-analysis, and analysis-to-validation

Documentation structure

The VL endpoint documentation is organized into three sections:

Common parameters

All VL endpoints accept these standard query parameters: