---
title: "cloud-healthcare-search-dicom-studies"
type: docs
weight: 1
description: >
  A "cloud-healthcare-search-dicom-studies" tool searches for DICOM studies in a DICOM store.
aliases:
- /resources/tools/cloud-healthcare-healthcare-search-dicom-studies
---

## About

A `cloud-healthcare-search-dicom-studies` tool searches for DICOM studies in a DICOM store based on a
set of criteria. It's compatible with the following sources:

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

`cloud-healthcare-search-dicom-studies` returns a list of DICOM studies that match the given criteria.

## Example

```yaml
tools:
  search_dicom_studies:
    kind: cloud-healthcare-search-dicom-studies
    source: my-healthcare-source
    description: Use this tool to search for DICOM studies in the DICOM store.
```

## Reference

| **field**   | **type** | **required** | **description**                                    |
|-------------|:--------:|:------------:|----------------------------------------------------|
| kind        |  string  |     true     | Must be "cloud-healthcare-search-dicom-studies".   |
| 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**                                                                                                                                                                                                                                                                                                                                                               |
|------------------------|:--------:|:------------:|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| StudyInstanceUID       |  string  |    false     | The UID of the DICOM study.                                                                                                                                                                                                                                                                                                                                                   |
| PatientName            |  string  |    false     | The name of the patient.                                                                                                                                                                                                                                                                                                                                                      |
| PatientID              |  string  |    false     | The ID of the patient.                                                                                                                                                                                                                                                                                                                                                        |
| AccessionNumber        |  string  |    false     | The accession number of the study.                                                                                                                                                                                                                                                                                                                                            |
| ReferringPhysicianName |  string  |    false     | The name of the referring physician.                                                                                                                                                                                                                                                                                                                                          |
| StudyDate              |  string  |    false     | The date of the study in the format `YYYYMMDD`. You can also specify a date range in the format `YYYYMMDD-YYYYMMDD`.                                                                                                                                                                                                                                                          |
| fuzzymatching          | boolean  |    false     | Whether to enable fuzzy matching for patient names. Fuzzy matching will perform tokenization and normalization of both the value of PatientName in the query and the stored value. It will match if any search token is a prefix of any stored token. For example, if PatientName is "John^Doe", then "jo", "Do" and "John Doe" will all match. However "ohn" will not match. |
| includefield           | []string |    false     | List of attributeIDs to include in the output, such as DICOM tag IDs or keywords. Set to `["all"]` to return all available tags.                                                                                                                                                                                                                                              |
| storeID                |  string  |    true*     | The DICOM store ID to search in.                                                                                                                                                                                                                                                                                                                                              |

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