# List Inbound Faxes

> Perform List Inbound Faxes through Brightree.

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

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

- Handler: `brightree_list_inbound_faxes`

- Connection type: `brightree`

## Inputs

- `received_date_from` — Received Date From (date)
  Optional date in YYYY-MM-DD format.
  Default: `"2026-08-13"`
- `received_date_to` — Received Date To (date)
  Optional date in YYYY-MM-DD format.
  Default: `"2026-08-13"`
- `work_status` — Work Status (text)
  Optional text value.
- `show_unassigned` — Show Unassigned (boolean)
  Optional true-or-false value.
- `branch_offices` — Branch Offices (multi_select, dynamic options)
  Optional list of selected values. Retrieve allowed values from the dynamic options endpoint.
- `exclude_nonempty_report_type` — Exclude Nonempty Report Type (boolean)
  Optional true-or-false value.
- `max_pages` — Max Pages (number)
  Optional numeric value.
  Default: `50`
- `max_items` — Max Items (number)
  Optional numeric value.

## Outputs

- `faxes` — Faxes
- `count` — Count
- `total_items` — Total Items
- `total_pages` — Total Pages
- `has_more` — Has More
- `message` — Message

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": {
    "max_items": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "max_pages": {
      "type": "number",
      "default": 50,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "work_status": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "branch_offices": {
      "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"
    },
    "show_unassigned": {
      "type": "boolean",
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "received_date_to": {
      "type": "string",
      "format": "date",
      "default": "2026-08-13",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "received_date_from": {
      "type": "string",
      "format": "date",
      "default": "2026-08-13",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "exclude_nonempty_report_type": {
      "type": "boolean",
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "count": {},
    "faxes": {},
    "message": {},
    "has_more": {},
    "total_items": {},
    "total_pages": {}
  },
  "additionalProperties": true
}
```