periodStart* | date | 1..1 | The start of a [gaps through period](glossary.html). This may be the start of the measurement period defined by a measure, or a customized desired performance period start date determined by a payer, a provider, a measure program, and etc. |
periodEnd* | date | 1..1 | The end of a [gaps through period](glossary.html) (the gaps through date). The gaps through date could be a past date or a future date. For example, today's date is 2020-06-18, 1) if periodEnd date is 2020-09-30, it returns gaps through 2020-09-30, and 2) if the periodEnd date is 2020-05-31, it returns gaps through 2020-05-31. |
topic | string | 0..* | The category of the measures that is of interest for the care gaps report. This references the [topic](https://www.hl7.org/fhir/measure-definitions.html#Measure.topic) element in the [Measure](https://www.hl7.org/fhir/measure.html) resource. Examples of topic may be screening measures, HEDIS measure domains, chronic disease measures. For example, setting topic to be a screening caregory will run care gaps on all screening measures. Topic may also be a "value set" that is defined with a list of domains/categories, etc. Topic examples: "screening", "pediatric". When multiple topics are provided, it is expected to be union of measures in those topics. Note that the type of this parameter is a string with a search type of [token](https://www.hl7.org/fhir/search.html#token), so the $care-gaps operation has only simple input parameters and may be invoked using GET. |
subject | string | 0..1 | Subject will be a reference to either Patient [QI Core Patient](http://hl7.org/fhir/us/qicore/StructureDefinition/qicore-patient) or Group [DEQM Gaps In Care Group Profile](StructureDefinition-gaps-group-deqm.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. |
subjectGroup | Group | 0..1 | Subject for which the gaps in care report will be created is provided as a Group resource. |
parameters | Parameters | 0..1 | Any input parameters for the Measure evaluation. If the measure uses CQL, the parameter types are mapped to CQL as specified in the Parameters and Data Requirements section of the Using CQL with FHIR Implementation Guide. Any parameters defined in this input will be bound by name to parameters defined in the logic library referenced from library element of the Measure. If a parameter appears more than once in the input Parameters resource, it is represented with a List in the input CQL. If a parameter has parts, it is represented as a Tuple in the input CQL. |
practitioner | string | 0..1 | Reference to a practitioner [QI Core Practitioner](https://hl7.org/fhir/us/qicore/StructureDefinition-qicore-practitioner.html) for which the gaps in care report will be created. For a practitioner focused gaps in care report, this is a required In Parameter. The Server needs to make sure that practitioner is authorized to get the gaps in care report for and know what measures the practitioner are eligible or qualified. |
organization | string | 0..1 | Reference to an organization [QI Core Organization](http://hl7.org/fhir/us/qicore/StructureDefinition/qicore-organization) for which the gaps in care report will be created. Either 'organization' or 'organizationResource' SHALL be provided, but not both |
organizationResource | Organization | 0..1 | Organization for which the gaps in care report will be created is provided as an Organization resource. Either 'organization' or 'organizationResource' SHALL be provided, but not both. |
status* | code binding: extensible | 1..* | Indicates status of a care gap. For all [open, closed, and prospective gaps], three seperate status parameters must be provided. For a positive proportion measure, gap means the patient is not in the numerator. For an inverse (negative) proportion measure (e.g., Diabetes: Hemoglobin A1c (HbA1c) Poor Control (> 9%)), gap means the patient is in the numerator. |
measureId | id | 0..* | The id of a Measure resource that is on the server for which the gaps in care report will be created. E.g., the id of the Measure resource for Breast Cancer Screening measure. |
measureIdentifier | string | 0..* | The business identifier of a measure for which the gaps in care will be reported. E.g., CMS125 is a CMS assigned identifier for the Breast Cancer Screening eCQM in their system. Note that the type of this parameter is a string with a search type of [token](https://www.hl7.org/fhir/search.html#token), so the $care-gaps operation has only simple input parameters and may be invoked using GET. |
measureUrl | canonical | 0..* | The URL of a measure for which the gaps in care report will be created. A measure URL is specified in the [url](https://www.hl7.org/fhir/measure-definitions.html#Measure.url) element of the Measure resource. The measure URL remains the same when the measure is stored on different servers. |
measureResource | Measure | 0..* | The measure for which the gaps in care report will be created is provided as a Measure resource. |
measure | string | 0..* | The measure for which the gaps in care report will be created. This parameter is only required when the operation is invoked on the resource type, it is not used when invoking the operation on a Measure instance |
manifest | canonical | 0..1 | Specifies an asset-collection library that provides dependency version resolution and expansion rules for the operation. See the description of manifest in the Canonical Resource Management Infrastructure IG for a complete description of how manifest values are used to provide defaults for dependency version resolution and expansion parameters. Parameters specified directly in the operation override behaviors specified by the manifest parameter. In general, if this parameter is supplied, it is expected to be used in nested operation calls. For example, in evaluating a measure, if the expansion of a value set is required, this parameter SHALL be supplied to that expansion. |
isDocument | boolean | 0..1 | The isDocument parameter controls whether a Gaps in Care Composition is returned in the Bundle (i.e. if the Bundle is of type 'Document'). When 'true,' the returned Bundles contain the Gaps in Care Composition. This parameter defaults to 'true.' |