Clinical notes,
one API call.
POST a transcript or upload audio. Get back a structured SOAP note — Subjective, Objective, Assessment, Plan — in seconds. 24 specialties. HIPAA compliant.
No credit card required · First 20 notes free · Built by the SOAPNoteAI team
# Text-to-SOAP: one call, structured note back
curl -X POST https://api.soapnoteapi.com/v1/note
-H "Authorization: Bearer $SOAPNOTE_API_KEY"
-H "Content-Type: application/json"
-d {
"transcript": "Patient is a 42-year-old male presenting with persistent lower back pain...",
"specialty": "nurse_practitioner",
"template": "standard"
}
# Response — structured, ready to paste into your EHR
{
"noteId": "note_01jfg8h...",
"subjective": "42-year-old male with 3-week history of lower back pain...",
"objective": "Lumbar ROM restricted at 40° flexion. Paraspinal tenderness L3-L5...",
"assessment": "Mechanical lower back pain, likely muscular. Rule out disc herniation...",
"plan": "1. NSAIDs PRN. 2. Physical therapy referral. 3. Follow-up in 4 weeks...",
"expires_at": "2027-01-15T00:00:00Z"
}Try it live
Generate a SOAP note — no signup required
Demo mode — do not enter real patient information. This environment is not covered by a BAA. Sign up for a free API key to use with protected health information.
Click "Generate SOAP Note" to see the output here...
Quick start
Up and running in minutes
Works with any HTTP client. No SDK, no dependencies, no config files.
Grab your key
Create an account. Your API key and $10 free credit are ready instantly — no credit card, no approval queue.
Make a request
POST a transcript with a specialty. You get back structured JSON — S, O, A, and P sections, ready to store or render.
Go live
Rotate to a production key. Same endpoint, same schema, same response shape. Zero migration.
Features
One endpoint. Structured clinical notes.
One REST API. No ML infrastructure. BAA included.
Text to SOAP
POST a transcript, get structured JSON back. Subjective, Objective, Assessment, Plan — each in its own field. Response in under 8 seconds.
Audio to SOAP
Upload audio as multipart/form-data. We handle transcription and SOAP generation in a single request — under 60 seconds. Supports MP3, M4A, WAV, OGG, WebM, and FLAC.
24 Specialties
Primary care, psychiatry, psychotherapy, physical therapy, chiropractic, dentistry, acupuncture, and 17 more. Each specialty produces correctly-structured output with sub-templates.
HIPAA Compliant
Signed BAA included at no extra cost. TLS in transit, AES-256 at rest. Notes auto-expire after a configurable retention window. No PHI in application logs.
Fast and Reliable
Text-to-SOAP: under 8s. Audio-to-SOAP: under 60s. Choose your delivery pattern: synchronous response, polling, or async webhook.
Secure by Default
API key authentication with SHA-256 hashing. Keys shown once at creation, never stored in plaintext. No PHI in application logs.
Real-time Streaming
POST to /v1/stream/note instead of /v1/note. Each SOAP section streams as it generates via Server-Sent Events. Build real-time UIs without polling.
Interactive Playground
Test every endpoint from your browser at app.soapnoteapi.com. Try text-to-SOAP, audio upload, and streaming before writing a single line of code.
Visit Summaries
Pass an array of past visits (visit date, provider, summary, ICD-10 codes). Get back a consolidated longitudinal summary — useful for referral workflows, patient timelines, or pre-visit prep views.
Billing Codes
Request ICD-10 and CPT billing code suggestions alongside any SOAP note. Codes are generated from the clinical content — ready for review before submission.
Patient Summaries
Returns an additional patient_summary field: a plain-language explanation of the visit you can surface in patient portals, email recaps, or care coordination UIs.
Specialties
24 medical specialties
Pass specialty in your request. We handle the rest.