October 3, 2023

by Amna Hashmi

After careful consideration, we have decided to deprecate direct export to BigQuery for Zus data marts.

❄️ Builders can still access their data marts through Zus-provisioned Snowflake reader accounts or through secure data sharing if the Builder has their own Snowflake account.

September 28, 2023

by Amna Hashmi

The following patient history endpoints have been deprecated and are no longer actively maintained with updates, bug fixes, or support for issues.

On October 26, 2023, the above patient history endpoints will be completely shut down.

After this End of Life date, all requests to those endpoints will result in errors. Please ensure that you have migrated to the /patient-history/jobs API before this date to avoid disruptions to your service.

Why are we deprecating the /refresh, /message-status, and /messages endpoints?

We are deprecating Version 1 of the Patient History API to make way for significant improvements and enhancements with enrolling patients in a Zus subscription, as well as introduce new features like the ability to schedule a job for a future date.

How to migrate to the Patient History Jobs API

To ensure a smooth transition, we recommend the following steps:

  1. Review the API documentation to understand the changes and new features
    1. Product guide
    2. Release note and migration guide
    3. API documentation
    4. Postman collection
  2. Update your integration code to use the /patient-history/jobs endpoints and adapt to any changes in request and response formats.
  3. Test your updated integration in a development or staging environment to ensure it functions correctly with /patient-history/jobs.
  4. Once you are confident that your integration works with /patient-history/jobs, update your production environment before the End of Life date of October 26, 2023 to avoid any service disruptions.

Contact Us

If you have any questions or encounter any issues during the migration process, please do not hesitate to reach out to our support team at [email protected]. We are here to assist you and ensure a seamless transition.

We appreciate your continued support and cooperation as we work to provide you with the best possible service. Thank you for being a valued part of our API user community.

September 4, 2023

by Ada Glover

Zus has updated our Product Guide documentation to be more intuitively organized and reflect our latest product offering.

August 30, 2023

by Brian Marentay

New Data Source Available: Quest Diagnostics Lab Results We're excited to announce that patients in our ZAP Pro data subscription package can now receive lab result data through our integration with Quest Diagnostics. Derived from the world's largest database of clinical lab results, Quest annually serves one in three adult Americans and half the physicians and hospitals in the United States. This addition brings a comprehensive two-year lab history report upon enrollment, along with ongoing monitoring for new lab results.

Please note that activating Quest lab result data requires an initial configuration process. To get started, please reach out to your Zus representative or contact [email protected].

August 22, 2023

by Anusha Tomar

Zus now proactively labels all resources that may contain data relating to an HIV test, diagnosis, or medication, including data ingested from our data partners. Going forward, HIV-labeled resources that are written by Builders will automatically be withheld from responses to CommonWell and Carequality. For more information, see our documentation on specially regulated data.

August 8, 2023

by Amna Hashmi

📰 Clinical notes are now available in Data Marts. Data mart users can now analyze the narratives from sections of CDA documents (the standard format for clinical document exchange) through the text element of the DocumentReference resource type.

For example, suppose you want to identify which patients in your population have had clinical notes that contain mentions of an A1C test. The query below will retrieve an ordered result set.

select
    id,
    created_at,
    document_source,
    type,
    category,
    description,
    universal_patient_identifier,
    document_date,
    text_div,
    text_status,
    context_period_start,
    context_period_end
from documentreference
where lower(text_div) like '%a1c%'
order by universal_patient_identifier, created_at

Known Issues

The clinical notes parsing has a few known issues:

  • The text element often contains HTML, such as
    <div xmlns="http://www.w3.org/1999/xhtml"><ul><li><span>Formatting of this note might be different from the original.</span><br />
  • Clinical notes from CDA document sections are available from May 2023 onwards.

August 4, 2023

by Max Tabachnik

The Timeline component has been replaced with a new Encounters & Notes component which surfaces encounters and associated clinical notes (where available). The component list view shows the titles of available clinical notes for each encounter. Diagnostic reports can still be viewed in the Diagnostics component.

August 2, 2023

by Brian Marentay

We are excited to announce the addition of a new data source that will help provide a more comprehensive view of a patient's medical history. Upon initial enrollment in the ZAP Pro package, patients will now receive "Get Up To Speed" results that include a lookback report on previous inpatient and emergency encounters over a two-year period from health systems within the Collective Medical network. These results will contain essential information such as location, admit and discharge dates, and associated diagnoses for each recent hospital stay.

July 30th, 2023

by Brian Marentay

We are excited to introduce the "Intelligent Refresh" feature for patients in a ZAP Lite or ZAP Pro subscription package. Now, we will automatically search for and update clinical documents within a patient's ZAP after two key clinical events. (click for more!)

Appointment Preparation: Just before the start of any of your upcoming appointments written to Zus, we will initiate a refresh to ensure your clinical history is up-to-date, giving you a complete picture of your patient's health.

Post-Discharge Follow-up: After receiving an ADT discharge, we will refresh EHR documents to capture follow-up documentation from recent hospital stays.

We hope this update will enhance the accuracy and completeness of your patient records, empowering you with better insights for delivering quality care.

July 28, 2023

by Max Tabachnik

The Diagnostic component now indicates which diagnostic reports have historical lab trend data. Trending is now available for lipid panel results (HDL, LDL, total cholesterol, and triglycerides) and is also now available to all Builders.