Docus Reference Lab API
    Docus Reference Lab API
    • Getting Started
    • Interpretation Required
      • Submit Lab Results
        POST
      • Interpretation Report Delivery
        POST
    • No Interpretation Required
      • Submit Lab Results
        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 partner_lab_id was included in the submission, it will be returned unchanged to ensure proper routing.

    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.

    Support#

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