Find mobile numbers
find_mobile_numbersLook up mobile phone numbers in the contact database for people from a finished search or campaign Golden List, with a confirmation preview and credit cost before charging.
Instructions
Looks up mobile phone numbers in the contact database for the people of a finished find_people search or other task (goal_id), or of a campaign's Golden List (campaign_id). Each mobile number found costs credits_per_number credits (8); people with no mobile number, or no contact database record, cost nothing and are marked unavailable. A call without confirm=true looks nothing up and returns needs_confirmation, will_happen (who would be looked up and the most it can cost) and the account's credits_left. With confirm=true the lookup starts and the call returns within about three minutes with status finished or still_running and the people's rows: mobile_phone, phone_status (a number's status, unavailable or lookup pending), phone_dnc (true when the number is on the Do Not Call list, false when checked and absent, null when not checked), phone_confidence, phone_source and phone_date. A repeat call while a lookup runs never starts or charges a second one. status upgrade_required means credits are used up; upgrade_url is then the plans page. No prospect outreach.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_mobile_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | ||
| goal_id | No | ||
| campaign_id | No | ||
| idempotency_key | No |