MeasureReport — Quality-measure report
A Measure has been evaluated against a population: MeasureReport carries the result (numerator, denominator, score, exclusions). Quality-reporting pivot.
Purpose
MeasureReport is the structured result of a Measure execution. Three modes: individual (1 patient), summary (aggregate), subject-list (detail list). Used by CMS for HEDIS/eCQM, ANAP for French IFAQ indicators.
Key fields
| Field | Type | Cardinality | Role |
|---|---|---|---|
status | code | 1..1 | complete, pending, error. |
type | code | 1..1 | individual, subject-list, summary, data-collection. |
measure | canonical(Measure) | 1..1 | Evaluated Measure URL. |
subject | Reference(Patient | Group | ...) | 0..1 | Subject if individual. |
date | dateTime | 0..1 | Generation date. |
reporter | Reference(Practitioner | Organization | ...) | 0..1 | Reporting entity. |
period | Period | 1..1 | Measurement period. |
group | BackboneElement[] | 0..* | Population groups + scores. |
JSON example
HbA1c control report for one patient:
{
"resourceType": "MeasureReport",
"id": "example",
"status": "complete",
"type": "summary",
"measure": "http://hl7.org/fhir/Measure/diabetes-hba1c-control",
"subject": { "reference": "Patient/example" },
"date": "2026-05-16",
"reporter": { "reference": "Organization/clinic" },
"period": { "start": "2026-01-01", "end": "2026-12-31" },
"group": [{
"id": "diabetes-control",
"population": [{
"code": { "coding": [{ "code": "initial-population" }] },
"count": 1
}, {
"code": { "coding": [{ "code": "numerator" }] },
"count": 1
}],
"measureScore": { "value": 1, "unit": "%" }
}]
}Common pitfalls
- period missing: the measure is not temporally comparable.
- non-canonical measure: must point to a published Measure (canonical URL).
- numerator > denominator: logic error to validate at generator level.
Related resources
- Measure — The executed measure.
- Library — CQL evaluation library.
- Group — Targeted cohort.
- QuestionnaireResponse — Patient data feeding the measure.