Skip to main content

​
clinik.measureReports

Measure Reports (FHIR MeasureReport) contain the results of evaluating a measure against a population or individual patient.

​
create

const { data, meta } = await clinik.measureReports.create(request): Promise<ApiResponse<MeasureReport>>
FieldTypeRequiredDescription
statusstringYescomplete, pending, error
typestringYesindividual, subject-list, summary, data-collection
measureIdstringYesMeasure reference (canonical URL or ID)
patientIdstringNoPatient ID
datestringNoReport date (defaults to now)
reporterIdstringNoReporter (Practitioner/Organization ID)
periodobjectYesReporting period
period.startstringYesPeriod start
period.endstringYesPeriod end
groupArrayNoReport groups
group[].codestringNoGroup code
group[].populationArrayNoPopulation results
group[].population[].codestringNoPopulation code
group[].population[].countnumberNoPopulation count
group[].measureScoreobjectNoMeasure score
group[].measureScore.valuenumberYesScore value
group[].measureScore.unitstringNoScore unit

​
Example

const { data } = await clinik.measureReports.create({
  status: 'complete',
  type: 'summary',
  measureId: 'diabetes-hba1c-control',
  period: { start: '2024-01-01', end: '2024-03-31' },
  reporterId: 'org_clinic789',
  group: [{
    code: 'initial-population',
    population: [
      { code: 'initial-population', count: 500 },
      { code: 'denominator', count: 480 },
      { code: 'numerator', count: 72 },
    ],
    measureScore: { value: 0.15, unit: '%' },
  }],
});
Same pattern as other resources. Update supports status. Search supports patientId, status, measureId, dateFrom, dateTo filters.