API Webhooks

Configure webhooks to listen for clinical document processing notifications.

Event-Driven Notifications

Configure secure endpoints to receive HTTP notifications automatically whenever document events happen in your pipeline.

Supported Webhook Events

document.processed	Fires as soon as OCR extraction, terminology mapping, and FHIR compilation succeed.
document.failed	Fires if processing encounters validation issues, schema errors, or unreadable layouts.

Payload Schema Details

Example JSON body posted to your registered webhook URL:

webhook-event.json

# Webhook HTTP POST request sent to your server
{
  "eventId": "evt_092a18f4bc1",
  "eventType": "document.processed",
  "createdAt": "2026-07-27T00:50:12Z",
  "data": {
    "documentId": "doc_8f17a942b083",
    "status": "completed",
    "accuracy": 0.985,
    "fhirBundleId": "bundle_991f2a"
  }
}