Find Phone Number
find_phone_numberPass a list of LinkedIn profile URLs — one entry for a single person, all of
them at once for a batch (they are looked up in parallel, costing one tool
call against the loop guard, not N). Returns one result per URL in the same
order. Airscale brokers providers like RocketReach. Persists nothing — use
the returned numbers however the agent needs them (e.g. tell the user, or
stash them on prospects via update_prospect).
A LinkedIn profile URL is the only accepted input — this tool cannot look a
person up by email or name. When a record (a HubSpot/CRM contact, a prospect
row, a spreadsheet line) has no LinkedIn URL but does have the person's
email, first call find_linkedin_url(email=...) to resolve one, then pass
that URL here. Apply this resolve-then-lookup step to every record, not just
the first; skip the phone lookup for any person you cannot get a URL for.
Costs 8 Sliq credits per number found, when run on Sliq's shared Airscale
account. Misses (no number on file) and upstream failures are free. A
worst-case check runs up front on the Sliq path: the whole batch is refused
unless the balance covers 8 credits per URL (any URL could be a hit). So
no API call is ever spent on a lookup that can't be billed, and a user low
on credits is told to top up or connect their own key. If the user has
connected their own Airscale key (BYO, via the integrations page), lookups
run against that account instead — no Sliq credit gate and no Sliq credit
charge.
A list of result dicts in input order.
Per hit: {status: 'success', found: True, phone_number, phone_numbers, provider, linkedin_url, credits_charged: 8} (0 on the BYO path) —
phone_number is the first number, phone_numbers the full list.
Per miss: {..., found: False, phone_number: None, phone_numbers: [], credits_charged: 0}. A malformed (non-LinkedIn) URL or
an upstream failure on one URL becomes a per-item {found: False, error, credits_charged: 0} in that slot — it never aborts the rest of the batch.
If the up-front worst-case credit check fails, it raises
InsufficientCreditsError (no lookups are attempted).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| linkedin_urls | Yes | LinkedIn profile URLs, e.g. ["https://www.linkedin.com/in/janedoe"]. |