Start building
with Suki for Partners
Welcome to Suki developer documentation.
Find docs and resources to integrate Suki's APIs and SDKs into your product. Go from zero to production-ready integrations in days, not months.
What are you building?
Pick your workflow
Start with the workflow that matches your use case and choose the integration path that fits your technical approach.
Ambient clinical intelligence
Dictation
- Specialties Browse 100+ supported medical specialties on the Suki platform
- Partner authentication Set up JWT-based partner tokens for APIs and SDKs
- API overview Ambient REST, WebSocket audio, webhooks, and session workflows
- Web SDK quickstart Install Suki.js, authenticate, and mount the SDK UI in minutes
Form Filling APIs allow you to create, update, and retrieve form filling sessions.
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} curl --request GET \ --url https://sdp.suki-stage.com/api/v1/form-filling/session/{form-filling-session_id}/status \ --header 'sdp_suki_token:Ambient APIs allow you to create, update, and retrieve ambient sessions.
View API Reference →Mobile SDK allows you to create, update, and retrieve ambient sessions on iOS devices.
```swift theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} // Add SukiAmbientCore.framework to your Xcode project import SukiAmbientCore.framework ``` View Mobile SDK Docs →Web SDK allows you to create, update, and retrieve ambient sessions with the pre-built UI components.
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} npm install @suki-sdk/react ``` View Web SDK Docs →Headless Web SDK allows you to create, update, and retrieve ambient sessions in the browser without the pre-built UI.
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} npm install @suki-sdk/platform-react ``` View Headless SDK Docs →Dictation APIs allow you to create, stream audio, and receive live transcripts from audio dictation sessions.
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} curl --request POST \ --url https://sdp.suki-stage.com/api/v1/transcription/session/create \ --header 'sdp_suki_token:Dictation SDK allows you to embed dictation in the browser with a hosted iframe or React components.
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}} npm install @suki-sdk/dictation-react ``` View Dictation SDK Docs →
```typescript theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
const sessionId = '{ambient_session_id}';
const res = await fetch(
`https://sdp.suki-stage.com/api/v1/ambient/session/${sessionId}/status`,
{ headers: { sdp_suki_token: '', sdp_provider_id: '' } }
);
console.log(res.status, await res.json());
```
```python theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
import requests
session_id = "{ambient_session_id}"
url = f"https://sdp.suki-stage.com/api/v1/ambient/session/{session_id}/status"
headers = {"sdp_suki_token": "", "sdp_provider_id": ""}
r = requests.get(url, headers=headers)
print(r.status_code, r.json())
```
```go theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://sdp.suki-stage.com/api/v1/ambient/session/{ambient_session_id}/status"
req, _ := http.NewRequest(http.MethodGet, url, nil)
req.Header.Set("sdp_suki_token", "")
req.Header.Set("sdp_provider_id", "")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
b, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(b))
}
```
```ruby theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
require "net/http"
uri = URI("https://sdp.suki-stage.com/api/v1/ambient/session/{ambient_session_id}/status")
req = Net::HTTP::Get.new(uri)
req["sdp_suki_token"] = ""
req["sdp_provider_id"] = ""
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.code
puts res.body
```
```bash theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
curl --request GET \
--url https://sdp.suki-stage.com/api/v1/ambient/session/{ambient_session_id}/status \
--header 'sdp_suki_token: ' \
--header 'sdp_provider_id: '
```
Explore the popular docs
Start here
Learn how Suki for Partners fits into your product. Explore guides on common use cases, integration paths, and go live faster.
New to Suki for Partners?
Understand the product, value, and integration approach before you start building.
Latest releases
What's new
Explore new APIs, SDKs, and features recently added to Suki for Partners.
New
Audio Dictation APIs
Dictation APIs to transcribe audio in real-time
Beta
Headless Web SDK
New beta headless SDK for building custom ambient integrations with full UI control
Beta
Dictation SDK
New beta dictation SDK for embedding clinical dictation in the browser
New
Form Filling APIs
New form filling APIs for creating form filling sessions and retrieving structured field data