TB GeneXpert

GeneXpert MTB/RIF is a rapid molecular diagnostic test for Tuberculosis (TB) that simultaneously detects Mycobacterium tuberculosis (MTB) and resistance to Rifampicin directly from clinical specimens. The Cepheid GeneXpert platform delivers results in under two hours, enabling same-day treatment decisions at point of care.

The OpenLDR Analytics API provides 45 GeneXpert endpoints organized across four categories, covering the full spectrum of TB diagnostic program monitoring — from national summary indicators to patient-level result searches.

Overview

The GeneXpert module supports two result type platforms. All endpoints accept a genexpert_result_type parameter to filter by cartridge type:

Ultra 6 Cores: Xpert MTB/RIF Ultra cartridges — improved sensitivity for MTB detection with semi-quantitative results (High, Medium, Low, Very Low, Trace)
XDR 10 Cores: Xpert MTB/XDR cartridges — extended drug resistance testing for Isoniazid, Fluoroquinolones, and second-line injectable agents

Key analytics provided include:

Positivity tracking: MTB detected vs. not detected result monitoring across facilities and time periods
Drug resistance profiling: Rifampicin, Isoniazid, Fluoroquinolone, Ethionamide, and Amikacin resistance detection rates
Sample type analysis: Distribution across specimen types including sputum, feces, urine, and blood
Turnaround time (TAT): Four-segment measurement from collection to reception, reception to registration, registration to analysis, and analysis to validation
Error and invalid tracking: System error and invalid result monitoring for quality assurance

Documentation structure

The GeneXpert endpoint documentation is organized into four sections:

Summary

6 endpoints providing system-wide dashboard indicators, positivity trends, and sample type analytics.View endpoints

Laboratory

16 endpoints with testing data grouped by laboratory, including TAT, drug resistance, and rejection analysis.View endpoints

Health Facilities

19 endpoints with data grouped by requesting facility, including disaggregation by gender, age, drug type, and sample type.View endpoints

Patients

4 endpoints for patient-level result searches by name, facility, sample type, and result type.View endpoints

Common parameters

All GeneXpert endpoints accept these standard query parameters:

Name
interval_dates
Type
JSON array
Description
Date range filter: ["YYYY-MM-DD","YYYY-MM-DD"]. Defaults to last 12 months.
Name
province
Type
string
Description
Province name filter. Multi-select supported.
Name
district
Type
string
Description
District name filter. Multi-select supported.
Name
health_facility
Type
string
Description
Specific health facility name.
Name
facility_type
Type
string
Description
Grouping level: "province", "district", or "health_facility".
Name
disaggregation
Type
string
Description
Enable data breakdown: "True" or "False".
Name
genexpert_result_type
Type
string
Description
Filter by cartridge type: "Ultra 6 Cores" or "XDR 10 Cores".