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

# AI Ark: Find Emails

> Find work emails for all the people returned by an earlier people search, as one bulk job. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Find work emails for all the people returned by an earlier people search, as one bulk job.

> [!NOTE]
>
> Tool ID: `ai_ark_find_emails`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'ai_ark_find_emails',
  {
    "trackId": "track_123",
    "webhook": "example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute ai_ark_find_emails --input '{
  "trackId": "track_123",
  "webhook": "example"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "trackId": "123e4567-e89b-42d3-a456-426614174000",
    "statistics": {
      "total": 123,
      "found": 123
    },
    "webhook": {
      "state": "California",
      "retry": "example"
    }
  }
}
```

Use `deepline describe ai_ark_find_emails --json` for the latest machine-readable contract.

## Input reference

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.trackId` | `string` | Yes | — | — |
| `payload.webhook` | `string` | Yes | — | — |
| `payload.wait_for_completion` | `boolean` | No | `true` | When true or omitted, wait for the async AI Ark job to finish and return final statistics. Set false to return only the async launcher response. |
| `payload.poll_interval_ms` | `integer` | No | `2000` | Polling interval used while wait\_for\_completion is true. Defaults to 2000 ms. Minimum: 250. Maximum: 10000. |
| `payload.max_wait_ms` | `integer` | No | `45000` | Maximum time to wait for terminal AI Ark statistics. Defaults to 45000 ms. Minimum: 1000. Maximum: 120000. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "properties": {
      "trackId": {
        "type": "string"
      },
      "webhook": {
        "type": "string"
      },
      "wait_for_completion": {
        "type": "boolean",
        "description": "When true or omitted, wait for the async AI Ark job to finish and return final statistics. Set false to return only the async launcher response.",
        "default": true
      },
      "poll_interval_ms": {
        "type": "integer",
        "description": "Polling interval used while wait_for_completion is true. Defaults to 2000 ms.",
        "default": 2000,
        "minimum": 250,
        "maximum": 10000
      },
      "max_wait_ms": {
        "type": "integer",
        "description": "Maximum time to wait for terminal AI Ark statistics. Defaults to 45000 ms.",
        "default": 45000,
        "minimum": 1000,
        "maximum": 120000
      }
    },
    "required": [
      "trackId",
      "webhook"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.trackId` | `string` | No | — | Format: `uuid`. |
| `result.data.statistics` | `object` | No | — | — |
| `result.data.statistics.total` | `integer` | No | — | — |
| `result.data.statistics.found` | `integer` | No | — | — |
| `result.data.webhook` | `object` | No | — | — |
| `result.data.webhook.state` | `string` | No | — | — |
| `result.data.webhook.retry` | `string \| null` | No | — | — |
| `result.data.state` | `string` | No | — | — |
| `result.data.description` | `string \| null` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "trackId": {
            "type": "string",
            "format": "uuid"
          },
          "statistics": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "found": {
                "type": "integer"
              }
            },
            "additionalProperties": false
          },
          "webhook": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string"
              },
              "retry": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "additionalProperties": false
          },
          "state": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.14` per pricing unit.

## Related documentation

* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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