> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Enformion Contact Enrich: Inputs, Cost & CLI Example

> Find personal mobile phones for SMB owners (restaurants, retail, local services) who have no LinkedIn or B2B presence. Input: first name + bare last name +

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=enformion_contact_enrich:{"first_name":"{{first_name}}","last_name":"{{last_name}}","city_state":"{{city_state}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                 | Type     | Required | Default | Description                                                                                                                                                                                          |
| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.first_name` | `string` | Yes      |         | Owner first name. Do not include middle name or initial.                                                                                                                                             |
| `payload.last_name`  | `string` | Yes      |         | Owner last name. The integration automatically strips middle initials and compound surname prefixes (e.g. 'De La Cruz' → 'Cruz') because EnformionGO returns zero results for multi-word last names. |
| `payload.city_state` | `string` | Yes      |         | City and state as "City, ST" (e.g. "Cleveland, OH"). Used as Address.addressLine2 in the EnformionGO request.                                                                                        |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Consumer skip-trace via EnformionGO. Finds personal mobile phones from name + city/state. Designed for SMB restaurant/retail owners with no B2B presence. Returns typed phones (mobile/landline) with isConnected flag and identityScore (0–100). Hit rate ~53% on named rows. Do NOT pass middle initials in last_name.",
    "properties": {
      "first_name": {
        "type": "string",
        "description": "Owner first name. Do not include middle name or initial.",
        "minLength": 1
      },
      "last_name": {
        "type": "string",
        "description": "Owner last name. The integration automatically strips middle initials and compound surname prefixes (e.g. 'De La Cruz' → 'Cruz') because EnformionGO returns zero results for multi-word last names.",
        "minLength": 1
      },
      "city_state": {
        "type": "string",
        "description": "City and state as \"City, ST\" (e.g. \"Cleveland, OH\"). Used as Address.addressLine2 in the EnformionGO request.",
        "minLength": 1
      }
    },
    "required": [
      "first_name",
      "last_name",
      "city_state"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name                   | Type      | Required | Default | Description |
| ---------------------- | --------- | -------- | ------- | ----------- |
| `result.person`        | `object`  | Yes      |         |             |
| `result.message`       | `string`  | Yes      |         |             |
| `result.identityScore` | `integer` | Yes      |         |             |
| `result.isError`       | `boolean` | Yes      |         |             |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "person": {
        "type": "object",
        "properties": {
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string"
              },
              "middleName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              }
            },
            "required": [
              "firstName",
              "middleName",
              "lastName"
            ],
            "additionalProperties": true
          },
          "age": {
            "type": "string"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstReportedDate": {
                  "type": "string"
                },
                "lastReportedDate": {
                  "type": "string"
                },
                "street": {
                  "type": "string"
                },
                "unit": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "zip": {
                  "type": "string"
                }
              },
              "required": [
                "firstReportedDate",
                "lastReportedDate",
                "street",
                "unit",
                "city",
                "state",
                "zip"
              ],
              "additionalProperties": true
            }
          },
          "phones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "isConnected": {
                  "type": "boolean"
                },
                "firstReportedDate": {
                  "type": "string"
                },
                "lastReportedDate": {
                  "type": "string"
                }
              },
              "required": [
                "number",
                "type",
                "isConnected",
                "firstReportedDate",
                "lastReportedDate"
              ],
              "additionalProperties": true
            }
          },
          "emails": {
            "type": "array",
            "items": {}
          }
        },
        "required": [
          "name",
          "age",
          "addresses",
          "phones",
          "emails"
        ],
        "additionalProperties": true
      },
      "message": {
        "type": "string"
      },
      "identityScore": {
        "type": "integer"
      },
      "isError": {
        "type": "boolean"
      }
    },
    "required": [
      "person",
      "message",
      "identityScore",
      "isError"
    ],
    "additionalProperties": true
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute enformion_contact_enrich --payload '{
  "first_name": "string",
  "last_name": "string",
  "city_state": "string"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `1.68` per pricing unit.
* Billing mode: `post_deduct`.