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

# Personal Email Waterfall

> Find personal email for a person/contact using linkedin url.

**Tool ID:** `personalEmailWaterfall` · **Credits:** 7 per run

Find personal email for a person/contact using linkedin url.

**Best for:** Finding personal email when maximum coverage and quality is required.

**Not for:** work email, company email

## Inputs

Send these in `inputs`.

| Name | Required | Description |
| - | - | - |
| `linkedinUrl` | Yes | The person's LinkedIn profile URL. Required — personal email discovery is keyed off LinkedIn identity. |

## Options

Optional configuration. Send these in `options`.

| Name | Type | Required | Default | Description |
| - | - | - | - | - |
| `saveCredits` | boolean | No | `true` | When true AND a validationProvider is set, stop the waterfall early once the same email is returned and verified invalid by \~2-3 providers, to save credits. The UI auto-enables this when validation is on. |
| `personalEmailProviders` | array\<string> | No | | Ordered list of personal-email provider tool IDs to try (e.g. \["contactOutPersonalEmail","rocketReachPersonalEmail"]). Omit to use Bitscale's tuned default chain. |
| `validationProvider` | string | No | | Optional provider tool\_id used to verify each returned email BEFORE accepting it. Omit for no verification. |
| `safeToSend` | boolean | No | `false` | When true AND validationProvider is set, only emails the verifier marks 'safe to send' are returned. |

## Output

Returns personal email address using LinkedIn URL.

`result.data` looks like:

```json theme={null}
{
  "additionalEmails": [
    "jdoe@yahoo.com"
  ],
  "email": "jane.doe@gmail.com",
  "provider": "ContactOut",
  "quality": "good",
  "status": "valid"
}
```

## Example

```bash theme={null}
curl -X POST "https://api.bitscale.ai/api/v1/tools/personalEmailWaterfall/run" \
  -H "X-API-KEY: $BITSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"linkedinUrl": "https://www.linkedin.com/in/john-doe/"}}'
```

See [Tools API](https://docs.bitscale.ai/api-reference/tools/overview.md) for the response format and polling.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.