Docus Reference Lab API
    • Getting Started
    • Interpretation Required
      • Submit Lab Results
        POST
      • Interpretation Report Delivery
        POST
    • No Interpretation Required
      • Submit Lab Results
        POST
    • LIS Marketplace: New Lab Onboarding
      • Submit Lab Onboarding Request
        POST

    Getting Started

    The Docus Reference Lab API allows partners to:
    Submit lab results
    Optionally request clinical interpretation
    View results in the Docus interface
    Optionally receive interpretation reports via API delivery
    The integration is asynchronous and designed to support both single-lab and multi-lab (LIS) partners.

    Overview of the Flow#

    1.
    Submit lab results
    2.
    Generate interpretation report (optional)
    3.
    Deliver interpretation report via API (optional)
    4.
    Access results in the Docus interface

    Step 1 — Submit Lab Results#

    Partners submit lab results using one of two endpoints:
    /lab-results → Store results and trigger interpretation View Request
    /lab-results/not-interpret → Store results without interpretation View Request
    Both endpoints accept the same request structure.
    Use:
    /lab-results when interpretation and report generation are required.
    /lab-results/not-interpret when results should only be stored and displayed in the Docus interface.
    Important!
    At least one of data or file_base64 must be provided.
    For the non-interpretation endpoint, file_base64 is required.

    Step 2 — Interpretation (If Requested)#

    If results are submitted to /lab-results, Docus:
    Processes the medical data or PDF
    Generates a clinical interpretation report (PDF)
    No polling is required.

    Step 3 — Report Delivery (Optional)#

    If the partner has provided a delivery endpoint during onboarding, Docus will send the interpretation report once it is ready. View Request
    The delivery request includes:
    Patient identifiers
    Accession/reference identifiers (if provided)
    The Base64-encoded interpretation report PDF, if PDF delivery is enabled
    The structured raw interpretation report JSON, if structured data delivery is enabled
    If both delivery options are enabled, the request will include both the PDF report and the structured JSON interpretation report.
    partner_lab_id, patient_id, accession_number, physician_id and facility_id are returned unchanged when provided in the original submission to ensure proper routing and record matching.

    Using the Docus Interface#

    Partners may choose to use the Docus interface for doctors to:
    View original lab results
    Access interpretation reports (when generated)
    Manage patient test history
    Interpretation delivery via API and Docus interface usage are independent and may be used together.

    Authentication#

    Requests to Docus#

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

    Requests from Docus to Partner#

    If report delivery is enabled, Docus will authenticate using the method agreed during integration.

    Multi-Lab (LIS) Integrations#

    If integrating on behalf of multiple labs, include partner_lab_id in submission requests.
    This value will be echoed back in delivery requests for routing purposes.
    For strategic LIS or marketplace partners onboarding multiple labs, Docus also supports lab onboarding via API. Partners can submit basic lab details, contact information, branding assets, and supported interpretation test types using the Submit Lab Onboarding Request endpoint. This helps Docus create or configure new lab accounts before they begin submitting lab results.

    Support#

    For onboarding assistance or technical questions, contact:
    support@docus.ai
    Next
    Submit Lab Results
    Built with