Poll Patient Summary Status Before Retrieve

Problem: Retrieve APIs return empty or missing summaries right after you trigger generation. Solution: Poll Get patient summary generation status for encounter until COMPLETED, then retrieve. Treat FAILED and ABORTED as terminal. You can also poll by patient_summary_id with Get patient summary job status.

This cookbook assumes you already triggered generation for the encounter, have Partner ID and sdp_suki_token, and use the same fhir_encounter_id and fhir_practitioner_id as generation.

TypeScript
Python

const BASE_URL = "https://sdp.suki.ai";

async function waitUntilCompleted(
  fhirEncounterId: string,
  fhirPractitionerId: string
) {
  for (let i = 0; i < 60; i++) {
    const res = await fetch(
      `${BASE_URL}/api/v1/patient-summary/encounter/${fhirEncounterId}/practitioner/${fhirPractitionerId}/status`,
      {
        headers: {
          sdp_suki_token: sdpSukiToken,
          sdp_provider_id: sdpProviderId,
        },
      }
    );

    if (!res.ok) {
      throw new Error(`Get patient summary status failed: ${res.status}`);
    }

    const { status } = await res.json();
    if (status === "COMPLETED") return "COMPLETED";
    if (status === "FAILED" || status === "ABORTED") return status;

    await new Promise((r) => setTimeout(r, 2000));
  }

  throw new Error("Timed out waiting for patient summary status");
}

const outcome = await waitUntilCompleted("enc-123", "pract-456");
if (outcome === "COMPLETED") {
  // Call retrieve Patient Summary APIs
}

import time
import requests

BASE_URL = "https://sdp.suki.ai"

def wait_until_completed(fhir_encounter_id: str, fhir_practitioner_id: str) -> str:
    for _ in range(60):
        res = requests.get(
            f"{BASE_URL}/api/v1/patient-summary/encounter/{fhir_encounter_id}/practitioner/{fhir_practitioner_id}/status",
            headers={
                "sdp_suki_token": sdp_suki_token,
                "sdp_provider_id": sdp_provider_id,
            },
            timeout=30,
        )
        res.raise_for_status()
        status = res.json().get("status")
        if status == "COMPLETED":
            return "COMPLETED"
        if status in ("FAILED", "ABORTED"):
            return status
        time.sleep(2)
    raise TimeoutError("Timed out waiting for patient summary status")

outcome = wait_until_completed("enc-123", "pract-456")
if outcome == "COMPLETED":
    # Call retrieve Patient Summary APIs
    pass

Common mistakes

Calling retrieve while status is still READY or RUNNING.
Stopping only on COMPLETED and ignoring FAILED / ABORTED (those loops never end cleanly).
Polling with different encounter or practitioner IDs than you used to generate.

Other cookbooks

Patient SummaryAPI

Generate a Patient Summary for One Encounter

Trigger generation and save the ID.

5 min

Patient SummaryAPI

Upload FHIR to CKG and Poll Ingestion

Upload FHIR, then wait for COMPLETED.

5 min

​Common mistakes

​Other cookbooks

​Generate a Patient Summary for One Encounter

​Upload FHIR to CKG and Poll Ingestion

Common mistakes

Other cookbooks

Generate a Patient Summary for One Encounter

Upload FHIR to CKG and Poll Ingestion