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

# Limadata: Enrich Person

> Enrich a person from email, LinkedIn URL, or name plus company with profile, work history, education, social, and employer data.

Enrich a person from email, LinkedIn URL, or name plus company with profile, work history, education, social, and employer data.

> [!NOTE]
>
> Tool ID: `limadata_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(
  'limadata_enrich_person',
  {
    "email": "jane.doe@example.com",
    "linkedin_url": "https://www.linkedin.com/in/jane-doe",
    "name": "Example"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute limadata_enrich_person --input '{
  "email": "jane.doe@example.com",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe",
  "name": "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": {
    "person": {
      "name": "Example",
      "first_name": "Jane",
      "last_name": "Doe"
    },
    "company": {
      "name": "Example",
      "domain": "example.com",
      "website": "https://example.com"
    }
  }
}
```

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

## Input reference

Enrich a person's professional profile using their email, LinkedIn URL, or name with company information. Returns comprehensive profile data including work history, education, social profiles, and current company information. #### What You Get - **Person Data**: Full name, headline, summary, location, profile picture - **Work Experience**: Current job with title, company, dates, and descriptions - **Education**: Schools, degrees, fields of study, dates - **Skills**: Professional skills and endorsements - **Social Profiles**: LinkedIn, Twitter/X, GitHub, Facebook - **Company Data**: Current employer's name, domain, website, logo, industry, employee count, locations, funding, revenue, social profiles #### Common Use Cases - **CRM Enrichment**: Enhance contact records with fresh professional data - **Signup Flows**: Personalize onboarding by pre-filling user profiles with professional See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.email` | `string` | No | — | Person's email address. Example: [john.doe@example.com](mailto:john.doe@example.com) |
| `payload.linkedin_url` | `string` | No | — | Person's LinkedIn URL. Example: [https://linkedin.com/in/johndoe](https://linkedin.com/in/johndoe) |
| `payload.name` | `string` | No | — | Person's name. Required when using company lookup. Example: John Doe |
| `payload.company_name` | `string` | No | — | Company name. Use with Name for identity resolution. Example: Microsoft |
| `payload.company_domain` | `string` | No | — | Company domain. Use with Name for identity resolution. Example: microsoft.com |
| `payload.include_work_email` | `boolean` | No | — | Include the person's work email in the response. Adds 1 credit if found. |
| `payload.include_phone` | `boolean` | No | — | Include the person's phone number(s) in the response. Adds 10 credits if 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's professional profile using their email, LinkedIn URL, or name with company information. Returns comprehensive profile data including work history, education, social profiles, and current company information. #### What You Get - **Person Data**: Full name, headline, summary, location, profile picture - **Work Experience**: Current job with title, company, dates, and descriptions - **Education**: Schools, degrees, fields of study, dates - **Skills**: Professional skills and endorsements - **Social Profiles**: LinkedIn, Twitter/X, GitHub, Facebook - **Company Data**: Current employer's name, domain, website, logo, industry, employee count, locations, funding, revenue, social profiles #### Common Use Cases - **CRM Enrichment**: Enhance contact records with fresh professional data - **Signup Flows**: Personalize onboarding by pre-filling user profiles with professional information - **Form Enrichment**: Reduce friction by auto-completing form fields from email input --- #### Input Options Choose one of the following methods to identify the person: ##### Option 1: Email Address Look up a person by their email address. - **email** (required): e.g., `john.doe@company.com` - **name** (recommended): Adding the person's name significantly improves match accuracy ##### Option 2: Name + Company Find a person by their name and current company. - **name** (required): e.g., `John Doe` - **company_name** and/or **company_domain** (at least one required): e.g., `Microsoft` or `microsoft.com` ##### Option 3: LinkedIn URL Provide the person's LinkedIn profile URL directly. - **linkedin_url** (required): e.g., `https://linkedin.com/in/johndoe` --- #### Rate Limit This endpoint is exempt from the global rate limit and can support higher concurrency. --- --- #### Additional Enrichment Options Optionally enrich the response with additional contact information: - **include_work_email**: Set to `true` to include the person's work email address. - **include_phone**: Set to `true` to include the person's phone number(s).",
    "properties": {
      "email": {
        "type": [
          "string",
          "null"
        ],
        "description": "Person's email address. Example: john.doe@example.com"
      },
      "linkedin_url": {
        "type": [
          "string",
          "null"
        ],
        "description": "Person's LinkedIn URL. Example: https://linkedin.com/in/johndoe"
      },
      "name": {
        "type": [
          "string",
          "null"
        ],
        "description": "Person's name. Required when using company lookup. Example: John Doe"
      },
      "company_name": {
        "type": [
          "string",
          "null"
        ],
        "description": "Company name. Use with Name for identity resolution. Example: Microsoft"
      },
      "company_domain": {
        "type": [
          "string",
          "null"
        ],
        "description": "Company domain. Use with Name for identity resolution. Example: microsoft.com"
      },
      "include_work_email": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Include the person's work email in the response. Adds 1 credit if found."
      },
      "include_phone": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Include the person's phone number(s) in the response. Adds 10 credits if found."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.person` | `object \| null` | No | — | — |
| `result.data.person.name` | `string \| null` | No | — | Person's full name |
| `result.data.person.first_name` | `string \| null` | No | — | — |
| `result.data.person.last_name` | `string \| null` | No | — | — |
| `result.data.person.headline` | `string \| null` | No | — | — |
| `result.data.person.about` | `string \| null` | No | — | — |
| `result.data.person.gender` | `string \| null` | No | — | — |
| `result.data.person.age_in_years` | `integer \| null` | No | — | Format: `int32`. |
| `result.data.person.location` | `object \| null` | No | — | Person's location |
| `result.data.person.location.city` | `string \| null` | No | — | — |
| `result.data.person.location.state` | `string \| null` | No | — | — |
| `result.data.person.location.country` | `string \| null` | No | — | — |
| `result.data.person.location.text` | `string \| null` | No | — | — |
| `result.data.person.emails` | `array \| null` | No | — | — |
| `result.data.person.phone_numbers` | `array \| null` | No | — | — |
| `result.data.person.phone_numbers[].number` | `string \| null` | No | — | — |
| `result.data.person.phone_numbers[].type` | `string \| null` | No | — | — |
| `result.data.person.linkedin` | `object \| null` | No | — | — |
| `result.data.person.linkedin.handle` | `string \| null` | No | — | — |
| `result.data.person.linkedin.url` | `string \| null` | No | — | — |
| `result.data.person.github` | `object \| null` | No | — | — |
| `result.data.person.github.handle` | `string \| null` | No | — | — |
| `result.data.person.github.url` | `string \| null` | No | — | — |
| `result.data.person.x` | `object \| null` | No | — | — |
| `result.data.person.x.handle` | `string \| null` | No | — | — |
| `result.data.person.x.url` | `string \| null` | No | — | — |
| `result.data.person.facebook` | `object \| null` | No | — | — |
| `result.data.person.facebook.handle` | `string \| null` | No | — | — |
| `result.data.person.facebook.url` | `string \| null` | No | — | — |
| `result.data.person.employment` | `object \| null` | No | — | — |
| `result.data.person.employment.title` | `string \| null` | No | — | — |
| `result.data.person.employment.company_name` | `string \| null` | No | — | — |
| `result.data.person.employment.company_domain` | `string \| null` | No | — | — |
| `result.data.person.employment.location` | `string \| null` | No | — | — |
| `result.data.person.employment.seniority` | `string \| null` | No | — | — |
| `result.data.person.employment.start_date` | `string \| null` | No | — | Format: `date-time`. |
| `result.data.person.employment.end_date` | `string \| null` | No | — | Format: `date-time`. |
| `result.data.person.education` | `object \| null` | No | — | — |
| `result.data.person.education.degree_name` | `string \| null` | No | — | — |
| `result.data.person.education.school_name` | `string \| null` | No | — | — |
| `result.data.person.education.start_date` | `string \| null` | No | — | Format: `date-time`. |
| `result.data.person.education.end_date` | `string \| null` | No | — | Format: `date-time`. |
| `result.data.person.profile_image_url` | `string \| null` | No | — | — |
| `result.data.company` | `object \| null` | No | — | — |
| `result.data.company.name` | `string \| null` | No | — | — |
| `result.data.company.domain` | `string \| null` | No | — | — |
| `result.data.company.website` | `string \| null` | No | — | — |
| `result.data.company.logo_url` | `string \| null` | No | — | — |
| `result.data.company.founded_year` | `integer \| null` | No | — | Format: `int32`. |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe limadata_enrich_person --json`.

## Deepline cost

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

## Related documentation

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