Implement Da Vinci ATR Member Attribution lists for value-based care using the FHIR Group resource

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

Steps

  1. Review the Da Vinci ATR IG (hl7.org/fhir/us/davinci-atr) to understand the Member Attribution List workflow: a payer creates and maintains a FHIR Group resource representing the attributed patient population for a value-based care contract.
  2. Retrieve the attribution list: providers query GET [base]/Group?characteristic-value=[contract-id] or use a payer-defined identifier to locate the relevant Group resource representing their attributed population.
  3. Use $export on the Group to retrieve the full member list as NDJSON: GET [base]/Group/[id]/$export with _type=Patient to obtain Patient resources for all attributed members, or include additional types for clinical data.
  4. Implement the ATR $davinci-data-export operation if supported by the payer: this Da Vinci-specific operation exports attribution-related resources (Group, Patient, Coverage, and optionally clinical resources) as a coordinated bulk export.
  5. Process incremental updates: use the _since parameter on subsequent exports to retrieve only members added or removed from the attribution list since the last sync, avoiding full re-download on every refresh cycle.
  6. Reconcile the attribution list with the provider's patient panel: identify newly attributed members (to initiate outreach), members removed from attribution (to close care gaps), and members whose attribution details have changed.

Known gotchas

Related routes

Create and populate a Da Vinci ATR Member Attribution Group resource for value-based care contract attribution
hl7.org · 5 steps · unrated
Export a Da Vinci ATR attribution list using FHIR Bulk Data $export scoped to a Group, then reconcile the exported membership against a provider roster
hl7.org · 5 steps · unrated
Implement payer-to-provider attribution workflow using Da Vinci ATR: payer publishes attribution list, provider retrieves and reconciles it
hl7.org · 5 steps · unrated

Give your agent this knowledge — and 15,600+ 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