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

# Prospeo: Enrich Person

> Find a person's verified work email, plus title, company, location, and optional mobile phone, from a LinkedIn URL, an email (reverse lookup), or name plus.

Find a person's verified work email, plus title, company, location, and optional mobile phone, from a LinkedIn URL, an email (reverse lookup), or name plus.

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

## 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(
  'prospeo_enrich_person',
  {
    "linkedin_url": "https://www.linkedin.com/in/jane-doe",
    "email": "jane.doe@example.com",
    "first_name": "Jane"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute prospeo_enrich_person --input '{
  "linkedin_url": "https://www.linkedin.com/in/jane-doe",
  "email": "jane.doe@example.com",
  "first_name": "Jane"
}' --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": {
    "error": true,
    "free_enrichment": true,
    "person": {
      "person_id": "person_123",
      "first_name": "Jane",
      "last_name": "Doe"
    }
  }
}
```

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

## Input reference

Enrich a person with verified email, mobile, and professional data. Replaces email-finder.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.linkedin_url` | `string` | No | — | LinkedIn profile URL — use alone or with name for highest accuracy. |
| `payload.email` | `string` | No | — | Email address — use as sole identity seed for reverse enrichment. |
| `payload.first_name` | `string` | No | — | First name. Combine with last\_name + company\_website for best results. |
| `payload.last_name` | `string` | No | — | Last name. |
| `payload.full_name` | `string` | No | — | Full name (alternative to first\_name + last\_name). |
| `payload.company_name` | `string` | No | — | Company name. Avoid using alone — many companies share names. |
| `payload.company_website` | `string` | No | — | Company domain (for example stripe.com). Preferred over company\_name. |
| `payload.website` | `string` | No | — | Deepline alias for company\_website. Sent to Prospeo as company\_website when it contains a domain. |
| `payload.domain` | `string` | No | — | Deepline alias for company\_website. Sent to Prospeo as company\_website when it contains a domain. |
| `payload.company_domain` | `string` | No | — | Deepline alias for company\_website. Sent to Prospeo as company\_website when it contains a domain. |
| `payload.company_linkedin_url` | `string` | No | — | Company LinkedIn URL for more precise matching. |
| `payload.person_id` | `string` | No | — | Person ID from a previous search\_person call. |
| `payload.only_verified_email` | `boolean` | No | — | Return only if a verified email is found (default false). |
| `payload.enrich_mobile` | `boolean` | No | — | Also enrich mobile number (10 credits if found). |
| `payload.only_verified_mobile` | `boolean` | No | — | Return only if a verified mobile is found. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Enrich a person with verified email, mobile, and professional data. Replaces email-finder.",
    "properties": {
      "linkedin_url": {
        "type": "string",
        "description": "LinkedIn profile URL — use alone or with name for highest accuracy."
      },
      "email": {
        "type": "string",
        "description": "Email address — use as sole identity seed for reverse enrichment."
      },
      "first_name": {
        "type": "string",
        "description": "First name. Combine with last_name + company_website for best results."
      },
      "last_name": {
        "type": "string",
        "description": "Last name."
      },
      "full_name": {
        "type": "string",
        "description": "Full name (alternative to first_name + last_name)."
      },
      "company_name": {
        "type": "string",
        "description": "Company name. Avoid using alone — many companies share names."
      },
      "company_website": {
        "type": "string",
        "description": "Company domain (for example stripe.com). Preferred over company_name."
      },
      "website": {
        "type": "string",
        "description": "Deepline alias for company_website. Sent to Prospeo as company_website when it contains a domain."
      },
      "domain": {
        "type": "string",
        "description": "Deepline alias for company_website. Sent to Prospeo as company_website when it contains a domain."
      },
      "company_domain": {
        "type": "string",
        "description": "Deepline alias for company_website. Sent to Prospeo as company_website when it contains a domain."
      },
      "company_linkedin_url": {
        "type": "string",
        "description": "Company LinkedIn URL for more precise matching."
      },
      "person_id": {
        "type": "string",
        "description": "Person ID from a previous search_person call."
      },
      "only_verified_email": {
        "type": "boolean",
        "description": "Return only if a verified email is found (default false)."
      },
      "enrich_mobile": {
        "type": "boolean",
        "description": "Also enrich mobile number (10 credits if found)."
      },
      "only_verified_mobile": {
        "type": "boolean",
        "description": "Return only if a verified mobile is found."
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Prospeo enrich-person response. Important: `data.person.email` is an envelope object. read the scalar address from `data.person.email.email` or use `result.extractedValues.email.get()` in plays.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Prospeo enrich-person response. Important: `data.person.email` is an envelope object. read the scalar address from `data.person.email.email` or use `result.extractedValues.email.get()` in plays. |
| `result.data.error` | `boolean` | No | — | — |
| `result.data.free_enrichment` | `boolean` | No | — | — |
| `result.data.person` | `object` | No | — | Prospeo person record. The scalar email address is `person.email.email`. `person.email` is an object with status/revealed metadata. |
| `result.data.person.person_id` | `string` | No | — | — |
| `result.data.person.first_name` | `string` | No | — | — |
| `result.data.person.last_name` | `string` | No | — | — |
| `result.data.person.full_name` | `string` | No | — | — |
| `result.data.person.linkedin_url` | `string` | No | — | — |
| `result.data.person.current_job_title` | `string \| null` | No | — | — |
| `result.data.person.headline` | `string \| null` | No | — | — |
| `result.data.person.email` | `object` | No | — | Prospeo email envelope. This object is not the scalar email address. Use `email` inside it for the address. |
| `result.data.person.email.status` | `string` | No | — | — |
| `result.data.person.email.revealed` | `boolean \| null` | No | — | — |
| `result.data.person.email.email` | `string \| null` | No | — | Scalar email address. Read this nested field as `data.person.email.email`. `data.person.email` is the provider email envelope object. |
| `result.data.person.email.verification_method` | `string \| null` | No | — | — |
| `result.data.person.email.email_mx_provider` | `string \| null` | No | — | — |
| `result.data.person.mobile` | `object` | No | — | Prospeo mobile envelope. Use `mobile` or `mobile_international` inside it for the scalar phone number. |
| `result.data.person.mobile.status` | `string` | No | — | — |
| `result.data.person.mobile.revealed` | `boolean \| null` | No | — | — |
| `result.data.person.mobile.mobile` | `string \| null` | No | — | — |
| `result.data.person.mobile.mobile_national` | `string \| null` | No | — | — |
| `result.data.person.mobile.mobile_international` | `string \| null` | No | — | — |
| `result.data.person.mobile.mobile_country` | `string \| null` | No | — | — |
| `result.data.person.mobile.mobile_country_code` | `string \| null` | No | — | — |
| `result.data.company` | `object` | No | — | Prospeo company record. |
| `result.data.company.company_id` | `string` | No | — | — |
| `result.data.company.name` | `string` | No | — | — |
| `result.data.company.website` | `string` | No | — | — |
| `result.data.company.domain` | `string` | No | — | — |
| `result.data.company.linkedin_url` | `string` | No | — | — |
| `result.meta` | `record` | 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": "Prospeo enrich-person response. Important: `data.person.email` is an envelope object; read the scalar address from `data.person.email.email` or use `result.extractedValues.email.get()` in plays.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Prospeo enrich-person response. Important: `data.person.email` is an envelope object; read the scalar address from `data.person.email.email` or use `result.extractedValues.email.get()` in plays.",
        "properties": {
          "error": {
            "type": "boolean"
          },
          "free_enrichment": {
            "type": "boolean"
          },
          "person": {
            "type": "object",
            "description": "Prospeo person record. The scalar email address is `person.email.email`; `person.email` is an object with status/revealed metadata.",
            "properties": {
              "person_id": {
                "type": "string"
              },
              "first_name": {
                "type": "string"
              },
              "last_name": {
                "type": "string"
              },
              "full_name": {
                "type": "string"
              },
              "linkedin_url": {
                "type": "string"
              },
              "current_job_title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "headline": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "email": {
                "type": "object",
                "description": "Prospeo email envelope. This object is not the scalar email address; use `email` inside it for the address.",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "revealed": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "email": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Scalar email address. Read this nested field as `data.person.email.email`; `data.person.email` is the provider email envelope object."
                  },
                  "verification_method": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "email_mx_provider": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "additionalProperties": true
              },
              "mobile": {
                "type": "object",
                "description": "Prospeo mobile envelope. Use `mobile` or `mobile_international` inside it for the scalar phone number.",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "revealed": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "mobile": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "mobile_national": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "mobile_international": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "mobile_country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "mobile_country_code": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "additionalProperties": true
              }
            },
            "additionalProperties": true
          },
          "company": {
            "type": "object",
            "description": "Prospeo company record.",
            "properties": {
              "company_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "website": {
                "type": "string"
              },
              "domain": {
                "type": "string"
              },
              "linkedin_url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [Prospeo provider guide](https://deepline.com/docs/providers/prospeo/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.