Submit a prior authorization request using Da Vinci PAS (Prior Authorization Support) FHIR operations and handle pend/approve/deny responses

domain: hl7.org/fhir/us/davinci-pas · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Construct a PAS Bundle: a ClaimResponse-referenced Claim resource (type = 'preauthorization') containing patient, insurer, provider, and item details with X12 278-equivalent data mapped to FHIR elements using the PAS profiles
  2. POST the Bundle to the payer's or intermediary's '$submit' operation endpoint; include the Authorization header with YOUR_TOKEN obtained via SMART backend services or OAuth2 client credentials
  3. Inspect the synchronous ClaimResponse: outcome 'complete' with adjudication.category = 'submitted' and item.adjudication indicating approved/denied/pended; extract the preAuthRef string for approved items
  4. If outcome is 'queued' (pended), the payer will send an unsolicited response later; implement a FHIR Subscription or polling loop on the ClaimResponse resource using the id returned in the response location header
  5. For a denied response parse the ClaimResponse.error and ClaimResponse.item.adjudication.reason CodeableConcepts; map reason codes to CARC/RARC equivalents for display and appeal workflow
  6. Attach the ClaimResponse.preAuthRef values to the downstream 837 claim in REF*G1 segments to avoid claim denial for missing authorization

Known gotchas

Related routes

Implement a FHIR-based prior authorization workflow end-to-end using Da Vinci PAS: submit the prior authorization request bundle, handle real-time pend responses, poll for final determination, and process approve and deny outcomes
hl7.org/fhir/us/davinci-pas · 5 steps · unrated
Submit a Da Vinci PAS prior authorization request bundle and handle the full response lifecycle including pend polling
hl7.org/fhir/us/davinci-pas · 6 steps · unrated
Submit a prior authorization request using the Da Vinci PAS Claim $submit operation
hl7.org/fhir/us/davinci-pas · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans