1. Interpretation Required
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
  1. Interpretation Required

Interpretation Report Delivery

POST
{{partner_endpoint_url}}
Once the interpretation is completed, Docus sends the interpretation report to the partner-provided endpoint.
Depending on the configuration, the response may include the PDF report, the structured raw interpretation data, or both.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{{partner_endpoint_url}}' \
--header 'x-api-key: <provided_by_partner>' \
--header 'Content-Type: application/json' \
--data '{
    "partner_lab_id": "lab123",
    "patient_id": "pt_123456",
    "accession_number": "2508220082",
    "physician_id": "1234567890",
    "facility_id": "F-123",
    "file_base64": "JVBERi0xLjQKJc...",
    "file_name": "interpretation-report.pdf",
    "interpretation_report": {
        "singleChoiceDrug": {
            "recommendation_state": "no_problem_detected | needs_clinical_context | single_drug_identified",
            "drug_statement": "string",
            "why_this_drug": "string",
            "caution": "string",
            "renal_adjustment_required": true,
            "hepatic_adjustment_required": false,
            "adverse_reaction_score": 1,
            "case_complexity_score": 1
        },
        "interpretation": "string",
        "ddxList": [
            {
                "condition": "string",
                "consideration": "string",
                "explanation": "string"
            }
        ],
        "followupList": [
            {
                "action": "string",
                "timing": "string",
                "purpose": "string",
                "explanation": "string"
            }
        ],
        "clinicalPlan": "string"
    }
}'
Response Response Example
{}
Previous
Submit Lab Results
Next
Submit Lab Results
Built with