Skip to main content
{
  "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"
          }
        },
        "2": {
          "url": "https://doi.org/10.1016/j.kint.2024.01.006",
          "title": "KDIGO 2024 Clinical Practice Guideline for CKD Evaluation and Management",
          "metadata": {
            "type": "guideline",
            "source": "KDIGO",
            "author": "Kidney Disease: Improving Global Outcomes",
            "doi": "10.1016/j.kint.2024.01.006",
            "abstract_snippet": "This guideline update covers the evaluation, management, and treatment of chronic kidney disease...",
            "specialties": [
              "Nephrology"
            ]
          }
        },
        "3": {
          "url": "https://pubmed.ncbi.nlm.nih.gov/34567890/",
          "title": "Creatinine Clearance as a Marker of GFR in CKD",
          "metadata": {
            "type": "insight",
            "source": "pubmed.ncbi.nlm.nih.gov",
            "author": "Published in Kidney International",
            "pubdate": "2023"
          }
        }
      },
      "clinician": {
        "1": {
          "url": "https://pubmed.ncbi.nlm.nih.gov/87654321/",
          "title": "CKD Progression Risk Factors",
          "metadata": {
            "type": "pubmed"
          }
        },
        "2": {
          "url": "https://doi.org/10.1016/j.kint.2024.01.006",
          "title": "KDIGO 2024 Clinical Practice Guideline for CKD Evaluation and Management",
          "metadata": {
            "type": "guideline",
            "source": "KDIGO",
            "author": "Kidney Disease: Improving Global Outcomes",
            "doi": "10.1016/j.kint.2024.01.006",
            "specialties": [
              "Nephrology"
            ]
          }
        }
      }
    },
    "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.