Reviews API

Retrieve a bill review

Retrieve one review draft or submitted review with its selected evidence.

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

Open a review editor or render the exact argument and attachments that were submitted.

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.

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 \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

Response

200 OK

{ "data": { "id": "review_01J6Z4", "billId": "bill_01J6Y7", "originalBillId": "bill_01J6Y7", "type": "second_review", "state": "draft", "reason": "The report supports the billed service.", "payerClaimControlNumber": "835-REF-F8-10042", "attachmentIds": ["doc_01J6Z1"] } }

FieldTypeDescription

data.idRequired

string

Review identifier.

data.billIdRequired

string

Bill currently being reviewed.

data.originalBillIdRequired

string

Original submitted bill in the review chain.

data.typeRequired

BillReviewType

Review stage.

data.stateRequired

"draft" | "submitted"

Review lifecycle state.

data.reasonRequired

string

Review argument.

data.payerClaimControlNumberRequired

string | null

Original EOR or 835 claim control number.

data.attachmentIdsRequired

string[]

Selected supporting documents.