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 user request to Docus Lab API:
Create a user

📤 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

📤 Lab manages access for the according users:

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

Notifying the physician or lab technician.

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 user

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

Benefits of Docus Lab API

Automated AI report generation – Reduces manual workload for physicians.

Asynchronous processing – API remains responsive while AI generates reports.

Secure and scalable – Handles large lab data sets efficiently.

Seamless integration – Works with external EHR, LIMS, and medical platforms.

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

Benefits of Docus Lab API

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#

Benefits of Docus Lab API#

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

Benefits of Docus Lab API

General flow