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

# Aviato: Person Bulk Contact Info

> Find emails and phone numbers for up to 100 people at once. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Find emails and phone numbers for up to 100 people at once.

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

## 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(
  'aviato_person_bulk_contact_info',
  {
    "lookups": [
      {
        "id": "id_123",
        "linkedinID": "https://www.linkedin.com/in/jane-doe",
        "linkedinEntityId": "https://www.linkedin.com/in/jane-doe"
      }
    ]
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute aviato_person_bulk_contact_info --input '{
  "lookups": [
    {
      "id": "id_123",
      "linkedinID": "https://www.linkedin.com/in/jane-doe",
      "linkedinEntityId": "https://www.linkedin.com/in/jane-doe"
    }
  ]
}' --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": [
    {
      "lookupSuccessful": true,
      "emails": [
        {
          "email": "jane.doe@example.com"
        }
      ]
    }
  ]
}
```

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

## Input reference

Get contact info (emails, phones) for multiple people at once. Max 100 at a time.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.lookups` | `array` | Yes | — | — |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Get contact info (emails, phones) for multiple people at once. Max 100 at a time.",
    "properties": {
      "lookups": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "linkedinID": {
              "type": "string"
            },
            "linkedinEntityId": {
              "type": "string",
              "description": "LinkedIn entity ID"
            },
            "linkedinURL": {
              "type": "string",
              "description": "LinkedIn URL, accepts public profile (linkedin.com/in/), Sales Navigator, and Recruiter URLs"
            },
            "twitterID": {
              "type": "string"
            },
            "crunchbaseID": {
              "type": "string"
            },
            "angelListID": {
              "type": "string"
            },
            "signalNfxID": {
              "type": "string"
            },
            "polyworkID": {
              "type": "string"
            },
            "email": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      }
    },
    "required": [
      "lookups"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `array` | Yes | — | Provider response payload. |
| `result.data[].lookupSuccessful` | `boolean` | Yes | — | — |
| `result.data[].id` | `string` | No | — | — |
| `result.data[].emails` | `array` | Yes | — | — |
| `result.data[].emails[].email` | `string` | Yes | — | — |
| `result.data[].emails[].type` | `string` | No | — | The type of email address (work, personal, student) |
| `result.data[].emails[].companyID` | `string` | No | — | The Aviato ID of the company this email is associated with. (Only present for work emails) |
| `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": "array",
        "description": "Provider response payload.",
        "items": {
          "type": "object",
          "properties": {
            "lookupSuccessful": {
              "type": "boolean"
            },
            "id": {
              "type": "string"
            },
            "emails": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "This object represents an email address of a person.",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "description": "The type of email address (work, personal, student)"
                  },
                  "companyID": {
                    "type": "string",
                    "description": "The Aviato ID of the company this email is associated with. (Only present for work emails)"
                  }
                },
                "required": [
                  "email"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "lookupSuccessful",
            "emails"
          ],
          "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

* [Aviato provider guide](https://deepline.com/docs/providers/aviato/guide.md)
* [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.