> ## 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 Session Status Before Fetching Content
> Poll ambient session status until completed before calling content APIs
**Problem:** Content or note APIs return empty or incomplete results right after end session.
**Solution:** Poll [Get ambient session status](/api-reference/ambient-content/status) until `completed`, then retrieve. Treat `skipped`, `failed`, and `aborted` as terminal.
This cookbook assumes you already have your Partner ID, authentication tokens, and the other prerequisites for Ambient APIs.
```typescript theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
async function waitUntilCompleted(ambientSessionId: string) {
for (let i = 0; i < 60; i++) {
const res = await fetch(
`https://sdp.suki.ai/api/v1/ambient/session/${ambientSessionId}/status`,
{
headers: {
sdp_suki_token: sdpSukiToken,
sdp_provider_id: sdpProviderId,
},
}
);
if (!res.ok) {
throw new Error(`Get ambient session status failed: ${res.status}`);
}
const { status } = await res.json();
if (status === "completed") return "completed";
if (status === "skipped" || status === "failed" || status === "aborted") {
return status;
}
await new Promise((r) => setTimeout(r, 2000));
}
throw new Error("Timed out waiting for session status");
}
const outcome = await waitUntilCompleted(ambientSessionId);
if (outcome === "completed") {
// Call session content or note content APIs
}
```
```python theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
import time
import requests
def wait_until_completed(ambient_session_id: str) -> str:
for _ in range(60):
res = requests.get(
f"https://sdp.suki.ai/api/v1/ambient/session/{ambient_session_id}/status",
headers={
"sdp_suki_token": sdp_suki_token,
"sdp_provider_id": sdp_provider_id,
},
)
res.raise_for_status()
status = res.json().get("status")
if status == "completed":
return "completed"
if status in ("skipped", "failed", "aborted"):
return status
time.sleep(2)
raise TimeoutError("Timed out waiting for session status")
outcome = wait_until_completed(ambient_session_id)
if outcome == "completed":
# Call session content or note content APIs
pass
```
## Common mistakes
* Sessions under \~**1 minute** often return `skipped`.
* WebSocket close alone does not mean the note is ready.
## Other cookbooks