Webhook API v1.1

Webhook Integration

Submit medical data and receive real-time processing results. Support for JSON, XML, and text formats.

Note: MedCascade provides billing assist only and does not submit claims to medical schemes. Use the API to validate codes, generate motivations, and prepare documentation for submission via your billing system or scheme portals.

Getting Started
Integrate MedCascade webhooks in minutes

Key Features

Unified Submission

Single endpoint for all submission types - diagnosis, claims, transcriptions, documents

Real-time Results

Receive processing results via outgoing webhooks - no polling required

Auto File Uploads

Submit base64 audio/documents

Flexible Formats

Accept JSON, XML, or plain text - original payloads preserved

API Endpoints

POST/api/v1/webhooks/incoming

Submit diagnosis, claim, transcription, or document data

POST/api/v1/webhooks/incoming/batch

Submit multiple items in one request

Quick Example

cURL
POST
curl -X POST https://api.medcascade.com/api/v1/webhooks/incoming \
  -H "X-API-Key: tenant_690...ebc32_a3f9...7k2m" \
  -H "Content-Type: application/json" \
  -d '{
    "correlationId": "order-12345",
    "submissionType": "diagnosis",
    "data": {
      "patientId": "patient-001",
      "diagnosisCodes": [
        {"code": "E11.9", "isPrimary": true}
      ]
    },
    "signature": "sha256=abc123...",
    "timestamp": "2025-10-31T10:00:00Z"
  }'

Immediate Response

200 OK
{
  "success": true,
  "eventId": "evt_abc123-def456-...",
  "correlationId": "order-12345",
  "submissionType": "diagnosis",
  "eventType": "diagnosis.submit",
  "result": {
    "message": "Submission received and queued for processing"
  },
  "processedAt": "2025-10-31T10:00:02Z"
}

Note: Processing happens asynchronously. Results are delivered to your configured outgoing webhook endpoint.