Enrich a list's people
enrich_listUse this when the user wants the missing work email addresses or phone numbers found for the people on a list. Starts a job that fills in what each row lacks and saves it on the rows; it answers with the job at once. A run covers up to maxRows rows (10,000 at most) from offset, so a longer list takes several runs. Charged per value found: an email $0.02 from the package or $0.05 from the waterfall, a phone number $0.05 or $0.10. Values a person already had are free. When the job starts, the most it can cost is held from the balance (up to $0.15 a row), and the rest is released when it ends. maxSpendUsd is the most this job may cost: $100 unless the user states another amount. Never raise it yourself. A job that could cost more is refused, stating the amount, and nothing is held. Company lists are refused. Calling again starts a second job.
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": {
"listId": "<listId>"
},
"name": "enrich_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| find | No | What to find: a work `email` (the default), a `phone` number, or both (`email_and_phone`). | |
| listId | Yes | The people list whose rows to enrich. | |
| offset | No | How many of the list's rows, in its order, to skip before the run starts: 0 when left out. Enrich a long list in runs, each with `offset` where the last one ended. | |
| maxRows | No | The most rows to enrich, from 1 to 10,000. Left out, the job runs over every row up to that many. | |
| providers | No | Where to look: `package` (the default) searches our own data package; `waterfall` searches the package, then a fixed series of further providers. A value's price depends on who found it. | package |
| maxSpendUsd | No | The most this job may cost, in US dollars. Leave it out unless the user stated an amount. |