Authorizations API

Record an RFA sent outside MindBill

Mark a request sent when the office faxed, mailed, emailed, or hand-delivered it without MindBill.

POSThttps://app.mindbill.org/partner/v2/rfas/{rfaId}/sent-outside

Allowed while the request was never sent, or while every MindBill attempt failed and nothing was received. No signed form or attachments are required in MindBill.

AuthenticationServer API key or browser session + Origin

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

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.

Request body

FieldTypeDescription

sentAtRequired

string

When the office sent it; not in the future.

ISO date-time

channelRequired

"fax" | "mail" | "email" | "manual"

How it was sent; manual means hand delivery.

destination

string

Fax number, address, or email it went to.

Up to 500 characters

proofDocumentId

string

A document already on the RFA showing what was sent.

receivedAt

string

Known claims administrator receipt time, on or after sentAt. Marks the request received and starts the decision clock.

ISO date-time

Examples

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/sent-outside' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Idempotency-Key: rfa_example-outside-1' \
  --header 'Content-Type: application/json' \
  --data '{
  "sentAt": "2026-10-01T17:05:00Z",
  "channel": "fax",
  "destination": "+15555550123"
}'

curl 'https://app.mindbill.org/partner/v2/rfas/rfa_example/sent-outside' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Idempotency-Key: rfa_example-outside-1' \
  --header 'Content-Type: application/json' \
  --data '{
  "sentAt": "2026-10-01T17:05:00Z",
  "channel": "fax",
  "destination": "+15555550123"
}'

Response

201 Created

{
  "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.