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 or enrich_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.

FieldTypeRequiredDescription
emailstringone ofThe person's work address. Personal addresses are refused.
full_namestringone ofWith one of company_name, company_website or company_linkedin_url.
last_namestringone ofWith first_name and one company field.
first_namestringone ofWith last_name and one company field.
company_namestringone ofThe person's employer.
linkedin_urlstringone ofThe person's LinkedIn profile URL (linkedin.com/in/...). The strongest key.
company_websitestringone ofThe employer's website ("intercom.com").
company_linkedin_urlstringone ofThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "find_phone"
Over RESTPOST https://api.parel.si/v1/run with "tool": "find_phone"
Confirmationnot 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

This page as Markdown: /docs/tools/find_phone.md. Something wrong or missing: hello@parel.si.