> ## Documentation Index
> Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Poll Patient Summary Status Before Retrieve
> Poll Patient Summary job status until COMPLETED before calling retrieve APIs
**Problem:** Retrieve APIs return empty or missing summaries right after you trigger generation.
**Solution:** Poll [Get patient summary generation status for encounter](/patient-summary-api-reference/summary-jobs/encounter-status) until `COMPLETED`, then retrieve. Treat `FAILED` and `ABORTED` as terminal. You can also poll by `patient_summary_id` with [Get patient summary job status](/patient-summary-api-reference/summary-jobs/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 theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
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
}
```
```python theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
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