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 Ambient Session Section Structured Data

Purpose: Retrieve filled Embedded Form values for an ambient session.

GET Ambient Encounter Section Structured Data

Purpose: Retrieve filled Embedded Form values from the latest completed session for 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 October 16, 2026