# CQL Parameters - Using CQL With FHIR v3.0.0-ballot

## Resource Profile: CQL Parameters 

 
The CQL Parameters profile supports exchanging CQL parameters and evaluation results for FHIR operations, including $cql and the various $evaluate operations defined throughout FHIR Clinical Reasoning. The profile supports unambiguously identifying the type of CQL values that have been mapped to FHIR, as well as communicating empty lists, empty tuples, and null parameters or results using the data-absent-reason extension. 

**Usages:**

* Refer to this Profile: [CQL Group Result](StructureDefinition-cql-groupresult.md)
* Examples for this Profile: [Parameters/cql-parameters-example](Parameters-cql-parameters-example.md) and [Parameters/cql-typemappingexampleresult](Parameters-cql-typemappingexampleresult.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.uv.cql|current/StructureDefinition/StructureDefinition-cql-parameters.json)

### Formal Views of Profile Content

 [Description Differentials, Snapshots, and other representations](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](../StructureDefinition-cql-parameters.csv), [Excel](../StructureDefinition-cql-parameters.xlsx), [Schematron](../StructureDefinition-cql-parameters.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "cql-parameters",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 4
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "cds"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use"
  }],
  "url" : "http://hl7.org/fhir/uv/cql/StructureDefinition/cql-parameters",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.37.42.25"
  }],
  "version" : "3.0.0-ballot",
  "name" : "CQLParameters",
  "title" : "CQL Parameters",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-08-14T03:31:27+10:00",
  "publisher" : "HL7 International / Clinical Decision Support",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/dss"
    }]
  }],
  "description" : "The CQL Parameters profile supports exchanging CQL parameters and evaluation results for FHIR operations, including $cql and the various $evaluate operations defined throughout FHIR Clinical Reasoning. The profile supports unambiguously identifying the type of CQL values that have been mapped to FHIR, as well as communicating empty lists, empty tuples, and null parameters or results using the data-absent-reason extension.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "objimpl",
    "uri" : "http://hl7.org/fhir/object-implementation",
    "name" : "Object Implementation Information"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Parameters",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Parameters",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Parameters",
      "path" : "Parameters",
      "mustSupport" : false
    },
    {
      "id" : "Parameters.parameter",
      "path" : "Parameters.parameter",
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.extension:cqlType",
      "path" : "Parameters.parameter.extension",
      "sliceName" : "cqlType",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-cqlType"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.name",
      "path" : "Parameters.parameter.name",
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x]",
      "path" : "Parameters.parameter.value[x]",
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:null",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "null",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/data-absent-reason"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:null.valueCode",
      "path" : "Parameters.parameter.value[x].extension.valueCode",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "code"
      }],
      "fixedCode" : "unknown"
    },
    {
      "id" : "Parameters.parameter.value[x].extension:isEmptyList",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "isEmptyList",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-isEmptyList"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:isEmptyTuple",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "isEmptyTuple",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-isEmptyTuple"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:quantity-precision",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "quantity-precision",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/quantity-precision"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:time-precision",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "time-precision",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/time-precision"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Parameters.parameter.value[x].extension:time-hasOffset",
      "path" : "Parameters.parameter.value[x].extension",
      "sliceName" : "time-hasOffset",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/uv/cql/StructureDefinition/time-hasOffset"]
      }],
      "mustSupport" : true
    }]
  }
}

```
