{
  "description": "The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results.",
  "_filename": "OperationDefinition-ra.evaluate-measure.json",
  "package_name": "hl7.fhir.us.davinci-ra",
  "date": "2026-04-07T00:27:39+10:00",
  "system": false,
  "publisher": "HL7 International / Clinical Quality Information",
  "instance": true,
  "jurisdiction": [ {
    "coding": [ {
      "code": "US",
      "system": "urn:iso:std:iso:3166",
      "display": "United States of America"
    } ]
  } ],
  "name": "RAEvaluateMeasure",
  "type": "true",
  "experimental": null,
  "resourceType": "OperationDefinition",
  "title": "Evaluate Measure",
  "package_version": "3.0.0-ballot",
  "extension": [ {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger": 1
  }, {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode": "cqi"
  }, {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode": "draft"
  } ],
  "status": "draft",
  "id": "04df68d3-ecaa-4c65-b7bf-e4d67e7cdbf8",
  "resource": [ "Measure" ],
  "kind": "operation",
  "url": "http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure",
  "code": "ra.evaluate-measure",
  "base": "http://hl7.org/fhir/OperationDefinition/Measure-evaluate-measure",
  "version": "3.0.0-ballot",
  "contact": [ {
    "telecom": [ {
      "value": "http://www.hl7.org/Special/committees/cqi",
      "system": "url"
    } ]
  } ],
  "parameter": [ {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "periodStart",
    "type": "date",
    "documentation": "The 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."
  }, {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "periodEnd",
    "type": "date",
    "documentation": "The end of a clinical evaluation period."
  }, {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "subject",
    "type": "string",
    "searchType": "reference",
    "documentation": "Subject 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."
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "measureId",
    "type": "id",
    "documentation": "The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24"
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "measureIdentifier",
    "type": "string",
    "searchType": "token",
    "documentation": "The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24."
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "measureUrl",
    "type": "canonical",
    "documentation": "This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24"
  }, {
    "max": "1",
    "min": 0,
    "use": "out",
    "name": "return",
    "type": "Bundle",
    "documentation": "The $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."
  } ]
}