Reviews API

Submit a bill review

Submit a completed SBR or IBR through the bill’s available delivery route.

POSThttps://app.mindbill.org/partner/v2/bills/{billId}/reviews/{reviewId}/submissions

The review reason, payer control number, disputed amount, and evidence have been confirmed by the user.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: bills:submit · Browser: bills:act

IdempotencyRequired for safe retries

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.

reviewIdRequired

string

The Second Bill Review or Independent Bill Review identifier.

Examples

curl https://app.mindbill.org/partner/v2/bills/$BILL_ID/reviews/$REVIEW_ID/submissions \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header "Idempotency-Key: submit_sbr_case_17"

Response

201 Created

{ "data": { "id": "review_01J6Z4", "state": "submitted", "submittedAt": "2026-08-29T19:04:00.000Z" } }

FieldTypeDescription

data.idRequired

string

Review identifier.

data.stateRequired

"submitted"

Updated review state.

data.submittedAtRequired

string

ISO submission timestamp.