# Search SO Worklist

> Perform Search SO Worklist through Brightree.

Source: [https://genhealth.ai/docs/workflows/integrations/brightree/brightree_search_so_worklist](https://genhealth.ai/docs/workflows/integrations/brightree/brightree_search_so_worklist)

Integration: [Brightree](https://genhealth.ai/docs/workflows/integrations/brightree.md)

- Handler: `brightree_search_so_worklist`

- Connection type: `brightree`

## Inputs

- `wip_states` — Wip States (multi_select, dynamic options)
  Optional list of selected values. Retrieve allowed values from the dynamic options endpoint.
- `page` — Page (number)
  Optional numeric value.
  Default: `1`
- `fetch_all` — Fetch All (boolean)
  Optional true-or-false value.
  Default: `false`
- `include_unassigned` — Include Unassigned (boolean)
  Optional true-or-false value.
  Default: `false`
- `sort_by_time_in_wip` — Sort By Time In Wip (boolean)
  Optional true-or-false value.
  Default: `false`
- `actual_delivery_date_to` — Actual Delivery Date To (string)
  Optional text value.

## Outputs

- `orders` — Orders

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": {
    "page": {
      "type": "number",
      "default": 1,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "fetch_all": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "wip_states": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of selected values. Retrieve allowed values from the dynamic options endpoint.",
      "x-dynamic-options": true,
      "x-workflow-field-type": "multi_select"
    },
    "include_unassigned": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "sort_by_time_in_wip": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "actual_delivery_date_to": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "string"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "orders": {}
  },
  "additionalProperties": true
}
```