---
title: "cloud-healthcare-fhir-patient-search"
type: docs
weight: 1
description: >
  A "cloud-healthcare-fhir-patient-search" tool searches for patients in a FHIR store.
aliases:
- /resources/tools/cloud-healthcare-fhir-patient-search
---

## About

A `cloud-healthcare-fhir-patient-search` tool searches for patients in a FHIR
store based on a set of criteria. It's compatible with the following sources:

- [cloud-healthcare](../../sources/cloud-healthcare.md)

`cloud-healthcare-fhir-patient-search` returns a list of patients that match the
given criteria.

## Example

```yaml
tools:
  fhir_patient_search:
    kind: cloud-healthcare-fhir-patient-search
    source: my-healthcare-source
    description: Use this tool to search for patients in the FHIR store.
```

## Reference

| **field**   | **type** | **required** | **description**                                    |
|-------------|:--------:|:------------:|----------------------------------------------------|
| kind        |  string  |     true     | Must be "cloud-healthcare-fhir-patient-search".    |
| source      |  string  |     true     | Name of the healthcare source.                     |
| description |  string  |     true     | Description of the tool that is passed to the LLM. |

### Parameters

| **field**        | **type** | **required** | **description**                                                                |
|------------------|:--------:|:------------:|--------------------------------------------------------------------------------|
| active           |  string  |    false     | Whether the patient record is active.                                          |
| city             |  string  |    false     | The city of the patient's address.                                             |
| country          |  string  |    false     | The country of the patient's address.                                          |
| postalcode       |  string  |    false     | The postal code of the patient's address.                                      |
| state            |  string  |    false     | The state of the patient's address.                                            |
| addressSubstring |  string  |    false     | A substring to search for in any address field.                                |
| birthDateRange   |  string  |    false     | A date range for the patient's birth date in the format YYYY-MM-DD/YYYY-MM-DD. |
| deathDateRange   |  string  |    false     | A date range for the patient's death date in the format YYYY-MM-DD/YYYY-MM-DD. |
| deceased         |  string  |    false     | Whether the patient is deceased.                                               |
| email            |  string  |    false     | The patient's email address.                                                   |
| gender           |  string  |    false     | The patient's gender.                                                          |
| addressUse       |  string  |    false     | The use of the patient's address.                                              |
| name             |  string  |    false     | The patient's name.                                                            |
| givenName        |  string  |    false     | A portion of the given name of the patient.                                    |
| familyName       |  string  |    false     | A portion of the family name of the patient.                                   |
| phone            |  string  |    false     | The patient's phone number.                                                    |
| language         |  string  |    false     | The patient's preferred language.                                              |
| identifier       |  string  |    false     | An identifier for the patient.                                                 |
| summary          | boolean  |    false     | Requests the server to return a subset of the resource. True by default.       |
| storeID          |  string  |    true*     | The FHIR store ID to search in.                                                |

*If the `allowedFHIRStores` in the source has length 1, then the `storeID`
parameter is not needed.
