query_patients
Search for patients in a DICOM network by providing optional criteria such as patient ID or birth date, and customize which attributes are returned.
Instructions
Query patients matching the specified criteria from the DICOM node.
This tool performs a DICOM C-FIND operation at the PATIENT level to find patients matching the provided search criteria. All search parameters are optional and can be combined for more specific queries.
Args: patient_id: Patient ID to search for, e.g., "12345678" birth_date: Patient birth date in YYYYMMDD format, e.g., "19700101" attribute_preset: Controls which attributes to include in results: - "none": No attributes, use with additional_attributes (default) - "custom": Our custom attributes additional_attributes: List of specific DICOM attributes to include beyond the preset exclude_attributes: List of DICOM attributes to exclude from the results
Returns: Dictionary containing: - success: Boolean indicating if the query completed without failure - results: List of matched patient records - dicom_statuses: List of DICOM status entries - warnings: List of warning entries - error: Optional error dictionary
Example: { "success": true, "results": [ { "PatientID": "12345", "PatientBirthDate": "19700101", "PatientSex": "M" } ], "dicom_statuses": [{"code": "0x0000", "category": "success"}], "warnings": [], "error": null }
Notes: Returns success False if the query fails.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| patient_id | No | ||
| birth_date | No | ||
| attribute_preset | No | none | |
| additional_attributes | No | ||
| exclude_attributes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |