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.

Initial biomarker and biomarker group data can be set up via the Partner Web Console, through CSV Upload. We provide a structured CSV format and example for bulk imports.

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 main LOINC ID and contains metadata for localization.

Example of using main LOINC ID for CBC - https://loinc.org/58410-2

📤 Create Biomarker Group

Endpoint: POST /biomarker-groups

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

Request Example:

{
  "biomarker_group_id": "1542-89",
  "titleEn": "Complete Blood Count",
  "abbr": "CBC"
}

2. Individual Biomarker Setup

A biomarker represents an individual lab test measurement with a corresponding LOINC code, unit, and descriptions. Each biomarker is associated with a biomarker group via mainLoincId.

📤 Create Biomarker

Endpoint: POST /biomarkers

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

Request Example:

{
  "biomarker_id": "6690-2",
  "title": "Leukocytes",
  "abbr": "WBC",
  "unit": "10^9/L"
}

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: POST /biomarkers/bulk

Request Example:

{
  "biomarkers": [
    {
      "biomarker_id": "6690-2",
      "title": "Leukocytes",
      "unit": "10^9/L"
    },
    {
      "biomarker_id": "718-7",
      "titleEn": "Hemoglobin",
      "unit": "g/dL"
    }
  ]
}

📥 Response Example:

{
  "message": "2 biomarkers imported successfully"
}

4. Biomarker Groups and Biomarkers Relationship

In progress

5. 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.

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

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

6. Summary of Setup Process

Create Biomarker Groups (POST /biomarker-groups)

Add Individual Biomarkers (POST /biomarkers)

(Optional) Bulk Import Biomarkers (POST /biomarkers/bulk)

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

This setup ensures smooth processing and AI-based analysis for lab results.

Initial Biomarkers and Biomarker Groups Setup

1. Biomarker Groups Setup#

2. Individual Biomarker Setup#

3. Bulk Import for Faster Setup#

4. Biomarker Groups and Biomarkers Relationship#

5. Why Setup Biomarkers and Biomarker Groups?#

6. Summary of Setup Process#

1. Biomarker Groups Setup

2. Individual Biomarker Setup

3. Bulk Import for Faster Setup

4. Biomarker Groups and Biomarkers Relationship

5. Why Setup Biomarkers and Biomarker Groups?

6. Summary of Setup Process