Developer documentation
Build your first billing integration
Start with one bill ID. MindBill supplies the editable review, payer search, submission, status, EOR, payment, denial, and resubmission workflow.
Start here
Add billing to any web app
Create a synthetic bill over HTTP, mint one short-lived browser session, and render the lifecycle in React, Angular, or a hosted page.
- About 10 minutes
- Any HTTPS backend
- No provider or location synchronization required
The integration
// Any server: create one bill and keep its ID.
const response = await fetch("https://app.mindbill.org/api/partner/v2/bills", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDBILL_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `bill:${evaluation.id}`,
},
body: JSON.stringify({
externalId: evaluation.id,
billingMode: "med_legal",
patient,
claim,
service,
billingProvider,
renderingProvider,
serviceLocation,
diagnoses,
serviceLines,
}),
});
const { data: bill } = await response.json();
// Browser: MindBill owns the billing lifecycle.
<ConnectedBillLifecycle
billId={bill.id}
sessionEndpoint="/api/mindbill/session"
/>Mental model
One bill, one lifecycle
Your app sends known structured data and documents. Users fill only what is missing.
1
Create the bill
Send a complete snapshot and store the returned bill.id.
2
Review and submit
Use the native React lifecycle or the hosted review with the same bill.
3
Track and act
Status determines whether the user can view an EOR, post payment, appeal, resubmit, or close.
Synthetic sandbox
Get an API key
Sandbox accepts synthetic data only. Live access requires a BAA and an organization-bound key.