{"query":"company enrichment","count":18,"total":18,"results":[{"id":"companyenrich.companies.enrich.bulk.status","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Check a bulk enrichment job","summary":"Returns the current status of a bulk enrichment job — once completed, includes the results_url to download the enrichment results","method":"GET","path":"/companies/enrich/bulk/{jobId}","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call companyenrich.companies.enrich.bulk.status --query jobId=01a01ca2-932a-7b00-bc07-9417bb2a2b58","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"documented FREE and confirmed live 2026-08-20 — polling did not move the credit meter","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/get_companies-enrich-bulk-jobid","has_example":true,"input":{"pathParams":{"jobId":{"type":"string","required":true,"note":"the `job_id` returned by companyenrich.companies.enrich.bulk.start","example":"01a01ca2-932a-7b00-bc07-9417bb2a2b58"}},"note":"the poll half of the async pair, and FREE — so poll as often as you like. status goes pending → processing → completed; `credits_charged` stays 0 until completion, then reports the real spend. `results_url` is a pre-signed download link that only appears on the completed response. Observed end-to-end time for a 1-domain job: about 30 seconds."},"test_request":{"pathParams":{"jobId":"01a01ca2-932a-7b00-bc07-9417bb2a2b58"}},"capability":"companies.enrich.bulk.status","capability_description":"Check a bulk company-enrichment job","platform":"companies","platform_label":"Company data","score":21.3912,"observed":{"samples":55,"decided":55,"ok_rate":1.0,"p50_ms":371,"p95_ms":555,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"companyenrich.companies.enrich.bulk.start","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Start a bulk enrichment job (up to 10,000 domains)","summary":"Creates an asynchronous bulk enrichment job for up to 10,000 domains — returns a job ID immediately","method":"POST","path":"/companies/enrich/bulk","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call companyenrich.companies.enrich.bulk.start --method POST --data '{\"domains\":[\"anthropic.com\"]}'","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://companyenrich.com/pricing","checked":"2026-08-20","confidence":"verified","note":"1 credit per domain SUCCESSFULLY enriched, charged when the job completes (not at submission). VERIFIED 2026-08-20: a 1-domain job reported credits_charged 1 on completion and the account meter moved by 1.","usd":0.0098},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/post_companies-enrich-bulk","has_example":true,"input":{"body":{"domains":{"type":"array[string]","required":true,"note":"1-10,000 company domains. THIS IS THE PRICE — 1 credit per domain successfully enriched, charged on completion","example":["anthropic.com"]},"webhook_url":{"type":"string","required":false,"note":"callback URL fired on completion. Not usable through a proxied call — poll companyenrich.companies.enrich.bulk.status instead, which is free"}},"note":"returns {job_id, status, total_domains, estimated_credits} in milliseconds and does the work in the background. Credits are charged ON COMPLETION and only for domains that actually enriched, so `estimated_credits` is an upper bound. Poll the status route (free) until status is `completed`, then download `results_url`."},"test_request":{"body":{"domains":["anthropic.com"]}},"capability":"companies.enrich.bulk.start","capability_description":"Queue a bulk company-enrichment job","platform":"companies","platform_label":"Company data","score":21.3912,"observed":{"samples":26,"decided":23,"ok_rate":1.0,"p50_ms":501,"p95_ms":662,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"companyenrich.companies.enrich.bulk.jobs","provider":"companyenrich","provider_display":"CompanyEnrich","name":"List your bulk enrichment jobs","summary":"Returns a paginated list of all bulk enrichment jobs for the authenticated user","method":"GET","path":"/companies/enrich/bulk/jobs","scope":"own_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call companyenrich.companies.enrich.bulk.jobs --query pageSize=5","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"documented FREE and confirmed live 2026-08-20","usd":0.0},"async":null,"platform_eligible":false,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/get_companies-enrich-bulk-jobs","has_example":true,"input":{"queryParams":{"page":{"type":"integer","required":false,"note":"1-based, default 1"},"pageSize":{"type":"integer","required":false,"note":"default 20, max 100","example":5},"status":{"type":"string","required":false,"note":"filter by pending | processing | completed | failed"}},"note":"FREE. Each row carries credits_charged, so this doubles as the spend audit for bulk enrichment."},"test_request":{"queryParams":{"pageSize":5}},"capability":"companies.enrich.bulk.list","capability_description":"List your bulk company-enrichment jobs","platform":"companies","platform_label":"Company data","score":21.3912,"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":"treg.companies.enrich","provider":"treg","provider_display":"treg","name":"companies.enrich — routed: best of 27 providers, own keys first","summary":"Enrich a company from its domain, name, LinkedIn URL or a work email — treg picks the provider and names the one that served","method":"POST","path":"/companies.enrich","scope":"","tier":"core","kind":"routed","domain":"companies","call_template":"treg call treg.companies.enrich --method POST --data '{\"domain\":\"stripe.com\"}'","cost":{"type":"per_success","value":0.0018,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.0018–$0.38 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (7 of 27 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.0018},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.name == null"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"domain":{"type":"str","required":false,"note":"identity key (part of domain)"},"website":{"type":"url","required":false,"note":"identity key (part of website)"},"name":{"type":"str","required":false,"note":"identity key (part of name)"},"linkedin_url":{"type":"url","required":false,"note":"identity key (part of linkedin_url)"},"linkedin_handle":{"type":"str","required":false,"note":"identity key (part of linkedin_handle)"},"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 ({domain} | {website} | {name} | {linkedin_url} | {linkedin_handle} | {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":{"domain":"stripe.com"}},"routed_children":["apollo.companies.enrich","aviato.companies.enrich","branddev.brand.retrieve","branddev.brand.retrieve-by-name","branddev.brand.retrieve-by-email","companyenrich.companies.enrich","companyenrich.companies.enrich.by_properties","contactout.companies.enrich","datagma.companies.enrich","dropleads.companies.enrich","enrichlayer.company.profile","fiber-ai.companies.enrich","findymail.search.company","harvestapi.linkedin.company.profile","hunter.companies.enrich","icypeas.companies.enrich","leadmagic.companies.enrich","limadata.companies.enrich","lusha.companies.enrich","pdl.companies.enrich","predictleads.companies.enrich","prospeo.companies.enrich","sumble.organizations","thecompaniesapi.companies.enrich","thecompaniesapi.companies.enrich_by_email","tomba.companies.enrich","wiza.companies.enrich"],"capability":"companies.enrich","capability_description":"Enrich a company from its domain or name","platform":"companies","platform_label":"Company data","score":16.3737,"observed":{"samples":402369,"decided":401505,"ok_rate":0.7223,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"prospeo.companies.enrich","provider":"prospeo","provider_display":"Prospeo","name":"Company lookup and enrichment","summary":"Enrich a company with firmographic, funding, technology and hiring data.","method":"POST","path":"/enrich-company","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call prospeo.companies.enrich --method POST --data '{\"data\":{\"company_website\":\"intercom.com\"}}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://prospeo.io/api-docs/enrich-person","checked":"2026-09-16","confidence":"verified","note":"One credit per matched company; a miss or free_enrichment=true is free.","usd":0.0245},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-16","docs_url":"https://prospeo.io/api-docs/enrich-company","has_example":true,"input":{"bodyType":"json","body":{"data":{"type":"object","required":true,"example":{"company_website":"intercom.com"},"note":"Identify a company with company_website, company_linkedin_url, company_name or a Prospeo company_id. Prefer website or LinkedIn URL over name alone."}}},"test_request":{"body":{"data":{"company_website":"intercom.com"}}},"capability":"companies.enrich","capability_description":"Enrich a company from its domain or name","platform":"companies","platform_label":"Company data","score":16.3737,"observed":{"samples":4382,"decided":499,"ok_rate":1.0,"p50_ms":235,"p95_ms":990,"last_ok_days":0,"hit_rate":1.0,"hit_samples":495}},{"id":"akta.companies.enrich","provider":"akta","provider_display":"Akta by Wokelo","name":"Company enrichment by website — firmographics, tech stack","summary":"Enrich a company from its website — firmographics, financials, tech stack, management","method":"GET","path":"/v1/company/enrichment/","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call akta.companies.enrich --query company=canva.com --query sections=location","cost":{"type":"per_success","value":17.5,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://docs.akta.pro/getting-started/pricing","checked":"2026-08-07","confidence":"documented","note":"Priced PER SECTION requested, all rates documented on the rate card: 2 credits each for firmographic, business_model, company_assessment, product_offering and technology; 1.5 for management_profile and strategic_signal; 1 for customer_profile and industry; 0.5 for trust_signal, company_hierarchy, digital_presence, financial_estimate and location; 3 for the Enterprise-only funding_detail and 5 for mna_and_investment. value is the UPPER BOUND — every standard (non-Enterprise) section at once = 17.5 credits; it sizes the hold and the displayed price, while the settle charges the actual `credits_consumed` the response reports (see api._observed_cost_micro), so a sections=location call costs the documented 0.5 credits, not 17.5. OBSERVED 2026-07-31: the test_request (sections=location) reported credits_consumed 0.50, exactly the rate card's figure. Credits are $0.05 pay-as-you-go, $0.04 on subscription.","usd":0.875},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-31","docs_url":"https://docs.akta.pro/api-reference/company-data","has_example":true,"input":{"queryParams":{"company":{"type":"string","required":true,"note":"company website (with or without protocol) or an Akta company UUID such as 00031n-tesla","example":"https://canva.com"},"sections":{"type":"string","required":false,"note":"comma-separated sections to return, so you pay for only what you need: firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology. Enterprise tier adds funding_detail and mna_and_investment","example":"firmographic"}},"note":"resolve an unknown company name to its website or UUID with akta.companies.search first — that step is free. Ask for only the sections you need: this endpoint bills per section"},"test_request":{"queryParams":{"company":"canva.com","sections":"location"}},"capability":"companies.enrich","capability_description":"Enrich a company from its domain or name","platform":"companies","platform_label":"Company data","score":16.3737,"observed":{"samples":10,"decided":8,"ok_rate":1.0,"p50_ms":890,"p95_ms":1454,"last_ok_days":0,"hit_rate":null,"hit_samples":2}},{"id":"branddev.brand.retrieve-by-email","provider":"branddev","provider_display":"Context.dev","name":"Company brand profile by work email","summary":"Turn a work email address into the employer's brand record — the signup-form enrichment call","method":"GET","path":"/brand/retrieve-by-email","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call branddev.brand.retrieve-by-email --query email=support@stripe.com --query maxSpeed=true","cost":{"type":"per_success","value":10,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://www.context.dev/pricing","checked":"2026-08-20","confidence":"verified","note":"observed credits_consumed = 10","usd":0.02534},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.context.dev/api-reference/brand-intelligence/brand","has_example":true,"input":{"queryParams":{"email":{"type":"string","required":true,"note":"a work email; free / disposable mailbox providers are rejected","example":"support@stripe.com"},"maxSpeed":{"type":"boolean","required":false,"example":true},"maxAgeMs":{"type":"integer","required":false},"timeoutMS":{"type":"integer","required":false}},"note":"this enriches the COMPANY behind the address, never the person — no personal data is returned for the mailbox itself"},"test_request":{"queryParams":{"email":"support@stripe.com","maxSpeed":"true"}},"capability":"companies.enrich","capability_description":"Enrich a company from its domain or name","platform":"companies","platform_label":"Company data","score":16.3737,"observed":{"samples":3,"decided":3,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":3}},{"id":"wiza.companies.enrich","provider":"wiza","provider_display":"Wiza","name":"Enrich a company","summary":"Enrich a company with industry, size, revenue, funding, location and social profiles.","method":"POST","path":"/api/company_enrichments","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call wiza.companies.enrich --method POST --data '{\"company_domain\":\"wiza.co\"}'","cost":{"type":"per_success","value":2,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://docs.wiza.co/api-reference/company-enrichment/company-enrichment","checked":"2026-09-16","confidence":"verified","note":"Two API credits when company data is found. A miss or invalid request is free. The response reports credits.api_credits.total.","usd":0.05},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-16","docs_url":"https://docs.wiza.co/api-reference/company-enrichment/company-enrichment","has_example":true,"input":{"bodyType":"json","body":{"company_name":{"type":"string","required":false,"example":"Wiza"},"company_domain":{"type":"string","required":false,"example":"wiza.co"},"company_linkedin_id":{"type":"string","required":false,"example":"67160217"},"company_linkedin_slug":{"type":"string","required":false,"example":"wiza"}},"note":"Provide at least one company identifier. Domain or LinkedIn identity is more precise than name alone."},"test_request":{"body":{"company_domain":"wiza.co"}},"capability":"companies.enrich","capability_description":"Enrich a company from its domain or name","platform":"companies","platform_label":"Company data","score":11.3563,"observed":{"samples":61,"decided":26,"ok_rate":1.0,"p50_ms":461,"p95_ms":836,"last_ok_days":0,"hit_rate":1.0,"hit_samples":26}},{"id":"companyenrich.jobs.list","provider":"companyenrich","provider_display":"CompanyEnrich","name":"List every background job on the account","summary":"Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user","method":"GET","path":"/jobs","scope":"own_account","tier":"core","kind":"utility","domain":"account","call_template":"treg call companyenrich.jobs.list --query pageSize=5","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"documented FREE and confirmed live 2026-08-20","usd":0.0},"async":null,"platform_eligible":false,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/get_jobs","has_example":true,"input":{"queryParams":{"page":{"type":"integer","required":false,"note":"1-based, default 1"},"pageSize":{"type":"integer","required":false,"note":"default 20, max 100","example":5},"status":{"type":"string","required":false,"note":"pending | processing | completed | failed"},"type":{"type":"string","required":false,"note":"bulk_enrichment, and the other job types"}},"note":"FREE, and the ONE view across every async job type — the per-type job lists only show their own kind. Each row carries credits_charged, so this is the account-wide spend audit for async work."},"test_request":{"queryParams":{"pageSize":5}},"capability":"account.jobs.list","capability_description":"List every background job on your account","platform":"account","platform_label":"The provider account itself — usage, quota, balance (not a content platform)","score":12.1478,"observed":null},{"id":"companyenrich.people.email.bulk.status","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Check a bulk work-email lookup job","summary":"Returns the current status of a bulk person email enrichment job — once completed, includes the results_url to download the full results","method":"GET","path":"/people/email/bulk/{jobId}","scope":"any_account","tier":"core","kind":"data","domain":"people","call_template":"treg call companyenrich.people.email.bulk.status --query jobId=01a01ca3-7120-7ee5-beba-a7bc64de4ea7","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"documented FREE and confirmed live 2026-08-20","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/get_people-email-bulk-jobid","has_example":true,"input":{"pathParams":{"jobId":{"type":"string","required":true,"note":"the `job_id` from companyenrich.people.email.bulk.start","example":"01a01ca3-7120-7ee5-beba-a7bc64de4ea7"}},"note":"FREE poll. Breaks the outcome down into found_count / not_found_count / unavailable_count and reports the settled credits_charged, so it is also the receipt. `results_url` is a pre-signed download link present only once the job completes."},"test_request":{"pathParams":{"jobId":"01a01ca3-7120-7ee5-beba-a7bc64de4ea7"}},"capability":"people.email.bulk.status","capability_description":"Check a bulk work-email lookup job","platform":"people","platform_label":"People & contact data","score":12.1478,"observed":{"samples":2,"decided":2,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"companyenrich.people.email.bulk.start","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Start a bulk work-email lookup (beta, up to 1,000 people)","summary":"Creates an asynchronous bulk person email enrichment job for up to 1,000 lookup items","method":"POST","path":"/people/email/bulk","scope":"any_account","tier":"core","kind":"data","domain":"people","call_template":"treg call companyenrich.people.email.bulk.start --method POST --data '{\"items\":[{\"person_id\":256474769,\"domain\":\"stripe.com\"}]}'","cost":{"type":"per_success","value":10,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://companyenrich.com/pricing","checked":"2026-08-20","confidence":"documented","note":"up to 10 credits per item, charged on completion for newly accessed FOUND emails only — not-found items and addresses already bought are free. The live 2026-08-20 test job completed with credits_charged 0 because its one address had been resolved minutes earlier by the single-lookup route, which confirms the already-accessed exemption but leaves the 10-credit case documented rather than observed here.","usd":0.098},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/post_people-email-bulk","has_example":true,"input":{"body":{"items":{"type":"array[object]","required":true,"note":"1-1,000 objects of {person_id (required, integer), domain (optional string)}. NOTE the field is `person_id`, not `id` — using `id` is rejected with a bodyless HTTP 400","example":[{"person_id":256474769,"domain":"stripe.com"}]},"webhook_url":{"type":"string","required":false,"note":"callback on completion; poll the free status route instead when calling through a proxy"}},"note":"the batch form of companyenrich.people.email. Returns {job_id, status, total_requests, estimated_credits} immediately; `estimated_credits` assumes every lookup succeeds and is charged fresh, so it is a strict upper bound. Completed jobs report found_count / not_found_count / unavailable_count separately."},"test_request":{"body":{"items":[{"person_id":256474769,"domain":"stripe.com"}]}},"capability":"people.email.bulk.start","capability_description":"Queue a bulk work-email lookup job","platform":"people","platform_label":"People & contact data","score":12.1478,"observed":{"samples":2,"decided":2,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"treg.people.email.find","provider":"treg","provider_display":"treg","name":"people.email.find — routed: best of 23 providers, own keys first","summary":"Find someone's work email — treg picks the provider (own keys first, then cheapest per hit) and tells you which one served","method":"POST","path":"/people.email.find","scope":"","tier":"core","kind":"routed","domain":"contacts","call_template":"treg call treg.people.email.find --method POST --data '{\"linkedin_url\":\"https://www.linkedin.com/in/patrickcollison\"}'","cost":{"type":"per_success","value":0.004834,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.004834–$0.15 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (1 of 23 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.004834},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.email == null"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"domain":{"type":"str","required":false,"note":"identity key (part of domain+full_name, domain+first_name+last_name)"},"full_name":{"type":"str","required":false,"note":"identity key (part of domain+full_name)"},"first_name":{"type":"str","required":false,"note":"identity key (part of domain+first_name+last_name)"},"last_name":{"type":"str","required":false,"note":"identity key (part of domain+first_name+last_name)"},"linkedin_url":{"type":"url","required":false,"note":"identity key (part of linkedin_url)"},"linkedin_handle":{"type":"str","required":false,"note":"identity key (part of linkedin_handle)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({domain, full_name} | {domain, first_name, last_name} | {linkedin_url} | {linkedin_handle}) 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":{"linkedin_url":"https://www.linkedin.com/in/patrickcollison"}},"routed_children":["aiark.people.email.find","aviato.people.email.find","contactout.people.contact.work","datagma.people.email.find","dropleads.people.email.find","fiber-ai.people.contacts.reveal","fiber-ai.people.contacts.turbo","findymail.search.name","findymail.search.business-profile","harvestapi.linkedin.user.profile.email","hunter.people.email.find","leadmagic.x.personal-email-finder","leadmagic.people.email.find","leadsforge.people.email.find","limadata.people.email.find.name","limadata.people.email.find.linkedin","moltsets.people.email.find.name","prospeo.people.email.find","quickenrich.people.email.find","tomba.people.email.find","tomba.people.email.find.linkedin","trykitt.people.email.find","wiza.people.email.find"],"capability":"people.email.find","capability_description":"Get, find or look up a person's work email address from their name, company domain or LinkedIn profile","platform":"people","platform_label":"People & contact data","score":11.3563,"observed":{"samples":1133829,"decided":1129062,"ok_rate":0.8604,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"leadsforge.people.email.find","provider":"leadsforge","provider_display":"LeadsForge","name":"Find a work email by LinkedIn URL or name + company","summary":"Enrich a single person's work email and return the result in the same response, no polling.","method":"POST","path":"/enrichment/email","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call leadsforge.people.email.find --method POST --data '{\"firstName\":\"Patrick\",\"lastName\":\"Collison\",\"companyDomain\":\"stripe.com\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://www.leadsforge.ai/pricing","checked":"2026-08-20","confidence":"documented","note":"1 credit on a hit, nothing on a miss. Confirmed live: balance 100 -> 99 on one successful call, and GET /balance reports emailEnrichmentPrice=1","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","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"body":{"personID":{"type":"string","required":false,"note":"id from leadsforge.people.search — the most reliable input","example":"p_abc123"},"linkedinURL":{"type":"string","required":false,"note":"profile URL, used when you have no personID","example":"https://www.linkedin.com/in/john-doe"},"firstName":{"type":"string","required":false,"note":"with lastName plus a company signal","example":"Patrick"},"lastName":{"type":"string","required":false,"example":"Collison"},"companyDomain":{"type":"string","required":false,"note":"preferred company signal over `company`","example":"stripe.com"},"company":{"type":"string","required":false,"note":"company NAME, not a URL","example":"Stripe"},"externalID":{"type":"string","required":false,"note":"max 128 chars, echoed back verbatim for CRM correlation","example":"crm-contact-42"}},"note":"one of personID | linkedinURL | firstName+lastName+company signal is required. A miss is free."},"test_request":{"body":{"firstName":"Patrick","lastName":"Collison","companyDomain":"stripe.com"}},"capability":"people.email.find","capability_description":"Get, find or look up a person's work email address from their name, company domain or LinkedIn profile","platform":"people","platform_label":"People & contact data","score":11.3563,"observed":{"samples":172749,"decided":171485,"ok_rate":0.9998,"p50_ms":3907,"p95_ms":11857,"last_ok_days":0,"hit_rate":0.0984,"hit_samples":171455}},{"id":"leadsforge.people.email.find.bulk","provider":"leadsforge","provider_display":"LeadsForge","name":"Start a bulk work-email job","summary":"Request email finding.","method":"POST","path":"/enrichment/emails","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call leadsforge.people.email.find.bulk --method POST --data '{\"people\":[{\"firstName\":\"Patrick\",\"lastName\":\"Collison\",\"company\":\"Stripe\",\"externalID\":\"crm-42\"}],\"clientRequestID\":\"treg-verify-1\"}'","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 email found; misses free. Credits are reserved at submit (job.reservedCredits) and settled on completion (job.consumedCredits). A person already revealed on this account re-resolves for 0 — observed 2026-08-20","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","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"headers":{"Idempotency-Key":{"type":"string","required":false,"note":"a retried request with the same key returns the original job instead of charging again","example":"treg-emails-2026-08-20-1"}},"body":{"people":{"type":"array","required":false,"note":"max 500; each item is {linkedinURL} OR {firstName, lastName, company}, plus optional externalID (max 128 chars). Mutually exclusive with personIDs","example":[{"firstName":"Patrick","lastName":"Collison","company":"Stripe","externalID":"crm-42"}]},"personIDs":{"type":"array","required":false,"note":"ids from leadsforge.people.search; externalID is NOT supported in this mode","example":["p_abc123","p_def456"]},"clientRequestID":{"type":"string","required":false,"note":"your own correlation id — also the filter key on the jobs list","example":"my-request-123"},"webhookURL":{"type":"string","required":false,"note":"POSTed on completion/failure, retried up to 10 times with exponential backoff","example":"https://example.com/webhook"},"saveToList":{"type":"boolean","required":false,"note":"also persist the results as a list in the LeadsForge app"}},"note":"202 with a jobID; poll leadsforge.people.enrich.job.status then fetch leadsforge.people.enrich.job.results. `people` entries are deduplicated by normalized linkedinURL or case-insensitive firstName+lastName+company, so duplicates lose their externalID."},"test_request":{"body":{"people":[{"firstName":"Patrick","lastName":"Collison","company":"Stripe","externalID":"crm-42"}],"clientRequestID":"treg-verify-1"}},"capability":"people.email.find","capability_description":"Get, find or look up a person's work email address from their name, company domain or LinkedIn profile","platform":"people","platform_label":"People & contact data","score":11.3563,"observed":{"samples":166,"decided":163,"ok_rate":0.9693,"p50_ms":6380,"p95_ms":25913,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"treg.people.identity.resolve","provider":"treg","provider_display":"treg","name":"people.identity.resolve — routed: best of 4 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.38 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (0 of 4 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,"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","pdl.x.person-identify"],"capability":"people.identity.resolve","capability_description":"Resolve an email or profile to linked identities","platform":"people","platform_label":"People & contact data","score":9.2434,"observed":{"samples":29405,"decided":29405,"ok_rate":0.942,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"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","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"}},"capability":"people.identity.resolve","capability_description":"Resolve an email or profile to linked identities","platform":"people","platform_label":"People & contact data","score":9.2434,"observed":{"samples":30,"decided":29,"ok_rate":0.9655,"p50_ms":4833,"p95_ms":15239,"last_ok_days":5,"hit_rate":null,"hit_samples":1}},{"id":"treg.people.phone.find","provider":"treg","provider_display":"treg","name":"people.phone.find — routed: best of 13 providers, own keys first","summary":"Find someone's phone number — treg picks the provider (own keys first, then cheapest per hit) and names the one that served","method":"POST","path":"/people.phone.find","scope":"","tier":"core","kind":"routed","domain":"contacts","call_template":"treg call treg.people.phone.find --method POST --data '{\"linkedin_url\":\"https://www.linkedin.com/in/patrickcollison\"}'","cost":{"type":"per_success","value":0.004834,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.004834–$0.7488 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (0 of 13 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.004834},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.phone == null"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"linkedin_url":{"type":"url","required":false,"note":"identity key (part of linkedin_url)"},"email":{"type":"str","required":false,"note":"identity key (part of email)"},"domain":{"type":"str","required":false,"note":"identity key (part of domain+full_name, domain+first_name+last_name)"},"full_name":{"type":"str","required":false,"note":"identity key (part of domain+full_name)"},"first_name":{"type":"str","required":false,"note":"identity key (part of domain+first_name+last_name)"},"last_name":{"type":"str","required":false,"note":"identity key (part of domain+first_name+last_name)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({linkedin_url} | {email} | {domain, full_name} | {domain, first_name, last_name}) 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":{"linkedin_url":"https://www.linkedin.com/in/patrickcollison"}},"routed_children":["aiark.people.phone.find","aviato.people.phone.find","contactout.people.contact.phone","dropleads.people.phone.find","findymail.search.phone","leadmagic.people.phone.find","leadsforge.people.phone.find","limadata.people.phone.find","lusha.people.phone.find","prospeo.people.phone.find","quickenrich.people.phone.find","tomba.people.phone.find","wiza.people.phone.find"],"capability":"people.phone.find","capability_description":"Find someone's phone number","platform":"people","platform_label":"People & contact data","score":9.2434,"observed":{"samples":264526,"decided":262937,"ok_rate":0.7869,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"leadsforge.people.phone.find","provider":"leadsforge","provider_display":"LeadsForge","name":"Find a mobile number by LinkedIn URL or name + company","summary":"Enrich a single person's phone number and return the result in the same response, no polling.","method":"POST","path":"/enrichment/phone","scope":"any_account","tier":"core","kind":"data","domain":"contacts","call_template":"treg call leadsforge.people.phone.find --method POST --data '{\"firstName\":\"Patrick\",\"lastName\":\"Collison\",\"companyDomain\":\"stripe.com\"}'","cost":{"type":"per_success","value":10,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://www.leadsforge.ai/pricing","checked":"2026-08-20","confidence":"documented","note":"10 credits on a hit, nothing on a miss. Confirmed live: balance 99 -> 89 on one successful call; GET /balance reports phoneNumberEnrichmentPrice=10","usd":0.245},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"body":{"personID":{"type":"string","required":false,"note":"id from leadsforge.people.search","example":"p_abc123"},"linkedinURL":{"type":"string","required":false,"example":"https://www.linkedin.com/in/john-doe"},"firstName":{"type":"string","required":false,"example":"Patrick"},"lastName":{"type":"string","required":false,"example":"Collison"},"companyDomain":{"type":"string","required":false,"note":"preferred over `company`","example":"stripe.com"},"company":{"type":"string","required":false,"example":"Stripe"},"externalID":{"type":"string","required":false,"note":"max 128 chars, echoed back"}},"note":"TEN TIMES the price of an email — gate it behind a search/count so you only ask for the numbers you need. A miss is free."},"test_request":{"body":{"firstName":"Patrick","lastName":"Collison","companyDomain":"stripe.com"}},"capability":"people.phone.find","capability_description":"Find someone's phone number","platform":"people","platform_label":"People & contact data","score":9.2434,"observed":{"samples":56815,"decided":56590,"ok_rate":0.9999,"p50_ms":704,"p95_ms":1842,"last_ok_days":0,"hit_rate":0.1497,"hit_samples":56584}}],"hints":["treg catalog get companyenrich.companies.enrich.bulk.status   # params, cost and an example response","treg.companies.enrich is ROUTED: treg picks among 27 providers (own keys first, then cheapest per hit) and names the one that served; call a child id to choose the provider yourself","treg call companyenrich.companies.enrich.bulk.status --query jobId=01a01ca2-932a-7b00-bc07-9417bb2a2b58   # run it — key injected server-side"]}