Authorizations API

Preview the DWC Form RFA from a draft

Fill the official DWC Form RFA from an unsaved request and return the unsigned PDF.

POSThttps://app.mindbill.org/partner/v2/rfas/draft-preview

Show the user the form as typed so far, before saving. No field is required and nothing is saved, signed, or sent.

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.

Request body

FieldTypeDescription
claimId / patientId / renderingProviderId / claimsAdminId
string

Saved records to fill from. A claimId must be one the caller can use.

requestType / expedited / rationale
string / boolean / string

Request details printed on the form.

requestingPractice / authorizationContact
object

Optional practice and contact overrides.

items[]
object[]

Treatments: diagnosisCode, diagnosisDescription, serviceDescription, procedureCode, quantity, frequency, duration.

Up to 100 items; body ≤ 500 KB

Examples

Server API key
curl 'https://app.mindbill.org/partner/v2/rfas/draft-preview' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "claimId": "clm_example",
  "patientId": "pat_example",
  "renderingProviderId": "rp_example",
  "items": [
    {
      "diagnosisCode": "M54.50",
      "diagnosisDescription": "Low back pain",
      "serviceDescription": "Physical therapy",
      "procedureCode": "97110",
      "quantity": 8,
      "frequency": "2x/week",
      "duration": "4 weeks"
    }
  ]
}' \
  --output rfa-draft-preview.pdf
Browser session
curl 'https://app.mindbill.org/partner/v2/rfas/draft-preview' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "claimId": "clm_example",
  "patientId": "pat_example",
  "renderingProviderId": "rp_example",
  "items": [
    {
      "diagnosisCode": "M54.50",
      "diagnosisDescription": "Low back pain",
      "serviceDescription": "Physical therapy",
      "procedureCode": "97110",
      "quantity": 8,
      "frequency": "2x/week",
      "duration": "4 weeks"
    }
  ]
}' \
  --output rfa-draft-preview.pdf

Response

200 OK

Response
200 OK
Content-Type: application/pdf

<unsigned DWC Form RFA without the instructions page>