Reviews API

List bill reviews

List Second Bill Review and Independent Bill Review attempts for a bill.

GEThttps://app.mindbill.org/partner/v2/bills/{billId}/reviews

Show appeal history, current review state, and supporting evidence after a denial or partial payment.

AuthenticationServer API key or browser session + Origin

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

IdempotencyNot required

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.

Path parameters

FieldTypeDescription

billIdRequired

string

The MindBill bill identifier returned after atomic submission.

Examples

curl https://app.mindbill.org/partner/v2/bills/$BILL_ID/reviews \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

Response

200 OK

{ "data": [{ "id": "review_01J6Z4", "type": "second_review", "state": "draft", "reason": "The report supports the billed service.", "disputedAmount": 415, "attachmentIds": ["doc_01J6Z1"], "submittedAt": null }] }

FieldTypeDescription

data[].idRequired

string

Review identifier.

data[].typeRequired

BillReviewType

second_review or independent_bill_review.

data[].stateRequired

"draft" | "submitted"

Review lifecycle state.

data[].reasonRequired

string

Argument sent or prepared for the payer.

data[].disputedAmountRequired

number | null

Amount in dispute.

data[].attachmentIdsRequired

string[]

Supporting evidence included in the review.

data[].submittedAtRequired

string | null

ISO submission timestamp.