# Search Patients

> Perform Search Patients through ModMed.

Source: [https://genhealth.ai/docs/workflows/integrations/mod-med/modmed_search_patients](https://genhealth.ai/docs/workflows/integrations/mod-med/modmed_search_patients)

Integration: [ModMed](https://genhealth.ai/docs/workflows/integrations/mod-med.md)

- Handler: `modmed_search_patients`

- Connection type: `modmed`

## Inputs

- `term` — Term (expression, required)
  Required literal value or workflow expression.
- `page_size` — Page Size (number)
  Optional numeric value.
  Default: `25`

## Outputs

- `success` — Success
- `patients` — Patients
- `count` — Count
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `read`
- Confirmation recommended: no
- Retry safe: yes
- Dry run supported: no

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "page_size": {
      "type": "number",
      "default": 25,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "count": {},
    "error": {},
    "success": {},
    "patients": {}
  },
  "additionalProperties": true
}
```