Da Vinci Risk Adjustment Implementation Guide
2.1.0 - STU 2.1

Da Vinci Risk Adjustment Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 2.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-ra/ and changes regularly. See the Directory of published versions

## CapabilityStatement: Risk Adjustment Reporting Client Capability Statement

Official URL: http://hl7.org/fhir/us/davinci-ra/CapabilityStatement/ra-reporting-client | Version: 2.1.0
Standards status: Trial-use | Maturity Level: 2 | Computable Name: RAClientCapabilityStatement
Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.13.3
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

This profile defines the expected capabilities of a Da Vinci Risk Adjustment Reporting Client when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Reporting Clients and Reporting Servers. Clients are the actors making the request for Risk Adjustment Coding Gap Reports for patient(s) and for Risk Adjustmenet Models that are available on the Server. This CapabilityStatement resource includes the complete list of the recommended Da Vinci Risk Adjustment profiles and RESTful operations that a Risk Adjustment Reporting Client could support. Clients have the option of choosing from this list based on their local use cases and other contextual requirements.

Raw OpenAPI-Swagger Definition file | Download

## Risk Adjustment Reporting Client Capability Statement

- Implementation Guide Version: 2.1.0
- FHIR Version: 4.0.1
- Supported Formats: `xml`, `json`
- Supported Patch Formats: `application/json-patch+json`
- Published on: 2025-11-20 19:49:53+0000
- Published by: HL7 International / Clinical Quality Information

> Note to Implementers: FHIR Capabilities

> Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

### SHALL Support the Following Implementation Guides

- http://hl7.org/fhir/us/davinci-ra/ImplementationGuide/hl7.fhir.us.davinci-ra

## FHIR RESTful Capabilities

### Mode: `client`

Da Vinci Risk Adjustment Reporting Client SHALL support the operation and profiles specified in this implementation guide.

Security

> For general security consideration refer to the Security and Privacy Considerations.

Summary of System-wide Interactions

- SHOULD support the `batch`interaction.
- MAY support the `transaction`interaction.
- MAY support the `search-system`interaction.
- MAY support the `history-system`interaction.

### Capabilities by Resource/Profile

#### Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

- The relevant profiles (if any)
- The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
- The required, recommended, and some optional search parameters (if any).
- The linked resources enabled for `_include`
- The other resources enabled for `_revinclude`
- The operations on the resource (if any)

Resource Type | Profile | R | S | U | P | C | H-I | H-T | Searches | `_include` | `_revinclude` | Operations
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
MeasureReport | Supported Profiles Risk Adjustment Coding Gap MeasureReport | Y | Y | y? | y? |  | y? | y? | date, evaluatedResource, identifier, measure, patient, period, reporter, status, subject, measurereport-category | `MeasureReport:evaluatedResources` |  |
Bundle | Supported Profiles Risk Adjustment Coding Gap Report Bundle | Y | Y |  |  |  | y? | y? |  |  |  |

#### Resource Conformance: SHALL MeasureReport

Core FHIR Resource
MeasureReport
Reference Policy
`literal`, `logical`
Interaction summary

- SHALL support
  `read`

  Read allows maintainers of the MeasureReports to get the logical definitions of the MeasureReports

  `search-type`

  Search allows maintainers of the MeasureReports to find the logical definition of a MeasureReport

- MAY support `history-instance`, `history-type`
  `update`

  Update allows maintainers of the MeasureReports to update the logical definitions of a MeasureReport by its id or create a new one if it is new

  `patch`

  Patch allows maintainers of the MeasureReports to update the logical definition of a MeasureReport by posting a set of changes to it

Supported Profiles

Risk Adjustment Coding Gap MeasureReport

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | date | `date` |
SHALL | measure | `reference` |
SHALL | patient | `reference` |
SHALL | period | `date` |
SHALL | status | `token` |
SHALL | subject | `reference` |
SHALL | measurereport-category | `token` |
SHOULD | evaluatedResource | `reference` |
MAY | identifier | `token` |
MAY | reporter | `reference` |

#### Resource Conformance: MAY Bundle

Core FHIR Resource
Bundle
Reference Policy
`literal`, `logical`
Interaction summary

- SHALL support
  `read`

  Read allows maintainers of the Bundles to get the logical definitions of the Bundle

  `search-type`

  Search allows maintainers of the Bundles to find the logical definition of a Bundle

- MAY support `history-instance`, `history-type`.

Supported Profiles

Risk Adjustment Coding Gap Report Bundle