Suki APIs

Suki provides partner REST, WebSocket, and webhook APIs so you can embed Ambient Clinical Intelligence (ACI) into healthcare applications.

Introduction

Suki APIs help you build clinical AI into healthcare software for providers, nurses, and other care staff. Ambient documentation, Form filling, Dictation, and Patient summary are the core workflows you can build from your backend. Your application owns the UI and how results move into the EHR.

Use REST for sessions and results, WebSockets for live audio, and webhooks for completion events. Responses use standard HTTP status codes and JSON.

Explore and test the APIs with the OpenAPI bundle. Access requires partner onboarding.

How it works

Each API follows the same integration pattern:

Authenticate and obtain a Suki access token
Create a clinical session with REST
Stream live audio over WebSocket when the workflow needs capture
End the session and retrieve structured output
Optionally receive webhook events for completion and status

Authentication

API access is available only to approved Suki partners. Complete partner onboarding, then configure authentication for both your application and clinicians. Your application authenticates with a JWT (partner_token) issued by your identity provider.

After a clinician signs in, Suki issues a Suki access token that authorizes REST API and WebSocket requests on the clinician’s behalf. If you need staging access, production credentials, or rollout assistance, contact your Suki partnership representative or Suki Support.

Get Started Authentication

Download OpenAPI description

Overview

Base URL

https://sdp.suki.ai/

API support

support@suki.ai

API guidelines

Languages

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

const response = await fetch("https://sdp.suki.ai/api/v1/auth/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    partner_id: "your-partner-id",
    partner_token: "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    provider_id: "provider-123", // Optional
  }),
});

if (response.ok) {
  const data = await response.json();
  const sukiToken = data.suki_token;
  console.log(`Authentication successful. Token: ${sukiToken}`);
} else {
  const error = await response.json();
  console.error(`Authentication failed: ${response.status}`, error);
}

import requests

url = "https://sdp.suki.ai/api/v1/auth/login"

payload = {
    "partner_id": "your-partner-id",
    "partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "provider_id": "provider-123"  # Optional
}

response = requests.post(url, json=payload)

if response.status_code == 200:
    data = response.json()
    suki_token = data["suki_token"]
    print(f"Authentication successful. Token: {suki_token}")
else:
    print(f"Authentication failed: {response.status_code}")
    print(response.json())

require "net/http"
require "json"

uri = URI("https://sdp.suki.ai/api/v1/auth/login")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req["Content-Type"] = "application/json"
req.body = JSON.generate(
  "partner_id" => "your-partner-id",
  "partner_token" => "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "provider_id" => "provider-123"
)

res = http.request(req)
puts res.body

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class LoginExample {
  public static void main(String[] args) throws Exception {
    String body =
        "{"
            + "\"partner_id\":\"your-partner-id\","
            + "\"partner_token\":\"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\","
            + "\"provider_id\":\"provider-123\""
            + "}";
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request =
        HttpRequest.newBuilder()
            .uri(URI.create("https://sdp.suki.ai/api/v1/auth/login"))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

<?php

$ch = curl_init("https://sdp.suki.ai/api/v1/auth/login");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt(
    $ch,
    CURLOPT_POSTFIELDS,
    json_encode([
        "partner_id" => "your-partner-id",
        "partner_token" => "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
        "provider_id" => "provider-123",
    ])
);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

Servers

Production host URL

https://sdp.suki.ai

Current API version

https://sdp.suki.ai/api/v1

Confirm with your Suki partnership team for production URLs, and any host-specific routing before you go live.

Choose your API Workflow

Available APIs

Pick the APIs for your use case and workflow and start building your integration.

Start building

Ambient API IntroductionLearn more about the Ambient API and how to get started.Webhooks IntroductionLearn more about the Webhooks to receive notifications from Suki.Ambient API QuickstartBuild your first ambient session and stream audio in minutes.WebSocket APIsStream visit audio over WebSocket for ambient and Form filling sessions.Form Filling API IntroductionLearn more about the Form filling API and how to get started.Patient Summary API IntroductionUpload FHIR data, trigger summary generation, and retrieve Patient Summaries.Patient Summary API QuickstartComplete the FHIR ingestion → generate → retrieve flow on staging.API GuidelinesLearn more about the API guidelines to help you build your integration.Form Filling API QuickstartBuild your first Form filling session and retrieve structured data in minutes.Partner OnboardingLearn more about the partner onboarding process to start using the Suki APIs.

Stay updated

Learn about the latest updates to the Ambient, Form filling, Dictation, and Patient Summary APIs.

Ambient & Dictation APIs Changelog

New endpoints, deprecations, and behavior notes for Ambient and Dictation APIs.

Form Filling APIs Changelog

New endpoints, deprecations, and behavior notes for Form filling APIs.

Patient Summary APIs Changelog

Patient Summary API reference and documentation: ingestion, generation jobs, and retrieval.