---
updatedAt: 2026-10-28T21:44:28.000Z
agentTools:
  projectIndex: https://docs.zushealth.com/llms.txt
---

# One Time Querying Patients

Run a one-time Patient History query to pull a patient's network data without subscribing.

If you prefer to control when you pull patient data, and not subscribe, Zus allows for one time querying to fetch the latest information on patients.

The flow for one time querying of patients is as follows:

* Seed your patient with Zus connected network data as described <a href="https://www.postman.com/zus-health/workspace/zus-health-workspace/request/23503392-52e5ee28-d3d5-4fea-a184-b87b9c2a5d8d" target="_blank"> here</a>. Zus will do the heavy lifting of searching our networks for patient matches, pulling documents from responding organizations and translating them to FHIR resources for you. See [Patient Monitoring & Chart Builds](https://docs.zushealth.com/docs/patient-monitoring-chart-builds).

> 📘 Be sure to pass the Patient id from the previous response when creating the patient in the payload body \{\{ZusPID}}!

* When one time querying patients for the first time the CPR (Common Patient Record) functionality comes into effect. Meaning, if other Zus customers are also treating the same patient, you are able to view their data instantly.
* The querying of your patient data takes on the order of seconds to minutes. Some network responses take longer, and Carequality retrieval can stay in progress for hours as Zus paces and retries each responding organization. While you're waiting for data to populate you can always check the status of your patient history call by executing the patient-history jobs request as described <a href="https://www.postman.com/zus-health/workspace/zus-health-workspace/request/23503392-aeee92ca-206c-48c3-99b7-0b556647de4f" target="_blank">here</a>.

> 👍 You can always check what data we've pulled on your patient by viewing them within [FHIRplace](https://fhirplace.sandbox.zusapi.com/#/Patient) and the  [Zus Application](https://app.sandbox.zushealth.com/patients)!

Follow along!

<HTMLBlock>{`
<div style="position: relative; padding-bottom: 62.5%; height: 0;"><iframe src="https://www.loom.com/embed/ae4f041bfa8a4d54924a4ccedf6d7675" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
`}</HTMLBlock>

## Related pages

* [Developer Quickstart](https://docs.zushealth.com/docs/quickstart-guide)
* [Subscribing Patients](https://docs.zushealth.com/docs/subscribing-patients)
* [Writing Data Back to Zus](https://docs.zushealth.com/docs/writing-data-back-to-zus)