Authorizations API

Attach UR decisions to a bill

Copy chosen decision letters onto an unsent bill, or retry attaching every linked authorization.

POSThttps://app.mindbill.org/partner/v2/bills/{billId}/ur-decisions

Let a biller add utilization review evidence to a treatment bill before it is sent. Safe to repeat; nothing is sent.

AuthenticationServer API key or browser session + Origin

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

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

MindBill bill identifier.

Request body

FieldTypeDescription

documentIds

string[]

Decision letters to copy onto the bill as supporting documents. Send this or linked.

1–8 items

linked

true

Retry attaching every linked RFA's signed form and decision. Send this or documentIds.

Examples

curl 'https://app.mindbill.org/partner/v2/bills/bill_example/ur-decisions' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "documentIds": [
    "rfadoc_example"
  ]
}'

curl 'https://app.mindbill.org/partner/v2/bills/bill_example/ur-decisions' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "documentIds": [
    "rfadoc_example"
  ]
}'

Response

200 OK

{ "data": { "attached": 1 } }

FieldTypeDescription

data.attachedRequired

integer

Number of documents newly attached.

data.linked

object[]

Linked authorization state after a linked=true retry.