Note: The Docus Lab API is in active development. Features and endpoints may be updated. Please refer to the latest API version in the official documentation for the most accurate information.
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:
1.
The API stores visit and test data in the database.
2.
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.
3.
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.