# List CMN Recertification Candidates

> Perform List CMN Recertification Candidates through Brightree.

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

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

- Handler: `brightree_list_cmn_recertification_candidates`

- Connection type: `brightree`

## Inputs

- `branch_name` — Branch Name (text, required)
  Required text value.
- `as_of_date` — As Of Date (date, required)
  Required date in YYYY-MM-DD format.
- `window_days` — Window Days (number)
  Optional numeric value.
  Default: `60`
- `exclude_faxed_this_cycle` — Exclude Faxed This Cycle (boolean)
  Optional true-or-false value.
  Default: `true`
- `maximum_candidates` — Maximum Candidates (number)
  Optional numeric value.
  Default: `500`

## Outputs

- `success` — Success
- `report_id` — Report Id
- `as_of_date` — As Of Date
- `window_end_date` — Window End Date
- `window_days` — Window Days
- `export_row_count` — Export Row Count
- `scoped_row_count` — Scoped Row Count
- `candidate_count` — Candidate Count
- `distinct_patient_count` — Distinct Patient Count
- `distinct_provider_count` — Distinct Provider Count
- `multi_cmn_patient_count` — Multi Cmn Patient Count
- `maximum_cmns_per_patient` — Maximum Cmns Per Patient
- `zero_to_seven_day_count` — Zero To Seven Day Count
- `eight_to_thirty_day_count` — Eight To Thirty Day Count
- `thirty_one_plus_day_count` — Thirty One Plus Day Count
- `missing_expiration_count` — Missing Expiration Count
- `malformed_expiration_count` — Malformed Expiration Count
- `expired_count` — Expired Count
- `beyond_window_count` — Beyond Window Count
- `invalid_identity_count` — Invalid Identity Count
- `missing_ordering_doctor_count` — Missing Ordering Doctor Count
- `branch_mismatch_count` — Branch Mismatch Count
- `inactive_status_count` — Inactive Status Count
- `placeholder_count` — Placeholder Count
- `duplicate_cycle_count` — Duplicate Cycle Count
- `report_missing_provider_fax_count` — Report Missing Provider Fax Count
- `fax_history_count` — Fax History Count
- `faxed_this_cycle_count` — Faxed This Cycle Count
- `failed_delivery_count` — Failed Delivery Count
- `data_quality_exception_count` — Data Quality Exception Count
- `excluded_row_count` — Excluded Row Count
- `candidates` — Candidates
- `failed_delivery_cmns` — Failed Delivery Cmns
- `retryable` — Retryable
- `manual_review_required` — Manual Review Required
- `report_job_id` — Report Job Id
- `report_job_resume_state` — Report Job Resume State
- `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": [
    "branch_name",
    "as_of_date"
  ],
  "properties": {
    "as_of_date": {
      "type": "string",
      "format": "date",
      "description": "Required date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "branch_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "window_days": {
      "type": "number",
      "default": 60,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "maximum_candidates": {
      "type": "number",
      "default": 500,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "exclude_faxed_this_cycle": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "success": {},
    "report_id": {},
    "retryable": {},
    "as_of_date": {},
    "candidates": {},
    "window_days": {},
    "expired_count": {},
    "report_job_id": {},
    "candidate_count": {},
    "window_end_date": {},
    "export_row_count": {},
    "scoped_row_count": {},
    "fax_history_count": {},
    "placeholder_count": {},
    "excluded_row_count": {},
    "beyond_window_count": {},
    "failed_delivery_cmns": {},
    "branch_mismatch_count": {},
    "duplicate_cycle_count": {},
    "failed_delivery_count": {},
    "inactive_status_count": {},
    "distinct_patient_count": {},
    "faxed_this_cycle_count": {},
    "invalid_identity_count": {},
    "manual_review_required": {},
    "distinct_provider_count": {},
    "multi_cmn_patient_count": {},
    "report_job_resume_state": {},
    "zero_to_seven_day_count": {},
    "maximum_cmns_per_patient": {},
    "missing_expiration_count": {},
    "eight_to_thirty_day_count": {},
    "thirty_one_plus_day_count": {},
    "malformed_expiration_count": {},
    "data_quality_exception_count": {},
    "missing_ordering_doctor_count": {},
    "report_missing_provider_fax_count": {}
  },
  "additionalProperties": true
}
```