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_descriptionorenrich_person.
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 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
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:
{
"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_emailfor a work address.enrich_personfor a person's title, employer and history.search_people_by_descriptionto find the right person first.
This page as Markdown: /docs/tools/find_phone.md. Something wrong or missing: hello@parel.si.