Initial Biomarkers and Biomarker Groups Setup

To ensure that the Docus Lab API functions efficiently, an initial setup of biomarkers and biomarker groups is required. This setup organizes lab test results in a structured way, making it easier to map test results to medical standards and generate AI-based insights.

1. Biomarker Groups Setup

A Biomarker Group is a collection of related biomarkers that belong to a specific category (e.g., Complete Blood Count, Liver Function Tests). Each group is identified by a biomarker group ID and contains metadata for biomarker group.

Optional: Using LOINC IDs from LOINC.org

📤 Create Biomarker Group

Endpoint: POST /biomarker-groups Create a biomarker

Purpose: Adds a new biomarker group or updates an existing one.

📥 Retrieve a Biomarker Group

Endpoint: GET /biomarker-groups/{biomarker_group_id} Get biomarker group by ID

Purpose: Fetches details of a biomarker group by its main LOINC ID.

2. Individual Biomarker Setup

A biomarker represents an individual lab test measurement with a corresponding LOINC code, unit, and descriptions. Each biomarker can be associated with a biomarker group via biomarker_group_id in exact lab test. Create a lab test

📤 Create Biomarker

Endpoint: POST /biomarkers Create a biomarker

Purpose: Adds a new biomarker.

📥 Retrieve Biomarker by LOINC ID

Endpoint: GET /biomarkers/{biomarker_id}

3. Bulk Import for Faster Setup

For large-scale biomarker and biomarker group setup, the API supports bulk import via a JSON payload.

📤 Bulk Upload Biomarkers

Endpoint: in progress

4. Why Setup Biomarkers and Biomarker Groups?

Standardization: Ensures lab test results are mapped to LOINC codes, making them interoperable.

Localization Support: Supports multi-language descriptions (Armenian, English, Russian).

AI Analysis: Helps the Docus Lab AI generate meaningful diagnostic reports.

Efficient Data Retrieval: Enables quick grouping and filtering of lab test results.

5. Summary of Setup Process

Create Biomarker Groups (POST /biomarker-groups)

Create Biomarkers (POST /biomarkers)

(Optional) Bulk Import Biomarkers (in progress)

Verify Data by Retrieving Groups and Biomarkers (GET /biomarker-groups/{biomarker_group_id}, GET /biomarkers/{biomarker_id})

Initial Biomarkers and Biomarker Groups Setup

1. Biomarker Groups Setup#

2. Individual Biomarker Setup#

3. Bulk Import for Faster Setup#

4. Why Setup Biomarkers and Biomarker Groups?#

5. Summary of Setup Process#

1. Biomarker Groups Setup

2. Individual Biomarker Setup

3. Bulk Import for Faster Setup

4. Why Setup Biomarkers and Biomarker Groups?

5. Summary of Setup Process