$ra.evaluate-measure

Evaluate Measure

draftDa Vinci Risk Adjustment2.1.0operation6 inputs1 output

The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results.

Metadata

hl7.org/fhir
Canonical URL
http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure
Code
$ra.evaluate-measure
Kind
operation
Affects State
No
Publisher
HL7 International / Clinical Quality Information

Invocation Context

Can be invoked at:
Type LevelInstance Level
Target Resources:

Input Parameters (6)

NameTypeCard.Description
periodStart*date1..1The start of a clinical evaluation period. The periodStart and periodEnd parameters will be compared with the clinical evaluation period (`MeasureReport.period.start` and `MeasureReport.period.end`) of a [Risk Adjustment Coding Gap MeasureReport](StructureDefinition-ra-measurereport.html) available on the Server. The MeasureReport will be returned if there is an overlap of the two periods.
periodEnd*date1..1The end of a clinical evaluation period.
subject*string1..1Subject will be a reference to either Patient ([US Core Patient](http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-patient.html)) or Group ([Patient Group](StructureDefinition-ra-patient-group.html)). Must provide either Patient/123 or Group/123, cannot simply provide 123. If only 123 is provided, then the operation would not know if it is a Patient reference or a Group reference.
measureIdid0..*The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24
measureIdentifierstring0..*The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24.
measureUrlcanonical0..*This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24

Output Parameters (1)

NameTypeCard.Description
returnBundle0..1The $ra.evaluate-measure operation will always return one [Parameters](https://www.hl7.org/fhir/parameters.html) whether the subject is a single patient or a group of patients. [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) for a patient is in a `Parameters.parameter` element. A Risk Adjustment Coding Gap Report Bundle contains the Risk Adjustment Coding Gap Reports for the same patient. For example, if a Group has 10 valid patients, then a [Parameters](https://www.hl7.org/fhir/parameters.html) will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient.

Additional Information

Version
2.1.0
Date
2025-07-02T02:08:34+00:00
Base Definition
http://hl7.org/fhir/OperationDefinition/Measure-evaluate-measure