Skip to main content

Suki Ambient APIs

The Suki Ambient APIs generate clinical notes from real-time conversations between providers and patients. Most operations use standard endpoints and return HTTP status codes. For streaming audio, the APIs use WebSocket endpoints for real-time transmission and event notifications.

curl -X POST https://sdp.suki.ai/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "your-partner-id",
    "partner_token": "your-jwt-token",
    "provider_id": "provider-123"
  }'

What you can do with the Suki Ambient APIs

With the Suki Ambient APIs, you can create an ambient session, stream audio for the visit, and when processing finishes retrieve the Clinical note or Transcript. Start with the Create session API and explore the other endpoints to build your own ambient session workflow.

For more advanced features related to note quality and structure, refer to Multilingual support, Personalization, and Problem-Based Charting (PBC) guides. Learn how to use those advanced features while integrating the Suki Ambient APIs into your application.

The Ambient APIs are currently in Early Access. To request access, contact our partnership team.
Choose Ambient APIs if you want to build your own ambient session workflow with full control over the user experience.

API versioning

All endpoints use the /api/v1/ prefix. v1 is the stable version; non-breaking changes may ship without a major version bump. Some features are in Early Access and may change. For policies and migration, refer to the API reference guidelines.

New APIs

Recently added endpoints you can adopt alongside the core Ambient workflow.

Get Session Recording

New

Use this API to stream or download the original audio from an ambient session.

View Endpoint →

Create Dictation Session

New

Use this API to initialize a dictation session for real-time audio transcription.

View Endpoint →

Stream Audio To Dictation Session

New

Use this API to send audio to the dictation service over a WebSocket connection.

View Endpoint →

End Dictation Session

New

Use this API to complete a dictation session and trigger transcript generation.

View Endpoint →