> ## 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.

# Ambient Content Retrieval APIs

> Poll session status and retrieve transcripts, recordings, note content, and structured clinical data

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

<Columns cols={3}>
  <Card title="Ambient Session Status" href="/api-reference/ambient-content/status" arrow={true} icon="code">
    Poll processing status for an ambient session
  </Card>

  <Card title="Ambient Session Transcript" href="/api-reference/ambient-content/transcript" arrow={true} icon="code">
    Retrieve the transcript for an ambient session
  </Card>

  <Card title="Ambient Session Recording" href="/api-reference/ambient-content/recording" arrow={true} icon="code">
    Retrieve recording access for an ambient session
  </Card>

  <Card title="Ambient Session Content" href="/api-reference/ambient-content/content" arrow={true} icon="code">
    Retrieve generated note content for an ambient session
  </Card>

  <Card title="Ambient Encounter Content" href="/api-reference/ambient-content/encounter-content" arrow={true} icon="code">
    Retrieve content when multiple sessions share an encounter
  </Card>

  <Card title="Ambient Session Structured Data" href="/api-reference/ambient-content/structured-data" arrow={true} icon="code">
    Retrieve structured clinical data for an ambient session
  </Card>

  <Card title="Ambient Encounter Structured Data" href="/api-reference/ambient-content/encounter-structured-data" arrow={true} icon="code">
    Retrieve structured data scoped to an encounter
  </Card>

  <Card title="List Encounter Notes" href="/api-reference/ambient-content/list-encounter-notes" arrow={true} icon="code">
    List notes associated with an EMR encounter
  </Card>

  <Card title="Note Content" href="/api-reference/ambient-content/note-content" arrow={true} icon="code">
    Retrieve note content by note ID for interoperable notes
  </Card>

  <Card title="Note Context" href="/api-reference/ambient-content/note-context" arrow={true} icon="code">
    Retrieve note context for an interoperable note
  </Card>

  <Card title="Note Structured Data" href="/api-reference/ambient-content/note-structured-data" arrow={true} icon="code">
    Retrieve structured data for an interoperable note
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Interoperable Notes" href="/documentation/how-to/ambient-clinical-notes/use-ambient-across-modalities" icon="book" cta="Learn more">
    Learn how to retrieve note content when capture continues across products
  </Card>

  <Card title="Ambient Interoperability" href="/documentation/concepts/ambient-clinical-notes/ambient-interoperability" icon="book" cta="Learn more">
    Learn how shared encounter IDs keep one Ambient note across modalities
  </Card>

  <Card title="Download Ambient Recordings" href="/documentation/how-to/audio-streaming/audio-streaming-download" icon="book" cta="Learn more">
    Learn how to download Ambient recordings for streaming or downloading
  </Card>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="Write finished notes into the EHR">
    Retrieve generated note content and structured data after processing completes, then map sections into your documentation model.
  </Card>

  <Card title="Support audit and quality review">
    Access transcripts or recordings when clinicians, support, or compliance need the source conversation behind a note.
  </Card>

  <Card title="Resume interoperable notes across products">
    Load the latest shared composition after capture continues across Mobile, Web, or APIs for the same EMR encounter.
  </Card>

  <Card title="Power coding and orders workflows">
    Retrieve structured clinical data when your charting model needs coded sections, problem context, or medication order fields.
  </Card>
</Columns>