🚧

Beta

This capability is in a stage of development that may be subject to change or deprecation and may not yet be feature complete or perform consistently.

What is a Lens?

A Lens is a set of FHIR resources derived from a patient’s raw resources that have been structurally normalized, de-duplicated, summarized, and tagged. Alongside Zus Data Enrichment, a Lens helps you extract signal quickly from raw data with just one API call.

Deduplication: Both Medications and Conditions are aligned based on their Zus-enriched codings and a single resource is written per unique medication or condition based on the patient’s history.

Structural Normalization: Medication data comes from four different FHIR resources: MedicationStatement, MedicationRequest, MedicationDispense, and MedicationAdministration. Zus aligns these various resources together based on their Zus-enriched codings and writes a single MedicationStatement per unique medication based on the Patient’s history. Conditions are inherently from a single resource type and are therefore already normalized.

Summarization: Zus summarizes the history for each unique medication or condition in a single resource, so you have one source for answering questions such as: “what was the last activity for this medication?” or “what is the current status?” Additionally, you may just want to present what is currently applicable and active for the patient today. Lenses help with both of these scenarios and you can access them simply by specifying the related tag of the Lens you want (see below).

Lens resources are created after Zus enriches newly created resources and are rewritten every time a new relevant resource is created with no work or intervention needed by you.

Medication Lenses

Summary Lens

The medication resources for a patient (i.e., MedicationStatement, MedicationRequest, MedicationDispense, and MedicationAdministration), are aligned and de-duplicated by common RxNorm (or their available CodeSystem if mapping to RxNorm was not possible). Zus then writes new Lens MedicationStatement resources with a specific tag for easy identification:

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

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

{{fhir_url}}/MedicationStatement?_tag=https://zusapi.com/summary|Common&patient.identifier={{universal_patient_id}}

Zus determines the value for each field in the summarized resource primarily based on the value on the raw resource with the latest real-world event date. This latest real-world event date is then used to populate the DateAsserted field of the summarized resource. The derivedFrom property on the Summary Lens resource references the resources the Summary Lens was compiled from. The status field is set to active for any Summary Lens that has activity within the last 180 days or 365 days into the future, and where the latest status among the raw resources is not one of: completed, entered-in-error, stopped, or not-taken.

Active Medication Lens

Active Medication Lenses are a subset of Summary Lenses that have a status of Active. The status is set to active for any Summary Lens that has activity within the last 180 days or 365 days into the future, and where the latest status among the raw resources is not completed, entered-in-error, stopped, or not-taken. This Lens helps answer the question: “What medications is this patient most likely on currently?”

Active Medication Lenses have the following tag:

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

Because Active Medication Lens resources are a subset of Summary Lenses, they also contain the summary tag.

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

{{fhir_url}}/MedicationStatement?_tag=https://zusapi.com/lens|ActiveMedications&patient.identifier={{universal_patient_id}}

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={{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={{universal_patient_id}}