Reference
Phone and email lookups
Find a lead's mobile number or verified work email. It runs in the background for any number of leads, and you only pay credits when something is found.
What it costs
Lookups use credits you buy, not the monthly credits each account includes. Anything found is saved on the lead, so the same person is never charged twice. Blacklisted and do-not-contact people, your own LinkedIn accounts and numbers marked wrong are never looked up. If credits run out, the run pauses and can carry on after you add more.
Find phones or emails
Pick leads by id, or by a filter. Send dry_run: true to get the counts and the most it can cost without running anything.
Answers 202 with a run_id. One run at a time per workspace (409 while one is going); 402 when there are no credits to spend.
curl -X POST "https://www.gelee.ai/api/v1/lookups" \
-H "Authorization: Bearer gk_your_key" \
-H "Content-Type: application/json" \
-d '{
"kind": "phone",
"filter": {
"positive_replies": true
}
}'{ "run_id": "6f1c…", "status": "running",
"people": 120, "already_saved": 14, "to_look_up": 106,
"max_credits": 4664, "credits_left": 5200 }Check a run
status is running, done, paused_no_credits, stopped or failed. Results arrive once it has finished. Found numbers and emails also show on GET /people and GET /people/{id} as phone and email.
curl "https://www.gelee.ai/api/v1/lookups/6f1c…" \
-H "Authorization: Bearer gk_your_key"{ "run_id": "6f1c…", "kind": "phone", "status": "done",
"requested": 106, "done": 106, "found": 71, "credits_charged": 3124,
"results": [{ "person_id": "…", "kind": "phone", "status": "found",
"value": "+14155550120", "credits": 44 }] }From Claude or ChatGPT
With the Gelee MCPconnected, ask for it in plain words: "find mobile numbers for my positive replies". The find_contacts tool shows how many people and the most it can cost, and runs only when you say yes. lookup_status shows how far it has got.