Generate a Patient Summary for One Encounter

Problem: You need a summary for one upcoming visit, but generation is asynchronous and the summary is not in the create response. Solution: Call Generate Patient Summary for an encounter with fhir_encounter_id and fhir_practitioner_id, then store patient_summary_id. Poll status next, then retrieve.

This cookbook assumes CKG ingestion for the patient, encounter, and practitioner is already COMPLETED, and you have Partner ID, sdp_suki_token, and matching FHIR identifiers.

CURL
TypeScript
Python

curl --request POST \
  --url https://sdp.suki.ai/api/v1/patient-summary/generate/encounter \
  --header 'Content-Type: application/json' \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>' \
  --data '{
    "fhir_encounter_id": "enc-123",
    "fhir_practitioner_id": "pract-456"
  }'

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

const res = await fetch(`${BASE_URL}/api/v1/patient-summary/generate/encounter`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    sdp_suki_token: sdpSukiToken,
    sdp_provider_id: sdpProviderId,
  },
  body: JSON.stringify({
    fhir_encounter_id: "enc-123",
    fhir_practitioner_id: "pract-456",
  }),
});

if (!res.ok) {
  throw new Error(`Generate for encounter failed: ${res.status}`);
}

const { patient_summary_id: patientSummaryId } = await res.json();
// Store patientSummaryId, then poll status before retrieve

import requests

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

res = requests.post(
    f"{BASE_URL}/api/v1/patient-summary/generate/encounter",
    headers={
        "Content-Type": "application/json",
        "sdp_suki_token": sdp_suki_token,
        "sdp_provider_id": sdp_provider_id,
    },
    json={
        "fhir_encounter_id": "enc-123",
        "fhir_practitioner_id": "pract-456",
    },
    timeout=30,
)
res.raise_for_status()
patient_summary_id = res.json()["patient_summary_id"]
# Store patient_summary_id, then poll status before retrieve

Common mistakes

Generating before CKG ingestion is COMPLETED.
Mismatched fhir_encounter_id or fhir_practitioner_id versus ingested FHIR data.
Treating the generate response as the finished summary instead of saving patient_summary_id and polling.
Re-generating when a usable summary for the appointment already exists.

Other cookbooks

Patient SummaryAPI

Upload FHIR to CKG and Poll Ingestion

Upload FHIR, then wait for COMPLETED.

5 min

Patient SummaryAPI

Poll Patient Summary Status Before Retrieve

Poll until status is COMPLETED.

5 min

​Common mistakes

​Other cookbooks

​Upload FHIR to CKG and Poll Ingestion

​Poll Patient Summary Status Before Retrieve

Common mistakes

Other cookbooks

Upload FHIR to CKG and Poll Ingestion

Poll Patient Summary Status Before Retrieve