Skip to main content
POST
/
v1
/
ambient
/
api
/
transcribe
Multipart upload
curl -sS -X POST https://rcm-api.athelas.com/v1/ambient/api/transcribe \
  -H 'Authorization: Bearer $TOKEN' \
  -F 'audio_file=@/path/visit.mp3' \
  -F 'patient_name=John Doe' \
  -F 'date_of_service=2025-11-06T14:05:00Z'
{
  "transcription_id": 123,
  "submitted_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
audio_file
file
required

Audio content.

Supported types: mp3, mp4, mpeg, mpga, m4a, wav, webm. Maximum file size in the web interface is 5MB. For files larger than 5MB, use the API directly via curl.

​
patient_name
string
​
additional_context
string

JSON-serialised metadata as a string

Example:

"{'age':72,'gender':'M'}"

​
date_of_service
string<datqe-time>

Response

202 - application/json

Transcription job accepted

​
transcription_id
integer
required
​
submitted_at
string<date-time>
required