Condition Lenses

Summary Lens

The Condition resources of a patient are aligned and de-duplicated by common SNOMED CT (or the available CodeSystem if mapping to SNOMED CT is not available). Zus creates these new, de-duplicated Conditions Summary resources with the following tag:

"meta": {
    "tag": [
        {
            "system": "https://zusapi.com/summary",
            "code": "Common"  
        }
    ]
}

You can query for a patient's Condition Summary Lens resources by filtering on the tag, as shown below:

{{fhir_url}}/Condition?_tag=https://zusapi.com/summary|Common&patient.identifier=https://zusapi.com/fhir/identifier/universal-id|{{universal_patient_id}}

Zus determines the value for each field in the Summary Lens resource primarily based on the value on the raw resource with the latest real-world event date.

Chronic Conditions Lens

Chronic Conditions are a subset of Conditions Summary Lenses that have an enriched Chronic Conditions Indicator (CCI) value of β€œChronic”, β€œBoth”, or null (i.e., if there is no mapping from the coding to CCI value). This Lens informs care team users about what chronic problems their patients are most likely currently dealing with. You can find the enriched CCI value in a Condition resource codeable concept in the following extension:

{  
  "extension": [  
    {  
      "url": "<https://zusapi.com/terminology/enrichment>",  
      "valueString": "CCI"  
    }  
  ],  
  "system": "<http://www.hcupus.ahrq.gov/toolssoftware/chronic_icd10/chronic_icd10.jsp>",  
  "code": "C",  
  "display": "Chronic",  
  "userSelected": false  
}

Chronic Conditions Lens resources have the following tag:

"meta": {
    "tag": [
        {
            "system": "https://zusapi.com/lens",
            "code": "ChronicConditions"
        }
    ]
}

Since Condition Lens resources are a subset of Summary Lenses, they also contain the summary tag

You can query for a patient's Chronic Conditions Lens resources by filtering on the tag, as shown below:

{{fhir_url}}/Condition?_tag=https://zusapi.com/lens|ChronicConditions&patient.identifier=https://zusapi.com/fhir/identifier/universal-id|{{universal_patient_id}}

Data Mart Access

Condition Lens data is available in the following tables: