FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.us.davinci-ra
Resource TypeOperationDefinition
IdOperationDefinition-risk-gap.json
FHIR VersionR4
Sourcehttps://build.fhir.org/ig/HL7/davinci-ra/OperationDefinition-risk-gap.html
URLhttp://hl7.org/fhir/us/davinci-ra/OperationDefinition/risk-gap
Version2.1.0
Statusdraft
Date2026-01-08T19:05:50+00:00
NameRiskGap
TitleRisk Gap
Realmus
Authorityhl7
DescriptionThe risk-gap operation is used to determine condition Category (CC) gaps for a patient/member.
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition risk-gap

URL: [base]/MeasureReport/$risk-gap

URL: [base]/MeasureReport/[id]/$risk-gap

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INperiodStart1..1date

The start of a clinical evaluation period.

INperiodEnd1..1date

The end of a clinical evaluation period.

INsubject1..1Reference (US Core Patient Profile)

A reference to Patient resource as input parameter, which provides data such as patient's first name, last name, date of birth

INcoverage1..1Reference (US Core Coverage Profile)

A reference to Coverage resource, which provides information such as the subscriberId

INTIN0..1string
(token)

This is the provider rganization's TIN

INccType0..*codeCondition Category Type (Extensible)

This Condition Category (CC) gaps will be filterd based on the CC type code, whether it is suspected, historic, and/or net-new.

INevidenceStatus0..*codeEvidence Status (Extensible)

This Condition Category (CC) gaps will be filterd based on the evidence status, whether the gap is an open-gap, invalid-gap, closed-gap, and/or pending.

INproviderTaxonomy0..*codeProviderTaxonomy (Extensible)

This Condition Category (CC) gaps will be filterd based on provider taxonomy.

INencounter0..1Reference (US Core Encounter Profile)

A reference to Encounter resource, which provides information such as the encounter id and date of service.

INdata1..1Bundle

Referenced resources by parameters of this operation provided as a Bundle.

OUTreturn0..1Bundle

This operation returns a Bundle of MeasureReports and associated resources.


Source1

{
  "resourceType": "OperationDefinition",
  "id": "risk-gap",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 1
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "cqi"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "draft"
    }
  ],
  "url": "http://hl7.org/fhir/us/davinci-ra/OperationDefinition/risk-gap",
  "version": "2.1.0",
  "name": "RiskGap",
  "title": "Risk Gap",
  "status": "draft",
  "kind": "operation",
  "date": "2026-01-08T19:05:50+00:00",
  "publisher": "HL7 International / Clinical Quality Information",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/cqi"
        }
      ]
    }
  ],
  "description": "The risk-gap operation is used to determine condition Category (CC) gaps for a patient/member.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "US",
          "display": "United States of America"
        }
      ]
    }
  ],
  "code": "risk-gap",
  "resource": [
    "MeasureReport"
  ],
  "system": false,
  "type": true,
  "instance": true,
  "parameter": [
    {
      "name": "periodStart",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The start of a clinical evaluation period.",
      "type": "date"
    },
    {
      "name": "periodEnd",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The end of a clinical evaluation period.",
      "type": "date"
    },
    {
      "name": "subject",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "A reference to Patient resource as input parameter, which provides data such as patient's first name, last name, date of birth",
      "type": "Reference",
      "targetProfile": [
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient|7.0.0"
      ]
    },
    {
      "name": "coverage",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "A reference to Coverage resource, which provides information such as the subscriberId",
      "type": "Reference",
      "targetProfile": [
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-coverage|7.0.0"
      ]
    },
    {
      "name": "TIN",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "This is the provider rganization's TIN",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "ccType",
      "use": "in",
      "min": 0,
      "max": "*",
      "documentation": "This Condition Category (CC) gaps will be filterd based on the CC type code, whether it is suspected, historic, and/or net-new.",
      "type": "code",
      "binding": {
        "strength": "extensible",
        "valueSet": "http://hl7.org/fhir/us/davinci-ra/ValueSet/cc-type"
      }
    },
    {
      "name": "evidenceStatus",
      "use": "in",
      "min": 0,
      "max": "*",
      "documentation": "This Condition Category (CC) gaps will be filterd based on the evidence status, whether the gap is an open-gap, invalid-gap, closed-gap, and/or pending.",
      "type": "code",
      "binding": {
        "strength": "extensible",
        "valueSet": "http://hl7.org/fhir/us/davinci-ra/ValueSet/evidence-status"
      }
    },
    {
      "name": "providerTaxonomy",
      "use": "in",
      "min": 0,
      "max": "*",
      "documentation": "This Condition Category (CC) gaps will be filterd based on provider taxonomy.",
      "type": "code",
      "binding": {
        "strength": "extensible",
        "valueSet": "http://hl7.org/fhir/ValueSet/provider-taxonomy"
      }
    },
    {
      "name": "encounter",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "A reference to Encounter resource, which provides information such as the encounter id and date of service.",
      "type": "Reference",
      "targetProfile": [
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter|7.0.0"
      ]
    },
    {
      "name": "data",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "Referenced resources by parameters of this operation provided as a Bundle.",
      "type": "Bundle"
    },
    {
      "name": "return",
      "use": "out",
      "min": 0,
      "max": "1",
      "documentation": "This operation returns a Bundle of MeasureReports and associated resources.",
      "type": "Bundle"
    }
  ]
}