SOAPNoteAPI
HIPAA Compliant · BAA Included · 99.9% Uptime

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

Generate a SOAP note
# 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.

559/2000
SOAP Note Output

Click "Generate SOAP Note" to see the output here...

24 specialtieswith sub-templates
$10 free crediton signup
6 audio formatsMP3 to FLAC
SSE streamingreal-time output
HIPAA compliantBAA available

Quick start

Up and running in minutes

Works with any HTTP client. No SDK, no dependencies, no config files.

01

Grab your key

Create an account. Your API key and $10 free credit are ready instantly — no credit card, no approval queue.

export SOAPNOTE_API_KEY=snapi_sk_test_••••••••
02

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.

curl -X POST https://api.soapnoteapi.com/v1/note \ -H "Authorization: Bearer $SOAPNOTE_API_KEY" \ -d '{"transcript": "...", "specialty": "physician"}'
03

Go live

Rotate to a production key. Same endpoint, same schema, same response shape. Zero migration.

export SOAPNOTE_API_KEY=snapi_sk_live_••••••••

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.

Nurse PractitionerPhysicianPsychiatristPsychotherapistPhysical TherapyOccupational TherapyChiropractorDentistAcupunctureSocial WorkerRegistered NurseSpeech Language PathologyVeterinaryMassage TherapyPharmacyPodiatristDietitian / NutritionistAthletic TrainerAromatherapyExercise TherapyEmergency Medical ServicesParamedicGenetic CounselingGeneric