Add treatment billing

1. Get an API key

Create a sandbox organization in the developer console, then copy its key from API keys.

MINDBILL_API_KEY=your_sandbox_key\nAPP_ORIGIN=http://localhost:3000

For Next.js, create .env.local in the project root, alongside package.json, even if you use src/app. Use the exact name MINDBILL_API_KEY in both your environment and server code. Set APP_ORIGIN to your frontend’s exact origin, including its port. Restart your dev server after setting these values.

Keep the key on your server; do not add a NEXT_PUBLIC_ prefix or put it in Angular environment.ts. Use invented patient data in sandbox; sandbox submissions never reach payers.

2. Choose your setup

Use the same libraries and authentication as med-legal billing. Complete the setup once, then return here.

npm install @mindbill/react@0.73.0

npm install @mindbill/angular@latest

npm install @mindbill/node@latest

3. Add treatment service lines

Start with the patient, claim, provider, location, and diagnosis fields from the example bill as billInput. Set the billing mode and replace the med-legal lines with professional services.

Choose the mode explicitly: med_legal is the default medical-legal evaluation workflow with shared bill diagnoses. professional is treatment billing, where each procedure line selects its applicable diagnoses using one-based diagnosisPointers. Professional bills allow up to 12 diagnoses and up to four pointers per line. Review those selections instead of automatically copying every diagnosis to every procedure.

const treatmentBill = {
  ...billInput, // Patient, claim, providers, location, and diagnoses.
  billingMode: "professional" as const,
  serviceLines: [{
    code: "99213",
    units: 1,
    charge: 150, // Total line charge, not a unit rate. Synthetic example.
    serviceDate: "2026-08-25",
    diagnosisPointers: [1],
    feeContext: {
      physicianContext: {
        providerKind: "physician" as const,
        placeOfService: "11",
        standaloneService: true,
        globalPeriodApplies: false,
        hpsaBonusEligible: false,
      },
    },
  }],
};

Every professional line needs an explicit total charge, not a unit rate. Schedule coverage depends on the service and date. The example assumes a California claim and one physician office visit with no related same-day services or global surgical package. Replace these facts with the actual encounter. Quote the complete encounter using the California fee calculator before submission. Bill charges use dollars; fee quotes use cents. The server rechecks lines with feeContext and rejects unresolved pricing with bill_fee_requires_review. An explicitly entered manual charge without fee context is not a verified statutory allowance. If a service relates to an RFA item, also include that item’s rfaItemId on its bill line.

4. Submit and track the bill

Pass treatmentBill to the entry form for review and document upload, or submit it from your server. Reuse saved providers, service locations, and W-9 settings; attach optional authorization or network records when appropriate.

"use client";
import { BillSubmissionForm, type BillSubmissionInput } from "@mindbill/react";

export default function TreatmentBill({ treatmentBill, treatmentBilling }: {
  treatmentBill: BillSubmissionInput;
  // Supply the organization capability from your authenticated backend.
  treatmentBilling: boolean;
}) {
  return <BillSubmissionForm
    initialBill={treatmentBill}
    treatmentBilling={treatmentBilling}
    sessionEndpoint="/api/mindbill/session"
    onSubmitted={({ billId }) => {
      window.location.href = "/billing/" + encodeURIComponent(billId);
    }}
  />;
}

import { Component, Input } from "@angular/core";
import {
  MindBillBillSubmissionComponent,
  type BrowserBillCreateInput,
} from "@mindbill/angular";

@Component({
  selector: "app-treatment-bill",
  standalone: true,
  imports: [MindBillBillSubmissionComponent],
  template: `<mindbill-bill-submission
    [initialBill]="treatmentBill"
    sessionEndpoint="/api/mindbill/session"
    (submitted)="openBill($event.bill.id)"
  />`,
})
export class TreatmentBillComponent {
  @Input({ required: true }) treatmentBill!: BrowserBillCreateInput;
  openBill(id: string) {
    window.location.href = "/billing/" + encodeURIComponent(id);
  }
}

import { readFile } from "node:fs/promises";
import { mindbill } from "./mindbill"; // Client from the API quickstart.

// Build treatmentBill using step 3, then attach your synthetic report.
const report = await readFile("./synthetic-treatment-report.pdf");
const bill = await mindbill.createAndSubmitBill({
  bill: treatmentBill,
  submission: { route: "ebill" },
  documents: [{
    filename: "synthetic-treatment-report.pdf",
    documentType: "final_report",
    contentBase64: report.toString("base64"),
  }],
}, "demo-treatment-submit-001");

console.log(bill.id);

For 97110, React 0.69.4 collects the actual therapy service facts before requesting an estimate. Preserve supplied context, include all same-day services, and keep unsupported cases in review. See therapy fields and calculation limits.

Pass the authorized organization capability as treatmentBilling; the prop does not grant server access. React 0.69.2 collects documented personal-performance, medical-direction, and monitored-care facts for anesthesia lines. Keep anesthesia service quantity at one and supply elapsed minutes separately. See anesthesia fields and server review.

Use the returned bill ID with the single-bill component or status API. Treatment bills use the same dashboard and lifecycle actions; show the actions available for each bill.