Authorizations API

Close or reopen a requested treatment

Administratively close a pending treatment when a decision is no longer needed, or reopen it.

PATCHhttps://app.mindbill.org/partner/v2/rfas/{rfaId}/items/{itemId}/closure

Stop follow-up for a treatment the patient no longer needs. This does not change clinical outcomes, authorization, review clocks, or submitted documents.

AuthenticationServer API key or browser session + Origin

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

IdempotencyRequired for safe retries

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.

itemIdRequired

string

Requested treatment identifier.

Request body

FieldTypeDescription

closedRequired

boolean

true to close, false to reopen.

reasonRequired

string

Why the decision is no longer required, kept in RFA history.

1–2,000 characters

expectedVersionRequired

integer

Current closure version; 0 before the first closure.

Examples

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/items/rfaitem_example/closure' \
  --request PATCH \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Idempotency-Key: rfaitem_example-close-1' \
  --header 'Content-Type: application/json' \
  --data '{
  "closed": true,
  "reason": "Patient declined the treatment.",
  "expectedVersion": 0
}'

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/items/rfaitem_example/closure' \
  --request PATCH \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Idempotency-Key: rfaitem_example-close-1' \
  --header 'Content-Type: application/json' \
  --data '{
  "closed": true,
  "reason": "Patient declined the treatment.",
  "expectedVersion": 0
}'

Response

200 OK

{
  "data": {
    "id": "rfa_example",
    "claimId": "clm_example",
    "patientId": "pat_example",
    "renderingProviderId": "rp_example",
    "status": "submitted",
    "lifecycleStatus": "sent",
    "contentRevision": 2,
    "submittedAt": "2026-10-01T17:05:00.000Z",
    "receivedAt": null,
    "decisionDueAt": null,
    "items": [{ "id": "rfaitem_example", "serviceDescription": "Physical therapy", "procedureCode": "97110", "outcome": "pending" }],
    "documents": [], "transmissions": [], "informationRequests": [], "events": []
  }
}

FieldTypeDescription

dataRequired

Rfa

The updated RFA detail.