{
  "description": "The `$hddt-cgm-summary` operation is defined on the *Observation* resource type.  \\nIt allows clients to request CGM summary data filtered by effective period, and optionally include related device context (Device, DeviceMetric).  \\n\\n**Use cases supported by this operation include:**  \\n- Retrieving CGM summary statistics (mean glucose, time-in-range, GMI, etc.) for a patient over a specified interval  \\n\\n**Input Parameters:**  \\n- `effectivePeriodStart` *(dateTime, optional)*: Lower bound of the observation effective period.  \\n- `effectivePeriodEnd` *(dateTime, optional)*: Upper bound of the observation effective period.  \\n- `related` *(boolean, optional)*: If true, the response bundle also contains related Device and DeviceMetric resources.  \\n\\n**Output Parameter:**  \\n- `result` *(Reference, required)*: A Bundle conforming to profile `HddtCgmSummary` profile containing all matching CGM Observations and, if requested, their related devices.  \\n\\n**Error handling (OperationOutcome):**  \\n- `MSG_PARAM_UNKNOWN`: Returned when an unsupported input parameter is used.  \\n- `MSG_PARAM_INVALID`: Returned when a parameter value is invalid (e.g., bad date format).  \\n- `MSG_NO_MATCH`: Returned when no matching observations are found. \\n- `MSG_BAD_SYNTAX`: Returned when the request is malformed.  ",
  "_filename": "OperationDefinition-hddt-cgm-summary-operation.json",
  "package_name": "de.gematik.hddt",
  "date": "2026-04-29",
  "system": false,
  "publisher": "gematik GmbH",
  "instance": false,
  "name": "HddtCgmSummaryOperation",
  "type": "true",
  "experimental": "false",
  "resourceType": "OperationDefinition",
  "title": "Search Operation for summary data measurement",
  "package_version": "1.0.1",
  "status": "active",
  "id": "de7e3363-496c-4686-a56d-3c49a294745e",
  "affectsState": false,
  "kind": "operation",
  "url": "https://gematik.de/fhir/hddt/OperationDefinition/hddt-cgm-summary-operation",
  "code": "hddt-cgm-summary",
  "version": "1.0.1",
  "parameter": [ {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "effectivePeriodStart",
    "type": "dateTime",
    "documentation": "Start of effective period"
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "effectivePeriodEnd",
    "type": "dateTime",
    "documentation": "End of effective period"
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "related",
    "type": "boolean",
    "documentation": "If true, include related Device and DeviceMetric in the result bundle"
  }, {
    "max": "1",
    "min": 1,
    "use": "out",
    "name": "result",
    "type": "Reference",
    "documentation": "Result bundle (HTTP 200 OK) containing summary data of measurements and optionally related resources",
    "targetProfile": [ "https://gematik.de/fhir/hddt/StructureDefinition/hddt-cgm-summary" ]
  } ]
}