---
title: "Get ambient session status"
method: GET
path: "/api/v1/ambient/session/{ambient_session_id}/status"
tags: ["/api/v1/ambient/session"]
---

# Get ambient session status

`GET /api/v1/ambient/session/{ambient_session_id}/status`

Returns processing status for an ambient session, such as whether note generation is in progress, complete, or skipped.

## Path parameters

- `ambient_session_id` string, required

## Headers

- `sdp_provider_id` string

## Response `200`

Request succeeded.

- ControllersStatusResponse — Current processing status for an ambient session.
  - `status` 'created' | 'ready' | 'running' | 'paused' | 'aborted' | 'failed' | 'completed' — Processing state of the ambient session. Poll until the status is `completed`, `failed`, or `aborted`.

## Other responses

- `400` — Bad request. The request body or parameters failed validation.
- `401` — Unauthorized. The Suki access token is missing, expired, or invalid.
- `404` — Not found. The session, encounter, or resource ID does not exist.
- `500` — Internal server error.

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) · [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suki/suki-developer-platform/revisions/5f420a18fb68/schema)