# Find Patients

> Perform Find Patients through NikoHealth.

Source: [https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_find_patients](https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_find_patients)

Integration: [NikoHealth](https://genhealth.ai/docs/workflows/integrations/nikohealth.md)

- Handler: `nikohealth_find_patients`

- Connection type: `nikohealth`

## Inputs

- `lookback_hours` — Lookback Hours (number)
  Optional numeric value.
- `created_from` — Created From (expression)
  Optional literal value or workflow expression.
- `created_to` — Created To (expression)
  Optional literal value or workflow expression.
- `timezone` — Timezone (text)
  Optional text value.
  Default: `"America/Chicago"`
- `page_size` — Page Size (number)
  Optional numeric value.
  Default: `100`
- `max_pages` — Max Pages (number)
  Optional numeric value.
  Default: `50`
- `record_limit` — Record Limit (number)
  Optional numeric value.
- `sort_expression` — Sort Expression (text)
  Optional text value.
  Default: `"FullName ASC"`
- `tag_ids` — Tag Ids (expression)
  Optional literal value or workflow expression.
- `tag_names` — Tag Names (expression)
  Optional literal value or workflow expression.
- `exclude_tag_ids` — Exclude Tag Ids (expression)
  Optional literal value or workflow expression.
- `exclude_tag_names` — Exclude Tag Names (expression)
  Optional literal value or workflow expression.

## Outputs

- `success` — Success
- `patients` — Patients
- `count` — Count
- `excluded_by_tag_count` — Excluded By Tag Count
- `unknown_tags` — Unknown Tags
- `truncated_by_record_limit` — Truncated By Record Limit
- `pages_fetched` — Pages Fetched
- `truncated_by_page_cap` — Truncated By Page Cap
- `window_source` — Window Source
- `created_from` — Created From
- `created_to` — Created To
- `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",
  "properties": {
    "tag_ids": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "timezone": {
      "type": "string",
      "default": "America/Chicago",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "max_pages": {
      "type": "number",
      "default": 50,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "page_size": {
      "type": "number",
      "default": 100,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "tag_names": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "created_to": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "created_from": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "record_limit": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "lookback_hours": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "exclude_tag_ids": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "sort_expression": {
      "type": "string",
      "default": "FullName ASC",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "exclude_tag_names": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "count": {},
    "error": {},
    "success": {},
    "patients": {},
    "created_to": {},
    "created_from": {},
    "unknown_tags": {},
    "pages_fetched": {},
    "window_source": {},
    "excluded_by_tag_count": {},
    "truncated_by_page_cap": {},
    "truncated_by_record_limit": {}
  },
  "additionalProperties": true
}
```