Generate a SOAP Note with Node.js

export SOAPNOTEAPI_KEY="snapi_sk_test_your_key_here"

const apiKey = process.env.SOAPNOTEAPI_KEY;

const response = await fetch("https://api.soapnoteapi.com/v1/note", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    transcript:
      "Patient is a 62-year-old female presenting for annual wellness visit. " +
      "She reports well-controlled type 2 diabetes on metformin 1000mg BID. " +
      "A1C last month was 6.8%. Denies polyuria, polydipsia, or blurred vision. " +
      "Vitals: BP 132/78, HR 68, BMI 27.4. Foot exam normal, monofilament intact. " +
      "Assessment: type 2 diabetes mellitus, well controlled. " +
      "Plan: continue metformin, repeat A1C in 6 months, annual eye exam referral.",
    specialty: "physician",
  }),
});

const note = await response.json();
console.log(note);

interface SOAPNoteResponse {
  noteId: string;
  status: "completed" | "processing" | "failed";
  specialty: string;
  subjective: string;
  objective: string;
  assessment: string;
  plan: string;
  created_at: string;
}

// Access each section
console.log("Subjective:", note.subjective);
console.log("Objective:", note.objective);
console.log("Assessment:", note.assessment);
console.log("Plan:", note.plan);

async function generateNote(transcript: string, specialty: string) {
  const response = await fetch("https://api.soapnoteapi.com/v1/note", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.SOAPNOTEAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ transcript, specialty }),
  });

  if (!response.ok) {
    const error = await response.json().catch(() => ({ message: "Unknown error" }));

    switch (response.status) {
      case 401:
        throw new Error("Invalid API key. Check your SOAPNOTEAPI_KEY variable.");
      case 400:
        throw new Error(`Validation error: ${error.message}`);
      case 429:
        throw new Error("Rate limited. Wait and retry.");
      default:
        throw new Error(`API error (${response.status}): ${error.message}`);
    }
  }

  return response.json();
}

#!/usr/bin/env node
// generate-note.mjs — Generate a SOAP note from a clinical transcript

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

async function generateNote(transcript, specialty = "physician") {
  const apiKey = process.env.SOAPNOTEAPI_KEY;
  if (!apiKey) {
    console.error("Error: set the SOAPNOTEAPI_KEY environment variable.");
    process.exit(1);
  }

  const response = await fetch(API_URL, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ transcript, specialty }),
  });

  if (!response.ok) {
    const error = await response.json().catch(() => ({}));
    console.error(`Error (${response.status}): ${error.message ?? response.statusText}`);
    process.exit(1);
  }

  return response.json();
}

const transcript =
  "Patient is a 62-year-old female presenting for annual wellness visit. " +
  "She reports well-controlled type 2 diabetes on metformin 1000mg BID. " +
  "A1C last month was 6.8%. Denies polyuria, polydipsia, or blurred vision. " +
  "Vitals: BP 132/78, HR 68, BMI 27.4. Foot exam normal, monofilament intact. " +
  "Assessment: type 2 diabetes mellitus, well controlled. " +
  "Plan: continue metformin, repeat A1C in 6 months, annual eye exam referral.";

const note = await generateNote(transcript);

for (const section of ["subjective", "objective", "assessment", "plan"]) {
  console.log(`\n--- ${section.toUpperCase()} ---`);
  console.log(note[section]);
}