Authorizations API

Read a UR response

Propose per-treatment decisions from an attached utilization review response. Saves nothing.

POSThttps://app.mindbill.org/partner/v2/rfas/{rfaId}/response-reading

After a UR response is attached as a ur_response document, prefill your decision form. A person must check the proposal and record it with POST /rfas/{rfaId}/decisions.

AuthenticationServer API key or browser session + Origin

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

IdempotencyNot required

Organization capabilitytreatmentBilling must be enabled

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

rfaIdRequired

string

MindBill RFA identifier.

Request body

FieldTypeDescription

documentIdRequired

string

A ur_response document attached to this RFA.

Examples

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/response-reading' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "documentId": "rfadoc_example"
}'

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/response-reading' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "documentId": "rfadoc_example"
}'

Response

200 OK

{
  "data": {
    "status": "read",
    "decidedAt": "2026-10-08",
    "items": [{
      "itemId": "rfaitem_example",
      "outcome": "approved",
      "confident": true,
      "authorizationNumber": "SYN-AUTH-001",
      "authorizedProcedureCode": "97110",
      "authorizedQuantity": 8,
      "effectiveFrom": "2026-10-08",
      "effectiveTo": "2026-11-08"
    }]
  }
}

FieldTypeDescription

data.statusRequired

"read" | "unreadable"

unreadable means no text could be read; enter the decision manually.

data.reason

"no_text" | "model_unavailable" | "model_answer_invalid"

Why the response was unreadable.

data.decidedAt

string

Decision date found in the response, YYYY-MM-DD.

data.items[]Required

object[]

One proposal per still-pending treatment: itemId, outcome (approved, modified, denied, not_addressed), confident, authorizationNumber, authorizedProcedureCode, authorizedQuantity, authorizedUnits, effectiveFrom, effectiveTo, decisionReason, reviewerName, reviewerPhone.