POST/api/v1/visits
所属する臨床医の音声録音から診察を作成します(user_emailで指定。省略時はキーの作成者)。
- 認証
- APIキー
- パラメーター
audio_filefile必須user_emailstring任意template_idinteger任意patient_first_namestring任意patient_last_namestring任意languagestring任意timestampstring任意patient_idstring任意medical_recordstring任意contextstring任意webhook_urlstring任意
リクエストcurl -X POST https://api.scribemd.ai/api/v1/visits \
-H "X-Api-Key: $SCRIBEMD_API_KEY" \
-F "audio_file=@visit.m4a" \
-F "user_email=dr.rivera@example.com" \
-F "language=en-US"
レスポンスHTTP/1.1 201 Created
{
"encounter_uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14"
}
GET/api/v1/organization_encounters
組織の診察記録を新しい順に1ページ20件で、日付と診療科で絞り込んで一覧取得します。
- 認証
- APIキー
- パラメーター
start_datedate任意end_datedate任意department_idsstring任意pageinteger任意
リクエストcurl "https://api.scribemd.ai/api/v1/organization_encounters?start_date=2026-01-01&end_date=2026-01-31&page=1" \
-H "X-Api-Key: $SCRIBEMD_API_KEY"
レスポンス{
"encounters": [
{
"id": 12345,
"uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14",
"title": "Follow-up visit",
"status": "finished",
"summary_status": "finished",
"note_format": "markdown",
"markdown_content": "#### Chief Complaint\n..."
}
],
"pagination": { "count": 1, "page": 1, "limit": 20 }
}
POST/api/v1/integrations/recordings
臨床医のためにEHR連携の録音を開始し、録音ウィジェット用の短期トークンを返します。
- 認証
- APIキー
- パラメーター
user_emailstring必須settingsobject任意
リクエストcurl -X POST https://api.scribemd.ai/api/v1/integrations/recordings \
-H "Authorization: Bearer $SCRIBEMD_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "user_email": "dr.rivera@example.com", "settings": { "defaultLanguage": "en-US" } }'
レスポンスHTTP/1.1 201 Created
{
"uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14",
"recordId": null,
"token": "fake-short-lived-token",
"expiresAt": "2026-01-15T10:30:00Z",
"settings": { "defaultLanguage": "en-US" }
}
GET/api/v1/integrations/recordings/:uuid
連携録音のステータスを取得し、完了後はカルテの項目と文字起こしを返します。
- 認証
- APIキー
- パラメーター
リクエストcurl https://api.scribemd.ai/api/v1/integrations/recordings/1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14 \
-H "X-Api-Key: $SCRIBEMD_API_KEY"
レスポンス{
"uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14",
"recordId": null,
"patientId": null,
"status": "waiting",
"reviewedAt": null,
"settings": {}
}
GET/api/v1/encounters/retrieve
サインイン中の臨床医の診察を、uuid、EHRの診察IDまたは予約IDで取得します。カルテはreadyがtrueになると取得できます。
- 認証
- ユーザートークン
- パラメーター
uuidstring任意ehr_encounter_idstring任意ehr_appointment_idstring任意
リクエストcurl "https://api.scribemd.ai/api/v1/encounters/retrieve?uuid=1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14" \
-H "Authorization: Bearer $SCRIBEMD_USER_TOKEN"
レスポンス{
"success": true,
"uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14",
"summary_status": "running",
"transcript_status": "finished",
"ready": false,
"duration": 642
}
POST/api/v1/encounters/:id/resume_visit
診察の録音を、関連付けられた新しい診察として続行します。
- 認証
- ユーザートークン
- パラメーター
POST/api/v1/encounters/:id/update_notes
診察のカルテを置き換えます(JSON形式のカルテ、またはMarkdown形式のカルテの場合はMarkdown)。
- 認証
- ユーザートークン
- パラメーター
idinteger必須prompt[json_notes]object任意prompt[markdown_content]string任意
PATCH/api/v1/encounters/:id/update_markdown
Markdown形式のカルテのMarkdownを置き換えます。保存時にJSON形式のカルテも同期されます。
- 認証
- ユーザートークン
- パラメーター
idinteger必須prompt[markdown_content]string必須
リクエストcurl -X PATCH https://api.scribemd.ai/api/v1/encounters/12345/update_markdown \
-H "Authorization: Bearer $SCRIBEMD_USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "prompt": { "markdown_content": "#### Chief Complaint\nCough for 3 days." } }'
レスポンス{
"data": {
"id": 12345,
"uuid": "1bc91eb0-ca16-40a5-87c5-ccc7b6cb4f14",
"note_format": "markdown",
"markdown_content": "#### Chief Complaint\nCough for 3 days.",
"json_notes": { "...": "..." }
}
}
POST/mcp
AIアシスタント向けの読み取り専用Model Context Protocolサーバー。
- 認証
- OAuth