Quick summary
A Medical Specialty is the type of care a provider (doctor) practices, like Cardiology, Pediatrics, or Emergency Medicine. When you tell Suki what specialty a provider (doctor) has, Suki generates notes that match how that specialty works.
Specialties is supported by: Ambient APIs, Web SDK, Mobile SDK, Headless Web SDK
- Cardiologist: Uses terms like “ejection fraction,” “stent placement,” “cardiac catheterization”.
- Pediatrician: Uses terms like “growth percentile,” “vaccination schedule,” “developmental milestones”.
- Uses the right medical terms for that specialty.
- Recognizes specialty-specific abbreviations correctly.
- Structures notes the way that specialty typically documents.
- Provides relevant suggestions that match that specialty’s workflow.
How medical specialty improves clinical documentation
Medical specialty context helps Suki interpret the conversation using the language and documentation patterns of that clinical domain.
Without specialty context, notes can miss domain-specific meaning or use generic wording. With the right specialty, generated documentation is usually closer to what the clinician would write, so review and edit time go down.
How medical specialty works
When you start an , specify the provider’s specialty. Suki uses this information throughout the session to generate notes that match the specialty’s documentation standards and terminology.Suki supports 120+ medical specialties. We regularly add new specialties as they become available. If you need a specialty that’s not listed, contact support.
How to build specialty into your product UI
Treat specialty as part of the provider or visit context, not as a setting on the ambient session itself. Add specialty selection where it fits naturally into your workflow, such as the provider profile or visit setup. Before the session ends, pass the selected specialty Value, such asCARDIOLOGY, in the session context.
These patterns apply when you build your own ambient experience with the Ambient APIs or Headless modalities. The headed Web SDK already provides the Ambient UI, so you do not need to build these controls yourself.
What to build
- Specialty selection: Let clinicians select a specialty, or use the provider’s saved specialty as the default.
- Supported values only: Validate the selected value against the supported specialties list or the Specialties Info API.
- Context updates: Pass the specialty in the appropriate context before the session ends.
- Optional note defaults: Use the specialty to set appropriate default note sections for the workflow.
Where to add specialty
Do not create your own specialty codes. Use the Value from the Supported specialties list or load supported values from the Specialties Info API.
How to use medical specialty in your application
Use the Medical Specialty Value from the table below, such asCARDIOLOGY, PEDIATRICS, or FAMILY_MEDICINE. Pass the value where your integration sets provider context. The exact place depends on the product you use.
Click the tabs below to see the implementation details for your integration path.
- Ambient APIs
- Web SDK
- Headless Web SDK
- Mobile SDK
Send provider specialty in ambient session context. Use
provider.specialty when you seed or update context for the session.Choose the Specialty Value
Pick the specialty code from the supported specialties table. Use the code value, not the display name. For example, send
CARDIOLOGY, not Cardiology.Create the Ambient Session
Create the ambient session first and store the returned
ambient_session_id.Send Provider Context
Use the Context API or Update Context API to pass the specialty before you end the session.Suki uses this specialty context when it generates the clinical note.
Python
Generate the Note
Stream audio, end the session, and retrieve the generated content as usual. The note uses terminology and structure that match the specialty you provided.
If you don’t specify a specialty, Suki defaults to
FAMILY_MEDICINE. For best results, always specify the provider’s actual specialty.Supported specialties
Suki supports the following Medical Specialties. Use the Value column when specifying a specialty in your code:No specialties match your search. Try a different term.
Getting the list via API
You can fetch the list of supported Medical Specialties by calling the Specialties API anytime. Some common use cases are:- Display specialty options in a dropdown menu.
- Validate specialty codes before sending them to Suki.
- Keep your application in sync with Suki’s latest specialty additions.
Specialties API
Get the list of supported medical specialties via API