Skip to main content
The Ambient Content Retrieval APIs enable partners to check processing status and retrieve transcripts, recordings, generated note text, and structured clinical data after an ambient session runs. Endpoints are scoped by ambient session ID, encounter ID, or note ID and EMR encounter ID for interoperable notes across modalities. These APIs are called from your servers and authenticated with a Suki Token (sdp_suki_token). Critically, retrieve content only after the session is ready for your workflow. Do not treat skipped sessions as successful note generation.

Available endpoints

GET Ambient Session Status

Purpose: Poll processing status for an ambient session

GET Ambient Session Transcript

Purpose: Retrieve the transcript for an ambient session

GET Ambient Session Recording

Purpose: Retrieve recording access for an ambient session

GET Ambient Session Content

Purpose: Retrieve generated note content for an ambient session

GET Ambient Encounter Content

Purpose: Retrieve content when multiple sessions share an encounter

GET Ambient Session Structured Data

Purpose: Retrieve structured clinical data for an ambient session

GET Ambient Encounter Structured Data

Purpose: Retrieve structured data scoped to an encounter

GET List Encounter Notes

Purpose: List notes associated with an EMR encounter

GET Note Content

Purpose: Retrieve note content by note ID for interoperable notes

GET Note Context

Purpose: Retrieve note context for an interoperable note

GET Note Structured Data

Purpose: Retrieve structured data for an interoperable note

Retrieve Ambient Content

Build the note review UI after Ambient ends

Handle Ambient Session Status

Drive the recorder and note panel from status

Interoperable Notes

Retrieve note content when capture continues across products

Ambient Interoperability

Shared encounter IDs keep one Ambient note across modalities

Medication Orders

Convert medication instructions into structured Medication order data

Ambient Session Recordings

Download Ambient recordings for streaming or offline use

Common use cases

Write finished notes into the EHR

Retrieve generated note content and structured data after processing completes, then map sections into your documentation model.

Support audit and quality review

Access transcripts or recordings when clinicians, support, or compliance need the source conversation behind a note.

Resume interoperable notes across products

Load the latest shared composition after capture continues across Mobile, Web, or APIs for the same EMR encounter.

Power coding and orders workflows

Retrieve structured clinical data when your charting model needs coded sections, problem context, or medication order fields.
Last modified on September 2, 2026