{"endpoint":{"id":"treg.people.identity.resolve","provider":"treg","provider_display":"treg","name":"people.identity.resolve — routed: best of 3 providers, own keys first","summary":"Resolve a work email to the person's LinkedIn profile — treg picks the provider and names the one that served","method":"POST","path":"/people.identity.resolve","scope":"","tier":"core","kind":"routed","domain":"contacts","call_template":"treg call treg.people.identity.resolve --method POST --data '{\"email\":\"…\"}'","cost":{"type":"per_success","value":0.0198,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.0198–$0.19 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (0 of 3 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.0198},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.linkedin_url == null"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"email":{"type":"str","required":false,"note":"identity key (part of email)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({email}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"email":"…"}},"routed_children":["fiber-ai.people.identity.resolve","findymail.search.reverse-email","icypeas.people.identity.resolve"],"capability":"people.identity.resolve","capability_description":"Resolve an email or profile to linked identities","platform":"people","platform_label":"People & contact data","observed":{"samples":49627,"decided":49612,"ok_rate":0.9775,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"fiber-ai.people.identity.resolve","provider":"fiber-ai","provider_display":"Fiber AI","name":"Reverse email lookup — LinkedIn URL, name, title","summary":"Find person by email (single)","method":"POST","path":"/v1/email-to-person/single","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call fiber-ai.people.identity.resolve --method POST --data '{\"email\":\"support@fiber.ai\"}'","cost":{"type":"per_success","value":2,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://api.fiber.ai/ai-docs/reverseEmailLookup.md","checked":"2026-08-17","confidence":"documented","note":"2 credits per successful match — OBSERVED live 2026-08-20 on a resolving address (chargeInfo.creditsCharged 2); the catalogued test_request is a deliberate role-inbox MISS and settled at 0, confirming misses are free. Rate limit 3500 req/min — space requests, do not burst.","usd":0.04},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-08-20","docs_url":"https://api.fiber.ai/ai-docs/reverseEmailLookup.md","has_example":true,"input":{"bodyType":"json","body":{"email":{"type":"string","required":true,"note":"the address to resolve to a LinkedIn profile","example":"support@fiber.ai"}},"note":"operationId reverseEmailLookup. Email → LinkedIn URL, name, title, company. If you also have a name or company, KitchenSinkProfile is the stronger matcher. Role-based inboxes (info@, support@) will not resolve to a person."},"test_request":{"body":{"email":"support@fiber.ai"}},"observed":{"samples":41715,"decided":36454,"ok_rate":0.9988,"p50_ms":6285,"p95_ms":42386,"last_ok_days":0,"hit_rate":0.3424,"hit_samples":36412},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Resolved a legacy webmail address to a LinkedIn profile after a free miss, but a second provider gave a different person, so single-source hits on old domains are low confidence.","client":"claude-code","month":"2026-10"}]}},{"id":"findymail.search.reverse-email","provider":"findymail","provider_display":"Findymail","name":"Reverse email lookup — the person's LinkedIn profile","summary":"Resolve an email address back to the person's professional profile, optionally with the full profile","method":"POST","path":"/search/reverse-email","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call findymail.search.reverse-email --method POST --data '{\"email\":\"patrick@stripe.com\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://app.findymail.com/docs/","checked":"2026-08-20","confidence":"documented","note":"1 finder credit for the profile URL, 2 when with_profile=true. Nothing on a miss. The 1-vs-2 split is stated in the API docs, not on the pricing page (which only publishes the flat 1 credit = 1 verified email rate).","usd":0.0198},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-28","added":"2026-08-20","docs_url":"https://app.findymail.com/docs/","has_example":true,"input":{"body":{"email":{"type":"string","required":true,"note":"the email address to resolve","example":"patrick@stripe.com"},"with_profile":{"type":"boolean","required":false,"note":"true returns the enriched profile instead of just the profile URL — and DOUBLES the price to 2 credits","example":false}},"note":"returns {linkedin_url} by default, or an extended profile object when with_profile is true"},"test_request":{"body":{"email":"patrick@stripe.com"}},"observed":{"samples":71978,"decided":71875,"ok_rate":0.9999,"p50_ms":678,"p95_ms":5415,"last_ok_days":0,"hit_rate":0.3198,"hit_samples":71863},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Resolved a hotmail.com personal address to a full professional profile (name, title, employer, job history) with with_profile=true; a second provider returned the same LinkedIn slug.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Resolved a personal-domain email to a complete professional profile with full work history and education; with_profile=true returned the extended object as documented.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Returned a LinkedIn URL matching the person's name and company for a corporate Brazilian email.","client":"mcp","month":"2026-10"}]}},{"id":"icypeas.people.identity.resolve","provider":"icypeas","provider_display":"Icypeas","name":"Reverse email lookup — the person's profile URL","summary":"Reverse a professional email address to the person's public professional profile URL","method":"POST","path":"/reverse-email-lookup","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call icypeas.people.identity.resolve --method POST --data '{\"email\":\"collison@stripe.com\"}'","cost":{"type":"per_success","value":10,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://api-doc.icypeas.com/how-works/credit-cost","checked":"2026-08-20","confidence":"documented","note":"10 credits per FOUND profile; a miss is free","usd":0.19},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://api-doc.icypeas.com/reverse-email-lookup","has_example":true,"input":{"body":{"email":{"type":"string","required":true,"note":"a professional (work) email address — personal mailboxes rarely resolve","example":"collison@stripe.com"}},"note":"SYNCHRONOUS — the URL comes back in `result` with status FOUND or NOT_FOUND. THE MOST EXPENSIVE ROUTE HERE at 10 credits a hit; resolve in bulk only when the profile is genuinely worth it"},"test_request":{"body":{"email":"collison@stripe.com"}},"observed":{"samples":3638,"decided":3638,"ok_rate":1.0,"p50_ms":630,"p95_ms":1016,"last_ok_days":0,"hit_rate":0.0531,"hit_samples":3638}},{"id":"icypeas.people.identity.resolve.bulk","provider":"icypeas","provider_display":"Icypeas","name":"Reverse up to 50 emails to profile URLs in one call","summary":"Reverse up to 50 professional email addresses to their profile URLs in one call","method":"POST","path":"/reverse-email-lookups","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call icypeas.people.identity.resolve.bulk --method POST --data '{\"data\":[\"collison@stripe.com\",\"patrick@stripe.com\"]}'","cost":{"type":"per_result","value":10,"currency":"credit","per":1,"unit":"result","source":"docs","source_url":"https://api-doc.icypeas.com/how-works/credit-cost","checked":"2026-08-20","confidence":"documented","note":"10 credits per FOUND profile; addresses that resolve to nothing are free","usd":0.19},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://api-doc.icypeas.com/reverse-email-lookup","has_example":true,"input":{"body":{"data":{"type":"array[string]","required":true,"note":"professional email addresses — MINIMUM 2, MAXIMUM 50 per request","example":["collison@stripe.com","patrick@stripe.com"]}},"note":"SYNCHRONOUS — results come back in `data`, one entry per input address, in order. Same 10-credit-per-hit rate as the single route, so a full 50-address call can cost 500 credits: check the addresses are worth it first"},"test_request":{"body":{"data":["collison@stripe.com","patrick@stripe.com"]}},"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"leadmagic.x.b2b-profile","provider":"leadmagic","provider_display":"LeadMagic","name":"Reverse email lookup — the person's profile URL","summary":"Performs reverse email lookup to identify professional profile URLs associated with work or personal email addresses","method":"POST","path":"/v1/people/b2b-profile","scope":"","tier":"extended","kind":"data","domain":"contacts","call_template":"treg call leadmagic.x.b2b-profile --method POST --data '{\"work_email\":\"press@leadmagic.io\"}'","cost":{"type":"per_success","value":10,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://leadmagic.io/pricing","checked":"2026-08-16","confidence":"verified","note":"VERIFIED live 2026-08-16 by LeadMagic's own echo: a hit answered credits_consumed: 10 (charged $0.25 exactly), a miss credits_consumed: 0 (charged $0). The 'b2b overstatement' suspicion from the August sweep was checked and REFUTED for this endpoint — the over-billing it was blamed for was the settle bug fixed in d458ee5","usd":0.25},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","added":"2026-07-28","docs_url":"https://leadmagic.io/docs/api-reference/email-to-profile","has_example":true,"input":{"bodyType":"json","body":{"work_email":{"type":"string","required":false,"example":"jane@leadmagic.io"},"personal_email":{"type":"string","required":false}},"note":"at least one of work_email | personal_email is required"},"test_request":{"bodyType":"json","body":{"work_email":"press@leadmagic.io"}},"observed":{"samples":76,"decided":73,"ok_rate":1.0,"p50_ms":714,"p95_ms":2334,"last_ok_days":3,"hit_rate":0.1167,"hit_samples":60}},{"id":"leadsforge.people.identity.resolve.bulk","provider":"leadsforge","provider_display":"LeadsForge","name":"Start a bulk job — name + company to LinkedIn URL","summary":"Request linkedin profile finding.","method":"POST","path":"/enrichment/linkedin","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call leadsforge.people.identity.resolve.bulk --method POST --data '{\"people\":[{\"firstName\":\"Patrick\",\"lastName\":\"Collison\",\"company\":\"Stripe\"}],\"clientRequestID\":\"treg-verify-2\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"row","source":"docs","source_url":"https://www.leadsforge.ai/pricing","checked":"2026-08-20","confidence":"documented","note":"1 credit per profile found; misses free. Observed live: reservedCredits 1 at submit, consumedCredits 1 on completion","usd":0.0245},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"headers":{"Idempotency-Key":{"type":"string","required":false,"note":"retry-safe","example":"treg-li-2026-08-20-1"}},"body":{"people":{"type":"array","required":false,"note":"max 500; {firstName, lastName, company} (+ optional externalID) — resolve a name at a company to their LinkedIn profile URL","example":[{"firstName":"Patrick","lastName":"Collison","company":"Stripe"}]},"personIDs":{"type":"array","required":false,"note":"ids from leadsforge.people.search","example":["p_abc123"]},"clientRequestID":{"type":"string","required":false,"example":"my-request-123"},"webhookURL":{"type":"string","required":false},"saveToList":{"type":"boolean","required":false}},"note":"the reverse of the other two channels: you bring a name + company and get back the profile URL, which then unlocks the email/phone routes."},"test_request":{"body":{"people":[{"firstName":"Patrick","lastName":"Collison","company":"Stripe"}],"clientRequestID":"treg-verify-2"}},"observed":{"samples":30,"decided":29,"ok_rate":0.9655,"p50_ms":1273,"p95_ms":22343,"last_ok_days":2,"hit_rate":null,"hit_samples":0}},{"id":"limadata.people.identity.resolve","provider":"limadata","provider_display":"LimaData","name":"Resolve a person's social profiles","summary":"Find social profiles from a person's name and company or work email.","method":"POST","path":"/api/v1/find/profiles_person","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call limadata.people.identity.resolve --method POST --data '{\"full_name\":\"Treg Missing Person\",\"company_domain\":\"example.com\"}'","cost":{"type":"per_call","value":2,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://api.limadata.com/docs/basic_v2","checked":"2026-09-17","confidence":"verified","note":"Two credits on every call, including a 404 miss. Live discovery confirmed the 404 charge.","usd":0.04},"async":null,"platform_eligible":false,"platform_blocked":"LimaData bills 404 misses, while the generic platform settlement releases holds on upstream errors; connect your own LimaData key.","miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-17","added":"2026-09-17","docs_url":"https://api.limadata.com/docs/basic_v2","has_example":true,"input":{"bodyType":"json","body":{"full_name":{"type":"string","required":true,"example":"Example Person"},"company_name":{"type":"string","required":false},"company_domain":{"type":"string","required":false,"example":"example.com"},"email":{"type":"string","required":false,"example":"person@example.com"}},"note":"Provide full name and at least one company or work-email identifier."},"test_request":{"body":{"full_name":"Treg Missing Person","company_domain":"example.com"}},"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}}],"related_capabilities":[{"endpoint_id":"treg.people.email.find","capability":"people.email.find","does":"Get, find or look up a person's work email address from their name, company domain or LinkedIn profile"},{"endpoint_id":"treg.people.email.find.personal","capability":"people.email.find.personal","does":"Find a person's personal email address"},{"endpoint_id":"treg.people.email.verify","capability":"people.email.verify","does":"Check an email address you ALREADY have is real and deliverable — not for finding one"},{"endpoint_id":"treg.people.enrich","capability":"people.enrich","does":"Fill in a person's profile from a LinkedIn URL or other identifier you already hold — job title, employer, seniority, location"},{"endpoint_id":"treg.people.phone.find","capability":"people.phone.find","does":"Find someone's phone number"}],"routing":{"contract":{"identity":[["email"]],"output":{"linkedin_url":{"type":"str","required":true},"full_name":{"type":"str"}},"miss":"linkedin_url == null","derive":{}},"plan":[{"endpoint_id":"findymail.search.reverse-email","accepts":[["email"]],"usd":0.0198,"hit_rate":0.3198,"usd_per_hit":0.0198,"works":0.9999},{"endpoint_id":"fiber-ai.people.identity.resolve","accepts":[["email"]],"usd":0.04,"hit_rate":0.3424,"usd_per_hit":0.04,"works":0.9988},{"endpoint_id":"icypeas.people.identity.resolve","accepts":[["email"]],"usd":0.19,"hit_rate":0.0531,"usd_per_hit":0.19,"works":1.0}],"also":[{"endpoint_id":"icypeas.people.identity.resolve.bulk","usd":0.19},{"endpoint_id":"leadmagic.x.b2b-profile","usd":0.25},{"endpoint_id":"leadsforge.people.identity.resolve.bulk","usd":0.0245},{"endpoint_id":"limadata.people.identity.resolve","usd":0.04}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters"}},"call_template":"treg call treg.people.identity.resolve --method POST --data '{\"email\":\"…\"}'","example_response":null,"hints":["treg call treg.people.identity.resolve --method POST --data '{\"email\":\"…\"}'   # run it — key injected server-side","treg catalog get fiber-ai.people.identity.resolve   # the same job from fiber-ai"]}