Skip to main content
WEBHOOK
labResultsComplete
{
  "runId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "agent": "lab-results",
  "timestamp": "2025-01-19T12:05:00.000Z",
  "sequenceNumber": 8,
  "result": {
    "labResults": [
      {
        "name": "Creatinine",
        "value": "1.8",
        "unit": "mg/dL",
        "flag": "High",
        "referenceRange": "0.7-1.3 mg/dL",
        "date": "2025-01-15",
        "category": "Renal"
      },
      {
        "name": "eGFR",
        "value": "38",
        "unit": "mL/min/1.73m2",
        "flag": "Low",
        "referenceRange": ">60 mL/min/1.73m2",
        "date": "2025-01-15",
        "category": "Renal"
      }
    ],
    "patientResponse": "Your kidney function tests show that your kidneys are working at a reduced capacity...",
    "clinicianResponse": "The patient demonstrates Stage 3b CKD with eGFR 38 mL/min/1.73m2 and creatinine 1.8 mg/dL...",
    "citations": {
      "patient": {
        "1": {
          "url": "https://pubmed.ncbi.nlm.nih.gov/12345678/",
          "title": "KDIGO Guidelines for CKD Management",
          "metadata": {
            "type": "pubmed"
          }
        }
      },
      "clinician": {
        "1": {
          "url": "https://pubmed.ncbi.nlm.nih.gov/87654321/",
          "title": "CKD Progression Risk Factors",
          "metadata": {
            "type": "pubmed"
          }
        }
      }
    },
    "metadata": {
      "labsReceived": 15,
      "labsAnalyzed": 15,
      "insightsMatched": 8
    }
  }
}

Authorizations

x-api-key
string
header
required

API key provided by Helios Intelligence

Body

application/json

Webhook payload for successful Lab Results Agent completion

runId
string<uuid>
required

Unique identifier for this analysis run

status
enum<string>
required

Indicates successful completion

Available options:
completed
timestamp
string<date-time>
required

ISO 8601 timestamp when the webhook was sent

sequenceNumber
integer
required

Monotonically increasing number for ordering webhooks

Example:

8

result
object
required
agent
enum<string>

The agent type that processed this request

Available options:
lab-results

Response

200

Webhook received successfully. Return 200 OK to acknowledge receipt.