# Read Fax Details

> Purpose: Read safe details for one eFax record without opening its document. Use when: Inspect a fax listed in the organization's connected eFax mailbox. Inputs: Required fax_id UUID string from List Received Faxes. Outputs: fax object with fax_id:string and nullable pages:integer, size:integer, image_downloaded:boolean, fax_status:string, completed_timestamp:string, direction:string; success:boolean, error:string|null, failure_category:null. The runner wraps successful output under default. No title or file bytes. Success: success=true, error=null, and fax.fax_id matches the requested ID. Failure: success=false with a safe error and no fax object; check the ID and mailbox access. Login and safe reads try transient errors up to three times with exponential backoff and jitter. Effects: Read-only in the current organization's mailbox; does not mark the fax read. Examples: {"fax_id":"00000000-0000-0000-0000-000000000001"} can return a fax object with fax_id="00000000-0000-0000-0000-000000000001", pages=3, success=true and error=null under default.

Source: [https://genhealth.ai/docs/workflows/integrations/e-fax/efax_read_fax](https://genhealth.ai/docs/workflows/integrations/e-fax/efax_read_fax)

Integration: [eFax](https://genhealth.ai/docs/workflows/integrations/e-fax.md)

- Handler: `efax_read_fax`

- Connection type: `efax`

## 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": "eFax",
  "params": {},
  "handler": "efax_read_fax"
}

```

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

## Inputs

- `fax_id` — Fax Id (text, required)
  Required eFax fax UUID from List Received Faxes in this mailbox; not a local document ID.

## Outputs

- `fax` — Fax
- `success` — Success
- `error` — Error

Output schema completeness: `reviewed_partial`

## 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": [
    "fax_id"
  ],
  "properties": {
    "fax_id": {
      "type": "string",
      "format": "uuid",
      "description": "Required eFax fax UUID from List Received Faxes in this mailbox; not a local document ID.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "fax": {
      "type": "object",
      "additionalProperties": true
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "success": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
```