# List Referrals

> Perform List Referrals through Cori.

Source: [https://genhealth.ai/docs/workflows/integrations/cori/cori_list_referrals](https://genhealth.ai/docs/workflows/integrations/cori/cori_list_referrals)

Integration: [Cori](https://genhealth.ai/docs/workflows/integrations/cori.md)

- Handler: `cori_list_referrals`

- Connection type: `cori`

## Use in a workflow

Copy this discovered node config, fill params from the input contract, and validate the complete graph. Integration results are available as {{node_id.default.field}}. Check business success before dependent writes; completion alone does not prove business success.

```json

{
  "_group": "Cori",
  "params": {
    "page": 1,
    "page_size": 50
  },
  "handler": "cori_list_referrals"
}

```

[Action contracts](https://genhealth.ai/docs/workflows/action-contracts.md) · [Run recovery](https://genhealth.ai/docs/workflows/operations.md)

## Inputs

- `page` — Page (number)
  Optional numeric value.
  Default: `1`
- `page_size` — Page Size (number)
  Optional numeric value.
  Default: `50`
- `q` — Q (text)
  Optional text value.
- `status` — Status (text)
  Optional text value.
- `updated_since` — Updated Since (text)
  Optional text value.

## Outputs

- `success` — Success
- `operation` — Operation
- `data` — Data
- `referral_id` — Referral Id
- `document_id` — Document Id
- `s3_path` — S3 Path
- `cori_url` — Cori Url
- `error` — Error
- `error_kind` — Error Kind
- `indeterminate` — Indeterminate
- `retryable` — Retryable
- `was_existing` — Was Existing
- `already_submitted` — Already Submitted

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": {
    "q": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "status": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "page_size": {
      "type": "number",
      "default": 50,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "updated_since": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "data": {},
    "error": {},
    "s3_path": {},
    "success": {},
    "cori_url": {},
    "operation": {},
    "retryable": {},
    "error_kind": {},
    "document_id": {},
    "referral_id": {},
    "was_existing": {},
    "indeterminate": {},
    "already_submitted": {}
  },
  "additionalProperties": true
}
```