Reviews API

Create a bill review

Create a Second Bill Review or Independent Bill Review draft with selected evidence.

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

Use second_review for a denial or partial payment; use independent_bill_review when escalating an eligible dispute after SBR.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: bills:write · 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.

Request body

FieldTypeDescription

externalId

string

Your review or appeal identifier.

typeRequired

"second_review" | "independent_bill_review"

Review stage.

reasonRequired

string

Reason and argument submitted to the payer.

disputedAmount

number

Amount in dispute.

payerClaimControlNumber

string

Original EOR/835 claim control number.

attachmentIds

string[]

Supporting documents intentionally included with the review.

Examples

curl https://app.mindbill.org/partner/v2/bills/$BILL_ID/reviews \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: sbr_case_17" \
  --data '{
    "type": "second_review",
    "reason": "The report meets the med-legal criteria and supports the billed service.",
    "disputedAmount": 415,
    "payerClaimControlNumber": "835-REF-F8-10042",
    "attachmentIds": ["doc_01J6Z1"]
  }'

Response

201 Created

{ "data": { "id": "review_01J6Z4", "billId": "bill_01J6Y7", "originalBillId": "bill_01J6Y7", "externalId": null, "type": "second_review", "state": "draft", "reason": "The report meets the med-legal criteria and supports the billed service.", "disputedAmount": 415, "payerClaimControlNumber": "835-REF-F8-10042", "attachmentIds": ["doc_01J6Z1"], "submittedAt": null } }

FieldTypeDescription

data.idRequired

string

Review identifier.

data.typeRequired

BillReviewType

Review stage.

data.stateRequired

"draft" | "submitted"

Review lifecycle state.

data.attachmentIdsRequired

string[]

Evidence included in the review.