API for Developers

Transcription and Documentation in One API Call

Send audio, receive a structured medical letter. One API call handles speech recognition and document generation - no chaining required.

API Status
# 1. Submit job with your document structure
job = requests.post("…/audio/submit",
headers={"X-API-Key": API_KEY},
json={
"s3_key": s3_key,
"language_code": "en-GB",
"structure": {
"Anamnesis": "Patient-reported symptoms",
"Diagnosis": "Clinical findings and impression",
"Plan": "Treatment and follow-up",
"Smoking status": {"enum": ["never", "former", "current"]},
"MRI ordered": {"type": "boolean"}
}
}
)
# 2. Retrieve result - polling and webhooks supported natively
[
{"Anamnesis": "Chest pain since this morning"},
{"Diagnosis": "Suspected angina pectoris"},
{"Plan": "Cardiology referral, Aspirin 100mg"},
{"Smoking status": "current"},
{"MRI ordered": true}
]
For developers

Technical details

Structured JSON output

Define sections and typed fields (text, dropdown, number, yes/no, list) with each request. The response is guaranteed to match that schema.

Signed webhooks or polling

Asynchronous processing, even for long recordings. Results arrive via an HMAC-SHA256-signed webhook, or you poll for them.

Audio formats

MP3, WAV, M4A, OGG, Opus and WebM. Up to 70 MB per file, uploaded straight to a pre-signed URL.

12 languages

Set via language_code: de-DE, en-GB, fr-FR, es-ES, pt-PT, sv-SE, fi-FI, pl-PL, cs-CZ, sl-SI, hr-HR, el-GR.

Authentication

API key in the X-API-Key header. All traffic runs over TLS.

More modules

Voice corrections, ICD-10 coding, MEL procedure codes, text blocks and evidence per field - all with the same API key. All modules in detail

Use cases

Where it fits

Integration scenarios for healthcare software

Hospital software (HIS)

Voice documentation inside the HIS, from admission interview to discharge letter.

Practice software

Dictations and consultations go straight into the patient record.

Telehealth platforms

Visit summaries generated automatically after video consultations.

Mobile apps

Dictation with instantly structured output.

Get started

Ready to integrate?

Request API access and start building.

SmartArzt