> ## 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.

# Company To Contact By Role Waterfall

> Find contact candidates from company domain plus broad role intent via a quality-first waterfall. Use it to pilot, verify output, and scale safely.

In Claude Code, type:

```
/deepline-gtm Find VP and Director-level marketing contacts at Acme Corp (acme.com)
```

```
/deepline-gtm Get C-level and VP contacts at companies in my target list
```

<Accordion title="CLI command">
  ```bash theme={null}
  deepline enrich --with '{"alias":"contacts","tool":"company_to_contact_by_role_waterfall","payload":{"company_name":"Acme Corp","domain":"acme.com","roles":"VP Marketing,Director of Marketing","seniority":"VP,Director"}}'
  ```
</Accordion>

## How It Works

Providers are tried left to right. The first one to return a result wins — the rest are skipped. At least 3 results are required before stopping.

```mermaid theme={null}
flowchart LR
  S0["Dropleads"]:::provider
  S1["Apollo"]:::provider
  S2["Icypeas"]:::provider
  S3["Prospeo"]:::provider
  S4["Crustdata"]:::provider
  S0 --> S1 --> S2 --> S3 --> S4
  classDef provider fill:#1e293b,stroke:#475569,color:#e2e8f0
```

## Parameters

| Name           | Type       | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `company_name` | `string`   | Yes      | Company name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `domain`       | `string`   | Yes      | Company domain (required after resolver step).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `roles`        | `string[]` | Yes      | Primary persona intent for contact lookup. Accepts one or more role strings as an array or comma-separated string. Prefer exact, real-world title tokens when you know them, for example `CEO`, `CTO`, `CMO`, `Founder`, `Co-Founder`, `VP Marketing`, `Head of Security`, `Director of Engineering`, or `RevOps`. Broad functional inputs like `marketing`, `security`, `finance`, `product`, `engineering`, `sales`, or `growth` are allowed, but they are inherently noisier and may return adjacent roles unless paired with strong seniority or additional exact titles. A good default is to pass 1-3 exact titles when possible, and only fall back to broad functions when the user intent is actually broad. |
| `seniority`    | `string[]` | Yes      | Broad seniority intent for cross-provider matching. Use portable values like `C-Level`, `Founder`, `VP`, `Head`, `Director`, `Manager`, `Senior`, `Entry`, or `Intern` instead of provider-specific enums. Treat this as a level hint, not a substitute for a good role string. In practice, exact titles usually matter more than seniority for precision. Use seniority to narrow broad functions like `engineering` or `marketing`, but do not rely on seniority alone to express the persona.                                                                                                                                                                                                                     |
| `limit`        | `number`   | No       | Optional result cap per waterfall step (1-100). Use `1` for cheap sanity checks and `3-10` for better contact coverage in normal runs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

## Cost

**0.2-1.3 credits** — waterfalls stop at the first match, so you only pay for the provider that returns a result.

| Step      | Max Credits |
| --------- | ----------- |
| Dropleads | 0.3         |
| Apollo    | 0.2         |
| Icypeas   | 0.2         |
| Prospeo   | 0.6         |
| Crustdata | 0           |