> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/enrich_person

# enrich_person

> One known person from a work email, LinkedIn URL or name and employer: title, employer, seniority, location. ₹2.94 per person found; no match is ₹0.

## What it does

One known person, in `data.person`: `name`, `title`, `headline`, `seniority`, `functions`, `city`, `country`, `employment_history[]` and `organization` (name, domain, industry, size). Send the strongest key you have: `linkedin_url`, then `email`, then a name with `domain` or `organization_name`.

It returns no email address and no phone number: use [`find_email`](https://parel.si/docs/tools/find_email.md) for a work address. A personal address such as Gmail is refused, so this is not a way to identify who owns an address. When you do not yet know who you want, use [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md).

Check `match_confidence` and the employer on a name lookup: a common name can return someone who only used to work there.

India: well covered for professionals with a LinkedIn profile. A LinkedIn URL beats a name.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string | one of | Full name, with domain or organization_name. |
| `email` | string | one of | The person's work address. Personal addresses (Gmail and the like) are refused. |
| `domain` | string | one of | The employer's domain, with no www and no @. |
| `last_name` | string | one of | With first_name and domain or organization_name. |
| `first_name` | string | one of | With last_name and domain or organization_name. |
| `linkedin_url` | string | one of | The person's LinkedIn profile URL (linkedin.com/in/...). The strongest key. |
| `organization_name` | string | one of | The person's employer. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `linkedin_url`; `email`; `name` + `domain`; `name` + `organization_name`; `first_name` + `last_name` + `domain`; `first_name` + `last_name` + `organization_name`.

## What drives the cost

Nothing you can turn. You are charged only when the person is found; no match is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹2.94** per person found (`cost_paise: 294`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹4.41 (`hold_paise: 441`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "enrich_person"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "enrich_person"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"enrich_person","input":{"linkedin_url":"https://www.linkedin.com/in/jane-example"}}'
```

## What comes back

`data.person`. A real answer recorded during the live check of 2026-11-05 (people's names, profile links and ids replaced by fictional ones), trimmed:

```json
{
  "person": {
    "name": "Jane Example",
    "first_name": "Jane",
    "last_name": "Example",
    "title": "Founder",
    "headline": "Building things.",
    "linkedin_url": "https://www.linkedin.com/in/jane-example",
    "seniority": "founder",
    "functions": [
      "entrepreneurship"
    ],
    "city": "Gurugram",
    "state": "Haryana",
    "country": "India",
    "match_confidence": "high",
    "employment_history": [
      {
        "title": "Founder",
        "organization_name": "Temple",
        "start_date": "2024-08-01",
        "end_date": null,
        "current": true
      },
      {
        "title": "Founder",
        "organization_name": "Eternal",
        "start_date": "2008-07-01",
        "end_date": null,
        "current": true
      }
    ],
    "organization": {
      "name": "Temple",
      "primary_domain": "temple.com",
      "website_url": "http://www.temple.com",
      "linkedin_url": "http://www.linkedin.com/company/weartemple",
      "industry": "health, wellness & fitness",
      "estimated_num_employees": 110,
      "short_description": "Temple is an Irish-owned and managed value-added distributor (VAD) established in 1977. The company specializes in IT infrastructure connectivity solutions, focusing on distributing products that enhance connectivity in the IT sector.\n\nAs a VAD, Temple provides additional services such as technical support, training, and integration for resellers and end-users. This approach adds value to their distribution efforts, ensuring clients receive comprehensive support in their IT infrastructure needs."
    }
  }
}
```

## Notes

- Charged only when the person is found; no match is free (class ok_free).
- A personal address such as Gmail is refused as invalid_input (free).
- A name with an employer can match someone who only used to work there, so check match_confidence and the title.
- No email address or phone number in the answer.

## Siblings

- [`find_email`](https://parel.si/docs/tools/find_email.md) for one person's work address.
- [`get_linkedin_profile`](https://parel.si/docs/tools/get_linkedin_profile.md) for a LinkedIn profile in full.
- [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md) to find people from a description.
