Docus CDS API (MC)
    • Getting Started
    • Submit Medical Data
      POST
    • Access URL Delivery
      POST

    Getting Started

    The Docus API for Medical Centers allows partners to:
    Submit patient medical data
    Receive a patient-specific access URL to the Docus interface
    Generate and view AI interpretation reports in the Docus interface

    Overview of the Flow#

    1.
    The Medical Center submits the patient’s historical medical records to Docus.
    2.
    Once the first record is received, Docus creates the patient profile.
    3.
    Docus delivers a patient-specific access URL back to the Medical Center via API.
    4.
    The Medical Center places this URL inside the patient profile in the EMR system.
    5.
    Doctors can open the Docus interface directly from the EMR and view information related only to that patient.

    Step 1 — Submit Medical Data#

    Use the Submit Medical Data request to send patient records to Docus.
    Each submitted document is normalized, summarized, and added to the patient’s Health History.
    For lab results, send data_type as lab_results. Lab results are processed through a dedicated flow. For other medical documents, any descriptive data_type value can be used.
    If the same document may be updated and sent multiple times, include document_id. When the same document_id is submitted again, previously extracted records for that document are replaced with the latest version.
    Use the data key to send raw data and/or the file_base64 key to send PDF, DOC, or DOCX files.
    Important!
    At least one of data or file_base64 must be provided.

    Step 2 — Access URL Delivery#

    After the first successful medical data submission for a new patient, Docus sends a patient-specific access URL to the Medical Center.
    This URL opens the Docus interface for the related patient only. The Medical Center can place it in the EMR system under the patient profile, usually behind a button.
    Access is controlled by the Medical Center’s own EMR permissions.
    Since the URL provides direct access without additional Docus authentication, security is ensured through IP whitelisting.

    Step 3 — Interpretation Logic#

    Docus generates interpretations based on the patient’s full Health History.
    Doctors can manually generate a new interpretation when new records have been added since the last interpretation.
    If no interpretation is generated manually, the first interpretation is automatically generated at 12:00 on the day after patient creation.

    Authentication#

    Requests to Docus#

    All requests must include:
    x-api-key
    x-team-id
    These credentials are provided during onboarding.

    Requests from Docus to the Medical Center#

    Docus sends patient-specific access URLs to the endpoint provided by the Medical Center.

    Support#

    For onboarding assistance or technical questions, contact:
    support@docus.ai
    Modified at 2026-06-01 15:56:03
    Next
    Submit Medical Data
    Built with