Skip to main content
NewThe Mobile SDK is now with other Suki products that support Ambient workflows. Pass SukiAmbientConstant.kEmrEncounterId on createSession so clinicians can continue the same clinical note across Ambient APIs, Mobile SDK, and Web SDK.Refer to Ambient interoperability for Mobile SDK setup.
Suki Mobile SDK is a headless SDK for iOS applications. It provides intelligence capabilities that you can integrate directly into your native iOS app. Use the mobile SDK to capture clinical conversations, generate notes automatically, and streamline documentation workflows.

​
Mobile SDK capabilities

With just a few lines of code, you can use the SDK to:
  • Capture Conversations: Enable hands-free, real-time ambient transcription of clinical conversations.
  • Generate Notes: Automatically transform conversations into structured clinical documentation using Suki’s AI.
  • Problem-Based Charting (PBC): Support problem-oriented notes and structured diagnoses by passing diagnosis context in setSessionContext and reading structured output when the session completes.
  • Manage Sessions: Handle the entire session lifecycle seamlessly within your application.
  • Ensure Security: All data processing is handled with HIPAA-grade privacy and security.
  • Ambient interoperability: Support interoperability with other Suki products that use ambient workflows.
Refer to the Mobile SDK capabilities page for more details on the capabilities of the Mobile SDK.

​
Common integration patterns and use cases

The Mobile SDK provides the APIs to create ambient sessions, capture audio, support offline recording, and retrieve generated notes. Your application owns the iOS user experience, workflow, and how clinicians review or continue documentation across Suki products. The following examples show common ways to integrate the Mobile SDK into your iOS application.

Capture Ambient Notes on iOS

Create an ambient session, record audio using the device microphone, and retrieve the generated clinical note when processing completes.

Record Offline

Enable offline mode to buffer audio locally during temporary network interruptions and automatically sync recordings when connectivity is restored.

Capture Problem Context

Pass diagnosis context with setSessionContext, then retrieve structured diagnosis data using getStructuredData after the session completes.

Capture Medication Orders

After medication orders are enabled for your organization, pass kOrdersInfo in the session context and retrieve structured medication orders when the session completes.

Continue on Another Suki Product

Create the ambient session with SukiAmbientConstant.kEmrEncounterId, then continue the same note in another Suki product, such as the Web SDK, for review, editing, or submission.

Build a Custom iOS Experience

Build your own native iOS interface while using the Mobile SDK for ambient session management, audio capture, and note generation.

​
Guide navigation

To get started with the Mobile SDK, you can follow the guides in the following order:

​
Mobile SDK workflow

The diagram below shows the complete ambient session workflow and how you can use the Mobile SDK to manage the session lifecycle.

​
Next steps

To begin the integration, follow our Installation guide. If you need access to the SDK, contact our Partnership team. Once you have installed the SDK, start with Create session to begin implementing the ambient session workflow, then follow the guides in sequence to build a complete integration.
Last modified on July 24, 2026