--- type: "resource" title: "MeasureReport" resource: "MeasureReport" --- # MeasureReport ## Introduction ## Scope and Usage The MeasureReport resource represents the results of calculating a measure for a specific subject or group of subjects. The `$evaluate` operation of the [Measure](measure) resource is defined to return a MeasureReport. The resource can represent three different levels of report: individual, subject-list, and summary. The resource draws requirements from the HL7 CDA R2 Implementation Guide: Quality Reporting Document Architecture - Category 1 (QRDA I) Release 1 STU5.3 (US Realm) and the HL7 Implementation Guide for CDA Release 2: Quality Reporting Document Architecture - Category III (QRDA III), Release 1 implementation guides. An _individual_ MeasureReport contains information about a specific subject and typically includes references to the relevant data used to generate the report. A _subject-list_ MeasureReport reports on a list of subjects and provides a List resource that contains references to individual-level reports for each subject being reported. A _summary_ MeasureReport reports on a group of subjects and contains population counts and the calculated score as defined by the Measure. Finally, _data-collection_ reports are used to communicate the data of interest, so no scoring or other calculated information is expected. For a detailed discussion of how to use the Measure and MeasureReport resources, refer to the [Quality Reporting](clinicalreasoning-quality-reporting) topic. ## Boundaries and Relationships Although the MeasureReport is conceptually an [Observation](observation), there is enough specific information required to support the quality reporting use case to warrant a separate resource. The resource is differentiated from a general-purpose query result because it communicates specific information related to quality measurement evaluation that would be difficult to convey generally without imposing some other structure on top of the general results. ## Background and Context Provides additional detail on exactly how the resource is to be used ## Notes ## MeasureReport Search Although the MeasureReport resource does define search parameters, it is up to the individual measure evaluation service whether historical records of measure evaluation requests are preserved. A service might not support searching on MeasureReports at all, or it may support searching only for a pre-defined expiration period. The search parameters are defined to provide consumers with a consistent interface to searching if it is available for a specific service implementation. In any case, services should detail the support they do provide using a CapabilityStatement. ## StructureDefinition ### Elements (Simplified) - **[MeasureReport](/measurereport-definitions#MeasureReport)** [0..*]: - Results of a measure evaluation - **[MeasureReport.identifier](/measurereport-definitions#MeasureReport.identifier)** [0..*]: [Identifier](/Identifier) Additional identifier for the MeasureReport - **[MeasureReport.category](/measurereport-definitions#MeasureReport.category)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measurereport-category](/valueset-measurereport-category) The category of measure report instance this is (example codes include deqm, ra, vbp) - **[MeasureReport.messages](/measurereport-definitions#MeasureReport.messages)** [0..1]: Reference([OperationOutcome](/OperationOutcome)) Evaluation messages - **[MeasureReport.status](/measurereport-definitions#MeasureReport.status)** [1..1]: [code](/code) required:[measure-report-status](/valueset-measure-report-status) complete | pending | error - **[MeasureReport.type](/measurereport-definitions#MeasureReport.type)** [1..1]: [code](/code) required:[measure-report-type](/valueset-measure-report-type) individual | subject-list | summary | data-exchange - **[MeasureReport.dataUpdateType](/measurereport-definitions#MeasureReport.dataUpdateType)** [0..1]: [code](/code) required:[submit-data-update-type](/valueset-submit-data-update-type) incremental | snapshot - **[MeasureReport.measure](/measurereport-definitions#MeasureReport.measure)** [0..1]: [canonical](/canonical) What measure was calculated - **[MeasureReport.subject](/measurereport-definitions#MeasureReport.subject)** [0..1]: [Reference(CareTeam](/Reference(CareTeam), [Device](/Device), [Group](/Group), [HealthcareService](/HealthcareService), [Location](/Location), [Organization](/Organization), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [RelatedPerson)](/RelatedPerson)) What individual(s) the report is for - **[MeasureReport.date](/measurereport-definitions#MeasureReport.date)** [0..1]: [dateTime](/dateTime) When the measure report was generated - **[MeasureReport.reporter](/measurereport-definitions#MeasureReport.reporter)** [0..1]: [Reference(Practitioner](/Reference(Practitioner), [PractitionerRole](/PractitionerRole), [Organization)](/Organization)) Who is reporting the data - **[MeasureReport.reportingVendor](/measurereport-definitions#MeasureReport.reportingVendor)** [0..1]: Reference([Organization](/Organization)) What vendor prepared the data - **[MeasureReport.location](/measurereport-definitions#MeasureReport.location)** [0..*]: Reference([Location](/Location)) Where the reported data is from - **[MeasureReport.period](/measurereport-definitions#MeasureReport.period)** [1..1]: [Period](/Period) What period the report covers - **[MeasureReport.inputParameters](/measurereport-definitions#MeasureReport.inputParameters)** [0..1]: Reference([Parameters](/Parameters)) What parameters were provided to the report - **[MeasureReport.group](/measurereport-definitions#MeasureReport.group)** [0..*]: [BackboneElement](/BackboneElement) Measure results for each group - **[MeasureReport.group.linkId](/measurereport-definitions#MeasureReport.group.linkId)** [0..1]: [string](/string) Pointer to specific group from Measure - **[MeasureReport.group.title](/measurereport-definitions#MeasureReport.group.title)** [0..1]: [string](/string) Title of a group. Note- this value is copied from this element in Measure - **[MeasureReport.group.calculatedDate](/measurereport-definitions#MeasureReport.group.calculatedDate)** [0..1]: [dateTime](/dateTime) The date the Measure Report was calculated - **[MeasureReport.group.code](/measurereport-definitions#MeasureReport.group.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-group-example](/valueset-measure-group-example) Meaning of the group - **[MeasureReport.group.description](/measurereport-definitions#MeasureReport.group.description)** [0..1]: [markdown](/markdown) Summary description - **[MeasureReport.group.type](/measurereport-definitions#MeasureReport.group.type)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-type](/valueset-measure-type) process | outcome | structure | patient-reported-outcome - **[MeasureReport.group.subject](/measurereport-definitions#MeasureReport.group.subject)** [0..1]: [Reference(CareTeam](/Reference(CareTeam), [Device](/Device), [Group](/Group), [HealthcareService](/HealthcareService), [Location](/Location), [Organization](/Organization), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [RelatedPerson)](/RelatedPerson)) What individual(s) the report is for - **[MeasureReport.group.scoring](/measurereport-definitions#MeasureReport.group.scoring)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-scoring](/valueset-measure-scoring) What scoring method (e.g. proportion, ratio, continuous-variable) - **[MeasureReport.group.improvementNotation](/measurereport-definitions#MeasureReport.group.improvementNotation)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-improvement-notation](/valueset-measure-improvement-notation) increase | decrease - **[MeasureReport.group.improvementNotationGuidance](/measurereport-definitions#MeasureReport.group.improvementNotationGuidance)** [0..1]: [markdown](/markdown) Explanation of improvement notation - **[MeasureReport.group.population](/measurereport-definitions#MeasureReport.group.population)** [0..*]: [BackboneElement](/BackboneElement) The populations in the group - **[MeasureReport.group.population.linkId](/measurereport-definitions#MeasureReport.group.population.linkId)** [0..1]: [string](/string) Pointer to specific population from Measure - **[MeasureReport.group.population.title](/measurereport-definitions#MeasureReport.group.population.title)** [0..1]: [string](/string) Title of a group. Note- this value is copied from this element in Measure - **[MeasureReport.group.population.code](/measurereport-definitions#MeasureReport.group.population.code)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-population](/valueset-measure-population) initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation - **[MeasureReport.group.population.description](/measurereport-definitions#MeasureReport.group.population.description)** [0..1]: [markdown](/markdown) The human readable description of this population criteria - **[MeasureReport.group.population.count](/measurereport-definitions#MeasureReport.group.population.count)** [0..1]: [integer](/integer) Size of the population - **[MeasureReport.group.population.countQuantity](/measurereport-definitions#MeasureReport.group.population.countQuantity)** [0..1]: [Quantity](/Quantity) Size of the population as a quantity - **[MeasureReport.group.population.subjectResults](/measurereport-definitions#MeasureReport.group.population.subjectResults)** [0..1]: Reference([List](/List)) For subject-list reports, the subject results in this population - **[MeasureReport.group.population.subjectReport](/measurereport-definitions#MeasureReport.group.population.subjectReport)** [0..*]: Reference([MeasureReport](/MeasureReport)) For subject-list reports, references to the individual reports for subjects in this population - **[MeasureReport.group.population.subjects](/measurereport-definitions#MeasureReport.group.population.subjects)** [0..1]: Reference([Group](/Group)) What individual(s) in the population - **[MeasureReport.group.measureScore[x]](/measurereport-definitions#MeasureReport.group.measureScore%5Bx%5D)** [0..1]: [Quantity](/Quantity), [dateTime](/dateTime), [CodeableConcept](/CodeableConcept), [Period](/Period), [Range](/Range), [Duration](/Duration), [boolean](/boolean), [Ratio](/Ratio) What score this group achieved - **[MeasureReport.group.stratifier](/measurereport-definitions#MeasureReport.group.stratifier)** [0..*]: [BackboneElement](/BackboneElement) Stratification results - **[MeasureReport.group.stratifier.linkId](/measurereport-definitions#MeasureReport.group.stratifier.linkId)** [0..1]: [string](/string) Pointer to specific stratifier from Measure - **[MeasureReport.group.stratifier.title](/measurereport-definitions#MeasureReport.group.stratifier.title)** [0..1]: [string](/string) Title of a group's stratifier. Note- this value is copied from this element in Measure - **[MeasureReport.group.stratifier.code](/measurereport-definitions#MeasureReport.group.stratifier.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-stratifier-example](/valueset-measure-stratifier-example) What stratifier of the group - **[MeasureReport.group.stratifier.description](/measurereport-definitions#MeasureReport.group.stratifier.description)** [0..1]: [markdown](/markdown) The human readable description of this stratifier - **[MeasureReport.group.stratifier.stratum](/measurereport-definitions#MeasureReport.group.stratifier.stratum)** [0..*]: [BackboneElement](/BackboneElement) Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components - **[MeasureReport.group.stratifier.stratum.value[x]](/measurereport-definitions#MeasureReport.group.stratifier.stratum.value%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), [boolean](/boolean), [Quantity](/Quantity), [Range](/Range), [Reference](/Reference) example:[measurereport-stratifier-value-example](/valueset-measurereport-stratifier-value-example) The stratum value, e.g. male - **[MeasureReport.group.stratifier.stratum.component](/measurereport-definitions#MeasureReport.group.stratifier.stratum.component)** [0..*]: [BackboneElement](/BackboneElement) Stratifier component values - **[MeasureReport.group.stratifier.stratum.component.linkId](/measurereport-definitions#MeasureReport.group.stratifier.stratum.component.linkId)** [0..1]: [string](/string) Pointer to specific stratifier component from Measure - **[MeasureReport.group.stratifier.stratum.component.code](/measurereport-definitions#MeasureReport.group.stratifier.stratum.component.code)** [1..1]: [CodeableConcept](/CodeableConcept) example:[measure-stratifier-example](/valueset-measure-stratifier-example) What stratifier component of the group - **[MeasureReport.group.stratifier.stratum.component.description](/measurereport-definitions#MeasureReport.group.stratifier.stratum.component.description)** [0..1]: [markdown](/markdown) The human readable description of this stratifier component - **[MeasureReport.group.stratifier.stratum.component.value[x]](/measurereport-definitions#MeasureReport.group.stratifier.stratum.component.value%5Bx%5D)** [1..1]: [CodeableConcept](/CodeableConcept), [boolean](/boolean), [Quantity](/Quantity), [Range](/Range), [Reference](/Reference) example:[measurereport-stratifier-value-example](/valueset-measurereport-stratifier-value-example) The stratum component value, e.g. male - **[MeasureReport.group.stratifier.stratum.population](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population)** [0..*]: [BackboneElement](/BackboneElement) Population results in this stratum - **[MeasureReport.group.stratifier.stratum.population.linkId](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.linkId)** [0..1]: [string](/string) Pointer to specific population from Measure - **[MeasureReport.group.stratifier.stratum.population.code](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.code)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-population](/valueset-measure-population) initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation - **[MeasureReport.group.stratifier.stratum.population.count](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.count)** [0..1]: [integer](/integer) Size of the population - **[MeasureReport.group.stratifier.stratum.population.countQuantity](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.countQuantity)** [0..1]: [Quantity](/Quantity) Size of the population as a quantity - **[MeasureReport.group.stratifier.stratum.population.subjectResults](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.subjectResults)** [0..1]: Reference([List](/List)) For subject-list reports, the subject results in this population - **[MeasureReport.group.stratifier.stratum.population.subjectReport](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.subjectReport)** [0..*]: Reference([MeasureReport](/MeasureReport)) For subject-list reports, a subject result in this population - **[MeasureReport.group.stratifier.stratum.population.subjects](/measurereport-definitions#MeasureReport.group.stratifier.stratum.population.subjects)** [0..1]: Reference([Group](/Group)) What individual(s) in the population - **[MeasureReport.group.stratifier.stratum.measureScore[x]](/measurereport-definitions#MeasureReport.group.stratifier.stratum.measureScore%5Bx%5D)** [0..1]: [Quantity](/Quantity), [dateTime](/dateTime), [CodeableConcept](/CodeableConcept), [Period](/Period), [Range](/Range), [Duration](/Duration), [boolean](/boolean), [Ratio](/Ratio) What score this stratum achieved - **[MeasureReport.supplementalData](/measurereport-definitions#MeasureReport.supplementalData)** [0..*]: Reference([Resource](/Resource)) Additional information collected for the report - **[MeasureReport.evaluatedResource](/measurereport-definitions#MeasureReport.evaluatedResource)** [0..*]: Reference([Resource](/Resource)) What data was used to calculate the measure score ## Mappings - [MeasureReport Mappings](/measurereport-mappings) — 67 mapping entries ## Resource Packs ### list-MeasureReport-packs.xml ```xml ``` ## Search Parameters - [date](/measurereport-search#date) — **date** — The date of the measure report — `MeasureReport.date` - [evaluated-resource](/measurereport-search#evaluated-resource) — **reference** — An evaluated resource referenced by the measure report — `MeasureReport.evaluatedResource` - [identifier](/measurereport-search#identifier) — **token** — External identifier of the measure report to be returned — `MeasureReport.identifier` - [measure](/measurereport-search#measure) — **reference** — The measure to return measure report results for — `MeasureReport.measure` - [patient](/measurereport-search#patient) — **reference** — The identity of a patient to search for individual measure report results for — `MeasureReport.subject.where(resolve() is Patient)` - [period](/measurereport-search#period) — **date** — The period of the measure report — `MeasureReport.period` - [reporter](/measurereport-search#reporter) — **reference** — The reporter to return measure report results for — `MeasureReport.reporter` - [location](/measurereport-search#location) — **reference** — The location to return measure report results for — `MeasureReport.location` - [status](/measurereport-search#status) — **token** — The status of the measure report — `MeasureReport.status` - [subject](/measurereport-search#subject) — **reference** — The identity of a subject to search for individual measure report results for — `MeasureReport.subject` [Full Search Parameters](/measurereport-search) ## Examples - [788ca455-e11b1a59](/measurereport-example-788ca455-e11b1a59) — measurereport-788ca455-e11b1a59 — Example subject-list - [general-example-of-report](/measurereport-example-general-example-of-report) — measurereport-general-example — Example MeasureReport for a single patient - [hiv-indicators](/measurereport-example-hiv-indicators) — measurereport-hiv-indicators — Example MeasureReport for reporting public health data elements - [measurereport-cms146-cat1-example](/measurereport-example-measurereport-cms146-cat1-example) — measurereport-cms146-cat1-example — CMS 146 Individual Report - [measurereport-cms146-cat3-example](/measurereport-example-measurereport-cms146-cat3-example) — measurereport-cms146-cat3-example — CMS 146 Summary Report - [measurereport-example](/measurereport-example-measurereport-example) — measurereport-example - [measurereport-examples-header](/measurereport-example-measurereport-examples-header) — measurereport-examples-header [Full Examples](/measurereport-examples) ## Mapping Exceptions ### measurereport-fivews-mapping-exceptions.xml ### Unmapped Elements - **FiveWs.author** — Unknown - **FiveWs.actor** — Unknown - **FiveWs.cause** — Unknown - **FiveWs.version** — Unknown - **FiveWs.witness** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.why** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.done** — Unknown