get_person_phones
Acquire or re-fetch billable phone contact data for one Person by person_id (same string as REST PersonKey, e.g. p4290). PropertyRadar covers all 50 US states and DC nationwide. Required: person_id. Optional: fields (default Standard; Standard and All return the same five Product phone ids). Returns phone contact data in results[] with data_acquisition_status (acquired, my_data, or unavailable). Bills one fixed billable hit when contact data is newly acquired; my_data and unavailable are non-billable (total_cost=0). No count_only quote on this tool. Typical chain: get_property_persons → take PersonID from a row → get_person_phones when the user wants phones only. Sibling contact data tools: get_person_emails, get_person_relatives. Not for property-scoped person fetch (use get_property_persons). User outreach compliance (TCPA/CCPA) remains the subscriber responsibility.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"personId": "<personId>"
},
"name": "get_person_phones"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | ||
| personId | Yes |