New You can now run your Gelee campaigns from Claude, ChatGPT or Cursor. Read the docs →

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.

Last updated 5 November 2026

What it costs

Credits per lookup
Mobile number found44 credits
Personal mobiles only. Office lines and switchboards are skipped, free.
Work email found2 credits
Verified addresses only. A company that accepts any address can't be verified: shown as unverified, free.
Not found0 credits
Misses are always free.

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

POST/lookupsread_write

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.

Body
kindstringrequired
phone, email, or both (each find is charged on its own).
person_idsarray
People ids from GET /people. Use this or filter.
filter.positive_repliesboolean
Everyone who replied with interest.
filter.new_leads_daysinteger
Leads added in the last N days (1 to 365).
filter.stagestring
booked, replied, messaged, connection_sent, qualified, stalled or completed.
dry_runboolean
The estimate only.

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
    }
  }'
Response
{ "run_id": "6f1c…", "status": "running",
  "people": 120, "already_saved": 14, "to_look_up": 106,
  "max_credits": 4664, "credits_left": 5200 }

Check a run

GET/lookups/{run_id}

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"
Response
{ "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.