Quick summary
Get secure, temporary access to the original audio from . Use it to play back recordings in your app, verify notes against the conversation, or save files for compliance.
Download session audio is supported by: Ambient APIs
Common integration patterns and use cases
Design session audio access around whether your application needs in-app playback, note verification, or longer-term storage. Request a temporary recording URL from the ambient recording API, then stream or download the WAV file before the URL expires. The following patterns show common ways to use session audio download:In-App Visit Playback
Call the recording API with
download=false, then stream the WAV URL in your player so clinicians can seek and scrub.Verify Notes Against Audio
Load the session recording next to the note or transcript UI so clinicians can jump to the relevant part of the visit.
Archive Audio for Compliance
Request the recording with
download=true within the 7-day availability window and store the WAV in your own system.Playback for Uploaded Sessions
After an uploaded session completes, use the same recording API. If you receive a temporary 404, wait for processing and retry.
Multi-Chunk Recordings
Read the
recordings array and use sequence_number to play or assemble chunks in order.Refresh Expired Playback URLs
Watch
expires_at. When the URL expires mid-playback, call the recording endpoint again for a fresh URL.Recording access benefits
Stream for Playback
Stream audio in your app. Supports seeking and scrubbing so users can jump to any part of the recording.
Download for Storage
Download the full audio file when you need to keep it for archival or compliance.
Works for All Sessions
Available for both real-time streamed sessions and sessions where audio was uploaded after the visit.
Time-Limited Access
Streaming URLs last 15 minutes for short sessions, or session length plus 10 minutes for long sessions. Download URLs last 1 hour.
7-Day Availability
Recordings are available for 7 days after the session. After that, they are no longer accessible.
Access Logging
Each access is logged for compliance and security.
WAV Format
Recordings are returned in WAV format, ready for playback in standard media players.
How recording retrieval works
- Finish an ambient session: Create a session, stream or upload audio, and end it. The recording is ready once the session is complete.
- Request a recording URL: Call the recording API with your
session ID. Choose streaming (for playback) or download (for saving the file). Some sessions may return multiple recordings; use the one you need. - Use the URL: Stream or download the audio in WAV format. If the response indicates streaming is not supported, use download mode instead. If the URL expires while someone is listening, request a new one.
Workflow
How to use the Download API
1
Complete an Ambient Session
Create an ambient session, stream or upload audio, and end the session. The recording is available after the session is complete.Use the Create ambient session API to create an ambient session.
2
Request the Recording URL
Call the Recording API endpoint with your ambient
session ID. Use the download parameter: false for streaming (playback) or true for full file download.3
Stream or Download
Use the returned URL to stream or download the audio (WAV format).
How long are recordings kept?7 days from the session date. After that, the recording is no longer available.
4
Request a New URL When Needed
If the URL expires during playback, call the recording endpoint again to get a fresh URL.
Response structure for Download API
When the request succeeds, the API returns arecordings array. Each item in the array represents one recording chunk for the session.
array
List of recordings for the session. Each item contains a presigned URL and metadata.
boolean
Whether the returned URLs support streaming with Range requests. If
false, use download=true to get a download URL instead.Best practices
FAQs
What Is the Difference Between Streaming and Download?
What Is the Difference Between Streaming and Download?
Why Does the Streaming URL Last Longer for Long Sessions?
Why Does the Streaming URL Last Longer for Long Sessions?
For sessions longer than 15 minutes, the streaming URL is valid for the full session length plus 10 minutes. This lets you play the entire recording without the URL expiring mid-playback.
What Audio Format Is Returned?
What Audio Format Is Returned?
Recordings are returned in WAV format. Use them in standard media players or HTML5 audio elements for playback.
Can a Session Have Multiple Recordings?
Can a Session Have Multiple Recordings?
Yes. Some sessions may return multiple recordings. The API returns a list; use the recording that matches your needs. If the response indicates streaming is not supported for a recording, use download mode instead.
How Long Are Recordings Available?
How Long Are Recordings Available?
Recordings are available for 7 days from the session date. After that, the recording is no longer accessible. If you need to keep the audio longer, download it within the 7-day window and store it in your own system.
What If I Get 404 When Requesting a Recording?
What If I Get 404 When Requesting a Recording?
For sessions where audio was uploaded (not streamed in real time), the recording may still be processing. Wait a moment and try again. If the session is older than 7 days, you will get 410 instead, which means the recording is permanently unavailable.