Authorizations API

Get RFA creation choices

Search saved patient claims and requesting physicians for a new authorization request.

GEThttps://app.mindbill.org/partner/v2/rfas/creation-context

Populate your own patient/claim and physician pickers before the first save of an RFA, or resolve the saved IDs you pass to POST /rfas and POST /fee-quotes/encounter. Read-only.

AuthenticationServer API key or browser session + Origin

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

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.

Query parameters

FieldTypeDescription

search

string

Claim search by patient name or claim number.

Up to 200 characters

cursor

string

Opaque claim cursor from nextCursor. Reset it when search or filters change.

providerSearch

string

Physician search by name or NPI.

Up to 200 characters

providerCursor

string

Opaque physician cursor from renderingProvidersNextCursor.

limit

integer

Page size for each list.

1–100; default 50

claimId

string

Restrict choices to one saved claim. The selected claim also returns its employer, date of birth, and adjuster name for the DWC Form RFA.

renderingProviderId

string

Restrict physicians to one saved rendering provider.

Examples

curl 'https://app.mindbill.org/partner/v2/rfas/creation-context?search=Example&limit=25' \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

curl 'https://app.mindbill.org/partner/v2/rfas/creation-context?search=Example&limit=25' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example'

Response

200 OK

{
  "data": {
    "claims": [{ "claimId": "clm_example", "patientId": "pat_example", "employeeName": "Alex Example", "claimNumber": "SYN-0001", "dateOfInjury": "2026-08-01", "diagnosisCodes": ["M54.50"] }],
    "renderingProviders": [{ "id": "rp_example", "name": "Sample Physician, MD", "npi": "1234567893" }],
    "nextCursor": null,
    "renderingProvidersNextCursor": null
  }
}

FieldTypeDescription

data.claims[]Required

object[]

claimId, patientId, employeeName, claimNumber, dateOfInjury, claimsAdminId, and diagnosisCodes for each matching saved claim.

data.renderingProviders[]Required

object[]

id, name, npi, and specialty for each active rendering provider.

data.nextCursor / renderingProvidersNextCursorRequired

string | null

Cursors for the next claim and physician pages.

data.returnFax / returnEmail

string

The organization's managed return channels for utilization review responses, when configured.