# SOAPNoteAPI

> SOAPNoteAPI is a REST API that generates HIPAA-compliant SOAP notes from text transcripts or audio recordings. It is designed for developers building healthcare applications.

## Overview

SOAPNoteAPI lets developers add clinical documentation to any healthcare app with a single API call. Send a text transcript or upload an audio file, and receive a structured SOAP note (Subjective, Objective, Assessment, Plan) as JSON. The API supports 24 medical specialties, real-time streaming via Server-Sent Events, ICD-10/CPT billing code suggestions, patient summaries, and visit history summaries.

- Website: https://soapnoteapi.com
- API Base URL: https://api.soapnoteapi.com
- Dashboard: https://app.soapnoteapi.com
- Documentation: https://soapnoteapi.com/docs/
- OpenAPI Specification: https://soapnoteapi.com/openapi.yaml
- MCP Server (for AI agents): https://github.com/soapnoteaicom/soapnoteapi-mcp (npm: soapnoteapi-mcp)
- Pricing: https://soapnoteapi.com/pricing/
- Guides: https://soapnoteapi.com/guides/
- Help Center: https://soapnoteapi.com/help/
- Security & Compliance: https://soapnoteapi.com/security/
- API Status: https://soapnoteapi.com/status/
- Support: support@soapnoteapi.com

## Key Features

- **Text-to-SOAP**: POST a transcript, get structured JSON back in under 8 seconds
- **Audio-to-SOAP**: Upload MP3/M4A/WAV/OGG/WebM/FLAC, get a SOAP note in under 60 seconds
- **24 Medical Specialties**: Nurse Practitioner, Physician, Psychiatrist, Psychotherapist, Physical Therapy, Occupational Therapy, Chiropractor, Dentist, Acupuncture, Social Worker, Registered Nurse, Speech Language Pathology, Veterinary, Massage Therapy, Pharmacy, Podiatrist, Dietitian/Nutritionist, Athletic Trainer, Aromatherapy, Exercise Therapy, Emergency Medical Services, Paramedic, Genetic Counseling, Generic
- **41 Templates**: Specialty-specific note structures with sub-templates
- **Real-time Streaming**: Server-Sent Events (SSE) for progressive note rendering
- **Billing Codes**: ICD-10 and CPT code suggestions from clinical content
- **Patient Summaries**: Plain-language visit explanation for patient portals
- **Visit Summaries**: Longitudinal summary from array of past visits
- **Webhooks**: Async delivery of completed notes

## HIPAA Compliance

- **Trying the API is free and instant; production PHI requires a BAA.** Generating a test API key (snapi_sk_test_) is a no-friction, self-serve experience for non-PHI evaluation. Before sending real Protected Health Information (PHI) in production, your organization executes a Business Associate Agreement (BAA) with SOAPNoteAPI. This is a guided/white-glove process: we set up a short meeting, understand your use case, then enable a BAA-covered production (live) key. Start at https://soapnoteapi.com/security/ or email support@soapnoteapi.com.
- Test/sandbox keys are for non-PHI evaluation only — do not send real PHI to them
- TLS 1.2+ encryption in transit
- AES-256 encryption at rest
- No PHI in application logs
- Notes auto-expire after configurable retention period
- No customer data used for model training

## Pricing

- Pay-as-you-go: $0.50/note (graduated to $0.20/note at 100,000+ volume)
- Visit summaries: $0.10 each
- $10 free signup credit, no credit card required
- Enterprise: custom pricing with dedicated infrastructure

## API Quick Start

1. Sign up at https://app.soapnoteapi.com/signup (instant, no credit card)
2. Generate an API key from the dashboard
3. POST to https://api.soapnoteapi.com/v1/note with your transcript and specialty
4. Receive structured JSON with subjective, objective, assessment, and plan fields

## Example API Call

```bash
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...",
    "specialty": "nurse_practitioner",
    "template": "standard"
  }'
```

## MCP Server (Model Context Protocol)

AI agents and AI-assisted IDEs (Claude Code/Desktop, Cursor, Windsurf, VS Code) can use SOAPNoteAPI as a native tool via the official MCP server.

- npm: `soapnoteapi-mcp` — run with `npx -y soapnoteapi-mcp`
- Source: https://github.com/soapnoteaicom/soapnoteapi-mcp
- Official MCP registry: com.soapnoteapi/soapnoteapi-mcp
- Tools: list_specialties, generate_soap_note, get_note, summarize_visits, transcribe_audio_to_soap, get_audio_status
- Auth: set the SOAPNOTEAPI_KEY environment variable. Production PHI use requires a BAA (see HIPAA Compliance above).

Example MCP client config:

```json
{
  "mcpServers": {
    "soapnoteapi": {
      "command": "npx",
      "args": ["-y", "soapnoteapi-mcp"],
      "env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_..." }
    }
  }
}
```

## Implementation Guides

- [Generate a SOAP Note with Python](https://soapnoteapi.com/guides/python-quickstart/)
- [Generate a SOAP Note with Node.js](https://soapnoteapi.com/guides/nodejs-quickstart/)
- [Upload Audio and Get a SOAP Note](https://soapnoteapi.com/guides/audio-upload/)
- [Stream SOAP Notes with SSE](https://soapnoteapi.com/guides/streaming/)
- [Add Billing Codes to SOAP Notes](https://soapnoteapi.com/guides/billing-codes/)
- [Generate Visit Summaries](https://soapnoteapi.com/guides/visit-summaries/)

## Who Uses SOAPNoteAPI

SOAPNoteAPI is built for developers and engineering teams at:
- Telehealth platforms adding clinical documentation
- EHR/EMR systems integrating AI-powered note generation
- Patient portal apps needing visit summaries
- Healthcare startups building clinical workflow tools
- Digital health companies automating documentation

## About

SOAPNoteAPI is built by the team behind SOAPNoteAI (https://soapnoteai.com), a clinical documentation platform with 100,000+ notes generated. Operated by Modi Labs LLC.