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

# find_phone

> One known person's verified mobile number from a LinkedIn URL, work email, or name and employer. ₹28 per number found; no number is ₹0.

## What it does

The verified mobile number of one person you already know of. Send a `linkedin_url`, a work `email`, or a name with their employer. `data.person` has `full_name`, `current_job_title`, `linkedin_url` and `mobile` (status, number, country); `data.company.name` is the employer.

Three limits, enforced before anything is sent:

- **One known person per call.** There is no list input.
- **No reverse lookup.** It takes no phone number, and a personal address such as Gmail is refused.
- **No bulk lists.** To look at many people, choose the one you need first with [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md) or [`enrich_person`](https://parel.si/docs/tools/enrich_person.md).

Most people have no verified number on record. That is the usual outcome, it is ₹0, and retrying will not change it.

A number may be used only as the [Acceptable Use Policy](https://parel.si/legal/acceptable-use) allows. In India, TRAI's rules on commercial communication and the do-not-disturb register apply.

India: Indian mobiles are covered, unevenly. A small live check found numbers for four of five marketing heads at D2C brands and none for two public founders. A LinkedIn URL beats a name.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `email` | string | one of | The person's work address. Personal addresses are refused. |
| `full_name` | string | one of | With one of company_name, company_website or company_linkedin_url. |
| `last_name` | string | one of | With first_name and one company field. |
| `first_name` | string | one of | With last_name and one company field. |
| `company_name` | string | one of | The person's employer. |
| `linkedin_url` | string | one of | The person's LinkedIn profile URL (linkedin.com/in/...). The strongest key. |
| `company_website` | string | one of | The employer's website ("intercom.com"). |
| `company_linkedin_url` | string | one of | The employer's LinkedIn page. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `linkedin_url`; `email`; `full_name` + `company_name`; `full_name` + `company_website`; `full_name` + `company_linkedin_url`; `first_name` + `last_name` + `company_name`; `first_name` + `last_name` + `company_website`; `first_name` + `last_name` + `company_linkedin_url`.

## What drives the cost

Nothing you can turn. You are charged only when a verified number comes back; no number is `class: "ok_free"`, ₹0, with `data: null`.

Parel does not store the number, so an `idempotency_key` cannot replay this call: repeating one is refused with `replay_expired`, and a new key runs the lookup and charges it again. Keep the number you get.

## Price today

| | |
|---|---|
| Price today | **₹28** per number found (`cost_paise: 2762`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹41.43 (`hold_paise: 4143`); 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: "find_phone"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "find_phone"` |
| 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":"find_phone","input":{"linkedin_url":"https://www.linkedin.com/in/asha-example"}}'
```

## What comes back

`data.person` and `data.company`. The shape of a real answer from the live check of 2026-11-05, with the person and the number replaced:

```json
{
  "person": {
    "full_name": "Asha Example",
    "current_job_title": "Co-founder",
    "linkedin_url": "https://www.linkedin.com/in/asha-example",
    "mobile": {
      "status": "VERIFIED",
      "mobile": "+91 98765 43210",
      "mobile_international": "+919876543210",
      "mobile_country": "India",
      "mobile_country_code": "IN"
    }
  },
  "company": {
    "name": "Example Skincare"
  }
}
```

## Notes

- One known person per call. No reverse lookup and no bulk lists: a phone number, a personal address or a list is refused as invalid_input (free).
- Most people have no verified number on record: that is class ok_free, ₹0, with data null. Do not retry.
- The answer is not stored. Repeating an idempotency key is refused, and a new key runs and charges the call again, so keep the number you get.
- Calling or texting someone is governed by the law where they are; in India, TRAI's rules on commercial communication and the do-not-disturb registry.

## Siblings

- [`find_email`](https://parel.si/docs/tools/find_email.md) for a work address.
- [`enrich_person`](https://parel.si/docs/tools/enrich_person.md) for a person's title, employer and history.
- [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md) to find the right person first.
