# List Patients

> Perform List Patients through React Health.

Source: [https://genhealth.ai/docs/workflows/integrations/react-health/reacthealth_list_patients](https://genhealth.ai/docs/workflows/integrations/react-health/reacthealth_list_patients)

Integration: [React Health](https://genhealth.ai/docs/workflows/integrations/react-health.md)

- Handler: `reacthealth_list_patients`

- Connection type: `reacthealth`

## Inputs

- `page` — Page (number, required)
  Required numeric value.
  Default: `1`
- `limit` — Limit (number, required)
  Required numeric value.
  Default: `50`
- `order_by` — Order By (select)
  Optional selected identifier or value.
  Default: `"therapy_start"`
  Options: Therapy Start ("therapy_start"), Name ("name"), Birth Date ("birth_date"), Created Date ("created"), Patient ID ("assigned_id"), Days on Service ("therapy_days"), Location ("org_location_name"), City / State ("city_state")
- `order_direction` — Order Direction (select)
  Optional selected identifier or value.
  Default: `"desc"`
  Options: Ascending ("asc"), Descending ("desc")
- `first_name` — First Name (expression)
  Optional literal value or workflow expression.
- `last_name` — Last Name (expression)
  Optional literal value or workflow expression.
- `birth_date` — Birth Date (date)
  Optional date in YYYY-MM-DD format.
- `patient_id` — Patient Id (expression)
  Optional literal value or workflow expression.
- `serial_number` — Serial Number (expression)
  Optional literal value or workflow expression.
- `active` — Active (select)
  Optional selected identifier or value.
  Options: All (""), Active ("1"), Inactive ("0")
- `compliance` — Compliance (expression)
  Optional literal value or workflow expression.
- `organization` — Organization (expression)
  Optional literal value or workflow expression.
- `location` — Location (expression)
  Optional literal value or workflow expression.
- `group` — Group (expression)
  Optional literal value or workflow expression.
- `clinician` — Clinician (expression)
  Optional literal value or workflow expression.
- `date_type` — Date Type (select)
  Optional selected identifier or value.
  Default: `"created"`
  Options: Created Date ("created"), Therapy Start ("therapy_start")
- `date_start` — Date Start (date)
  Optional date in YYYY-MM-DD format.
- `date_end` — Date End (date)
  Optional date in YYYY-MM-DD format.

## Outputs

- `success` — Success
- `patients` — Patients
- `count` — Count
- `current_page` — Current Page
- `last_page` — Last Page
- `per_page` — Per Page
- `total` — Total
- `first_result_index` — First Result Index
- `last_result_index` — Last Result Index
- `next_page_url` — Next Page Url
- `prev_page_url` — Prev Page Url
- `truncated` — Truncated
- `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": [
    "page",
    "limit"
  ],
  "properties": {
    "page": {
      "type": "number",
      "default": 1,
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    },
    "group": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    },
    "active": {
      "enum": [
        "",
        "1",
        "0"
      ],
      "type": "string",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "date_end": {
      "type": "string",
      "format": "date",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "location": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "order_by": {
      "enum": [
        "therapy_start",
        "name",
        "birth_date",
        "created",
        "assigned_id",
        "therapy_days",
        "org_location_name",
        "city_state"
      ],
      "type": "string",
      "default": "therapy_start",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "clinician": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "date_type": {
      "enum": [
        "created",
        "therapy_start"
      ],
      "type": "string",
      "default": "created",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "last_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "birth_date": {
      "type": "string",
      "format": "date",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "compliance": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "date_start": {
      "type": "string",
      "format": "date",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "first_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "patient_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "organization": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "serial_number": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "order_direction": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "count": {},
    "error": {},
    "total": {},
    "success": {},
    "patients": {},
    "per_page": {},
    "last_page": {},
    "truncated": {},
    "current_page": {},
    "next_page_url": {},
    "prev_page_url": {},
    "last_result_index": {},
    "first_result_index": {}
  },
  "additionalProperties": true
}
```