Suki APIs

Suki provides partner APIs that let you integrate Suki’s ambient clinical intelligence into your applications.

Introduction

The Suki APIs are designed to help partners integrate Suki into existing products and workflows. The APIs use the OpenAPI Specification (OAS) v3.0 and support integration across ambient clinical documentation, form filling, dictation, and webhook workflows.

You capture clinical conversations, structured outputs, live audio, and webhooks while you keep control of your UI and integrations.

How it works

All APIs use versioned HTTPS endpoints with JSON request and response bodies. Follow the following steps to get started:

Call REST: Implement the versioned HTTPS endpoints with JSON request and response bodies from the API reference documentation.
Add streaming when needed: Use the WebSocket flows with the correct session context for live audio streaming.
Receive async notifications: Configure webhooks when you want completion and status events pushed to your backend for asynchronous event notifications.

Authentication

Our APIs are available only to approved Suki partners. Complete Partner onboarding before using our APIs. Authentication works in two layers:

Partner authentication: Your application sends a JWT from your identity provider (partner token). Suki validates it against your registered keys so traffic is tied to your organization.
Provider authentication: Register each clinician once, then sign them in for a Suki access token on REST, WebSocket, and related calls for that user.

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-stage.com/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-stage.com/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-stage.com/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-stage.com/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-stage.com/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-stage.com/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

Stage host URL

https://sdp.suki-stage.com

Current API version

https://sdp.suki-stage.com/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.

Decide Your Workflow

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.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, and Dictation 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.

Documentation Index

Suki APIs

Introduction

How it works

Authentication

Download OpenAPI description

Overview

Languages

Servers

Available APIs

Ambient APIs

Form Filling APIs

Dictation APIs

Start building

Stay updated

Ambient & Dictation APIs Changelog

Form Filling APIs Changelog