Generate a SOAP Note with Python

pip install requests

export SOAPNOTEAPI_KEY="snapi_sk_test_your_key_here"

import os
import requests

api_key = os.environ["SOAPNOTEAPI_KEY"]

response = requests.post(
    "https://api.soapnoteapi.com/v1/note",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "transcript": (
            "Patient is a 45-year-old male presenting with lower back pain "
            "for the past two weeks. Pain is rated 6/10, worse with bending. "
            "No radiculopathy. Ibuprofen provides partial relief. Physical exam "
            "shows paravertebral muscle tenderness at L4-L5. Straight leg raise "
            "negative bilaterally. Assessment: acute lumbar strain. Plan: "
            "continue NSAIDs, start physical therapy twice weekly, follow up in "
            "4 weeks if not improved."
        ),
        "specialty": "nurse_practitioner",
    },
)

note = response.json()
print(note)

# Successful response (200 OK)
{
  "noteId": "note_abc123",
  "subjective": "Patient is a 45-year-old male presenting with lower back pain for the past two weeks...",
  "objective": "Physical exam shows paravertebral muscle tenderness at L4-L5...",
  "assessment": "Acute lumbar strain.",
  "plan": "Continue NSAIDs, start physical therapy twice weekly...",
  "expires_at": "2026-09-21T00:00:00Z"
}

response = requests.post(
    "https://api.soapnoteapi.com/v1/note",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "transcript": "Patient presents with...",
        "specialty": "nurse_practitioner",
    },
)

if response.status_code == 200:
    note = response.json()
    print("Subjective:", note["subjective"])
    print("Objective:", note["objective"])
    print("Assessment:", note["assessment"])
    print("Plan:", note["plan"])
elif response.status_code == 401:
    print("Invalid API key. Check your SOAPNOTEAPI_KEY variable.")
elif response.status_code == 400:
    error = response.json()
    print("Validation error:", error["message"])
elif response.status_code == 429:
    print("Rate limited. Wait and retry.")
else:
    print(f"Unexpected error ({response.status_code}):", response.text)

#!/usr/bin/env python3
"""Generate a SOAP note from a clinical transcript."""

import os
import sys
import requests

API_URL = "https://api.soapnoteapi.com/v1/note"


def generate_note(transcript: str, specialty: str = "nurse_practitioner") -> dict:
    """Send a transcript and return the parsed SOAP note."""
    api_key = os.environ.get("SOAPNOTEAPI_KEY")
    if not api_key:
        print("Error: set the SOAPNOTEAPI_KEY environment variable.", file=sys.stderr)
        sys.exit(1)

    response = requests.post(
        API_URL,
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json={
            "transcript": transcript,
            "specialty": specialty,
        },
    )
    response.raise_for_status()
    return response.json()


if __name__ == "__main__":
    transcript = (
        "Patient is a 45-year-old male presenting with lower back pain "
        "for the past two weeks. Pain is rated 6/10, worse with bending. "
        "No radiculopathy. Ibuprofen provides partial relief. Physical exam "
        "shows paravertebral muscle tenderness at L4-L5. Straight leg raise "
        "negative bilaterally. Assessment: acute lumbar strain. Plan: "
        "continue NSAIDs, start physical therapy twice weekly, follow up in "
        "4 weeks if not improved."
    )

    note = generate_note(transcript)
    for section in ("subjective", "objective", "assessment", "plan"):
        print(f"\n--- {section.upper()} ---")
        print(note[section])