We will be releasing an update to the ZAP Data Subscriptions API on 11/20/2023 to enhance the subscription process for a smoother, more flexible experience. (Read more)

Key Changes:

1. Dynamic Subscription Status:
   Previously, insufficient patient demographics led to subscription errors. Now, patients with incomplete information are allowed into the subscription package with a pending status. (Note: These patients are not considered active for invoicing purposes)

2. Automatic Activation:
   Once customers update patients with all required demographics, the subscription status automatically transitions to active. Seamlessly, data will begin flowing in for the patient.

3. Clear Guidance with Validation Codes:
   To facilitate quick corrections, we've implemented error codes that specify precisely which demographic fields require attention.

To Learn More:
Visit our updated documentation for a detailed guide on the new pending status, including error code references.

Happy Subscribing!

Users logging into the Zus App with a username and password will now have the option to use SMS-based two-factor authentication (2FA) as an alternative to an authenticator app. Users setting up 2FA for the first time will see both options. If you have already set up 2FA and would like to switch to SMS, please contact Zus Support.

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.

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

• Start a job - /patient-history/patient/{patient-id}/refresh
• Check the status of a job - /patient-history/message-status/{message-id}
• Get job messages - /patient-history/messages

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.

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

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].

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.

📰 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.

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.

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.