The Docus Lab API is designed to streamline the interaction between medical laboratories and external systems by handling patient data, lab test results, AI-generated reports, and file attachments efficiently. Below is the structured flow describing how a lab interacts with the API.

1. Lab Conducts a Test and Sends Data to Docus Lab API

When a lab processes a patient's test, it collects and organizes biomarker data along with visit details (e.g., patient info, test date, and physician details).

📤 Lab sends a new patient request to Docus Lab API:
Create a patient

📤 Lab sends a new visit request to Docus Lab API:
Create visit

📤 Lab recives frontend access for the user and (optional) physician from Docus Lab API:
Create visit

📤 Lab sends test results:
Create a lab test

📤 Lab triggers AI report generation:
Generate AI report

2. Docus Lab API Stores Data and Triggers AI Report Generation

After receiving the test results:

The API stores visit and test data in the database.

A background job is triggered to generate an AI-enhanced lab report.

This process may take a few minutes depending on system load and complexity.

The API provides user access for the frontend dashboard.

3. Docus Frontend Solution Retrieves AI Report and Uses It

Once the AI report is ready, the system retrieves it for:

Displaying in a dashboard

Integrating into a patient's medical record

4. Docus Frontend Solution Retrieves Original Test Report (If Needed)

If the lab initially uploaded a PDF or other file, it can be retrieved and shown in frontend.

Summary of Workflow

Lab registers the patient

Lab registers the visit

Lab submits test results

(Optional) Lab uploads test report file

Docus Lab API triggers AI report generation in the background

Docus Lab API provides access information for the according users

Once ready, the AI report is retrieved and shown in frontend

Flow Between Lab and API

1. Lab Conducts a Test and Sends Data to Docus Lab API

2. Docus Lab API Stores Data and Triggers AI Report Generation

3. Docus Frontend Solution Retrieves AI Report and Uses It

4. Docus Frontend Solution Retrieves Original Test Report (If Needed)

Summary of Workflow

General flow

Flow Between Lab and API

1. Lab Conducts a Test and Sends Data to Docus Lab API#

2. Docus Lab API Stores Data and Triggers AI Report Generation#

3. Docus Frontend Solution Retrieves AI Report and Uses It#

4. Docus Frontend Solution Retrieves Original Test Report (If Needed)#

Summary of Workflow#

General flow#

1. Lab Conducts a Test and Sends Data to Docus Lab API

2. Docus Lab API Stores Data and Triggers AI Report Generation

3. Docus Frontend Solution Retrieves AI Report and Uses It

4. Docus Frontend Solution Retrieves Original Test Report (If Needed)

Summary of Workflow

General flow