GET /api/v1/auth/public-key HTTP/1.1
Host: api.health.shoma-ai.com

{
  "status": 200,
  "message": "Public key retrieved successfully.",
  "errorCode": "SUC000",
  "data": {
    "publicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----"
  }
}

POST /api/v1/analysis HTTP/1.1
Host: api.health.shoma-ai.com
X-API-Key: YOUR_API_KEY
Content-Type: multipart/form-data
encryptedAesKey:     <base64 RSA-OAEP-wrapped AES key>
files:               document.enc          # binary, repeat for up to 3
message:             Patient presents with acute chest pain...
isStreamingResponse: true                  # optional

// Set isStreamingResponse=true to receive Server-Sent Events.
// Read the fetch body directly — the browser EventSource is GET-only.
const res = await fetch("https://api.health.shoma-ai.com/api/v1/analysis", {
  method: "POST", headers, body: form
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  for (const block of buffer.split("\n\n")) {
    const line = block.split("\n").find(l => l.startsWith("data:"));
    if (!line) continue;
    const event = JSON.parse(line.slice(5).trim());
    switch (event.type) {
      case "pipeline_start":    console.log("started"); break;
      case "step":              console.log("step:", event.data.step); break;
      case "analysis_complete": console.log(event.data); break;
      case "error":             throw new Error(`${event.errorCode}: ${event.message}`);
    }
  }
}

data: {"type":"pipeline_start","data":{"files":2}}
data: {"type":"step","data":{"step":"decryption","status":"completed"}}
data: {"type":"step","data":{"step":"extraction","status":"completed"}}
data: {"type":"step","data":{"step":"redaction","status":"completed"}}
data: {"type":"step","data":{"step":"llm_analysis","status":"completed"}}
data: {"type":"analysis_complete","data":{ /* full report — see Success responses */ }}

data: {"type":"step","data":{"step":"decryption","status":"completed"}}
data: {
  "type": "error",
  "status": 400,
  "message": "LLM returned an invalid JSON response schema. Please try again.",
  "errorCode": "ERR400",
  "data": null
}

{
  "status": 200,
  "message": "AI administrative processing complete. Temporary report ready for professional review. Data will be permanently deleted immediately.",
  "errorCode": "SUC000",
  "data": {
    "medicalInsights": "The patient exhibits chronic stable blood pressure with mild fluctuations. The general indicators suggest high adherence to the primary therapeutic routine with no critical safety alerts flagged.",
    "extractedEntities": {
      "symptoms": ["Mild headache", "occasional dizziness"],
      "medicalHistory": ["Essential hypertension diagnosed in 2021", "Hyperlipidemia"],
      "statedConditions": ["Chronic stable hypertension"],
      "medications": [
        {
          "name": "Lisinopril",
          "dose": "10mg",
          "frequency": "Once daily in the morning"
        },
        {
          "name": "Atorvastatin",
          "dose": "20mg",
          "frequency": "Once daily at night"
        }
      ],
      "labValues": [
        {
          "parameter": "Blood Pressure",
          "value": "135/85",
          "unit": "mmHg",
          "referenceRange": "120/80"
        },
        {
          "parameter": "Total Cholesterol",
          "value": "195",
          "unit": "mg/dL",
          "referenceRange": "< 200"
        }
      ]
    },
    "completenessScore": 92,
    "conflictFlags": ["No significant clinical conflicts identified between documentation records."],
    "suggestions": [
      "Maintain active low-sodium dietary regimen.",
      "Monitor blood pressure twice daily (morning and evening).",
      "Follow up in 4 weeks for laboratory reassessment."
    ],
    "visitTrends": [
      {
        "date": "2026-08-01",
        "parameter": "Systolic BP",
        "value": "138"
      },
      {
        "date": "2026-08-10",
        "parameter": "Systolic BP",
        "value": "135"
      }
    ],
    "highlights": [
      "Target blood pressure goals are being approached.",
      "Lipid levels are controlled within references."
    ],
    "disclaimer": "IMPORTANT NOTICE — This is an AI-generated administrative output only. It does not constitute medical advice, a diagnosis or clinical decision support. You must review and validate all content before any clinical use. No patient data is stored by SHOMA AI after this report is generated.",
    "analysisScore": 90.0,
    "scoreComputationStatus": "success",
    "creditsUsed": 1,
    "inputTokens": 1420,
    "outputTokens": 320,
    "effortScoring": {
      "rawReadingTimeMinutes": 15.0,
      "assistedReviewTimeMinutes": 3.0,
      "effortReductionPercentage": 80,
      "basis": "Quantified duration comparison between typical manual reading/extraction of multiple documents and reviewing structural AI outputs."
    },
    "responseLanguage": "English"
  }
}