Bills API

List bill drafts

List unsent treatment bill drafts saved by this integration in the organization and environment.

GEThttps://app.mindbill.org/partner/v2/bill-drafts

Show a biller their saved, unsent treatment bills (for example on a claim page) so they can resume one. Submitted drafts are omitted unless status=submitted.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: bills:read · Browser: bills:read

IdempotencyNot required

Organization capabilitytreatmentBilling must be enabled

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Query parameters

FieldTypeDescription

claimId

string

Only drafts that reference this saved claim.

1–255 characters

status

"draft" | "submitted"

draft returns only editable drafts; submitted returns drafts that became bills. Without a filter, every unsubmitted draft is returned, including one a submission currently holds.

Default: all unsubmitted

limit

integer

Page size.

1–100; default 50

cursor

string

nextCursor from the previous page. Keep the other filters unchanged.

Examples

curl 'https://app.mindbill.org/partner/v2/bill-drafts?claimId=clm_example&limit=25' \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

curl 'https://app.mindbill.org/partner/v2/bill-drafts?claimId=clm_example&limit=25' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example'

Response

200 OK

{
  "data": [{
    "id": "billdraft_example",
    "externalId": "visit_2026_10_08_example",
    "status": "draft",
    "revision": 2,
    "claimId": "clm_example",
    "patientId": "pat_example",
    "bill": { "billingMode": "professional", "service": { "date": "2026-10-08" }, "serviceLines": [{ "code": "99213", "units": 1, "charge": 150 }] },
    "encounter": { "renderingProviderId": "rp_example", "placeOfServiceId": "loc_example", "claimId": "clm_example" },
    "serviceLineCount": 1,
    "submittedBillId": null,
    "createdAt": "2026-10-08T17:02:11.000Z",
    "updatedAt": "2026-10-08T17:20:45.000Z",
    "submittedAt": null
  }],
  "nextCursor": null
}

FieldTypeDescription

dataRequired

BillDraft[]

Drafts in this page, oldest ID first. Each has the fields shown on Read a bill draft.

nextCursorRequired

string | null

Cursor for the next page, or null when complete.