Docus Lab SAAS Sandbox
    Docus Lab SAAS Sandbox
    • Getting Started
    • Initial Biomarkers and Biomarker Groups Setup
    • Flow Between Lab and API
    • Limitations
    • Support
    • Patient
      • Create a patient
        POST
      • Update a patient
        PUT
      • Get patient by ID
        GET
    • Visit
      • Create visit
        POST
      • Create composite visit
        POST
      • Generate AI report
        POST
      • Get AI report by visit ID
        GET
    • Lab Test
      • Create a plain lab test
        POST
      • Create a lab test with biomarkers
        POST
      • Create bulk plain lab tests
        POST
      • Create bulk lab tests with biomarkers
        POST
      • Get lab test by ID
        GET
    • Biomarker Group
      • Create a biomarker group
        POST
      • Update a biomarker group
        PUT
      • Get biomarker group by ID
        GET
    • Biomarker
      • Create a biomarker
        POST
      • Update biomarker by ID
        PUT
      • Get biomarker by ID
        GET
    • Branch
      • Create a branch
        POST
      • Update branch by ID
        PUT
      • Get branch by ID
        GET
    • Webhooks
      • Health reports
      • Notifications
    • Schemas
      • Schemas
        • UpdateBiomarkerDto
        • CreateLabTestPlanDTO
        • UpdateBiomarkerGroupDto
        • LabTestReport
        • CreateCompositeVisitDto
        • MultipleTestIdsDto
        • CreateBulkLabTestsPlainDTO
        • CreateBulkLabTestsDTO
        • CreateBranchDto
        • UpdateBranchDto
        • Biomarker
        • CreateBiomarkerGroupDto
        • CreateBiomarkerDto
        • SingleReport
        • CreatePatientDto
        • UpdatePatientDto
        • CreateVisitDto
        • CreateLabTestDTO

    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 localization.
    Example of using LOINC ID for CBC - https://loinc.org/58410-2
    šŸ“¤ Create Biomarker Group
    Endpoint: POST /biomarker-group
    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 /biomarker
    Purpose: Adds a new biomarker or updates an existing one.
    Request Example:
    {
      "biomarker_id": "6690-2",
      "title": "Leukocytes",
      "abbr": "WBC",
      "unit": "10^9/L"
    }

    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.
    AI Analysis: Helps the Docus Lab AI generate meaningful diagnostic reports.
    Efficient Data Retrieval: Enables quick grouping and filtering of lab test results.

    Modified atĀ 2025-10-02 19:59:13
    Previous
    Getting Started
    Next
    Flow Between Lab and API
    Built with