> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich

> Enrich provides organization-scoped APIs for email validation, contact discovery, profile enrichment, lead research, and credit management.

![Enrich logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/enrich.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=21536ae9733687bab42a94eb4ccaf9c3)

* **Category:** ai sales tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `ENRICH`
* **Version:** 20261101\_00

## Tools

> [accordion] Batch Find Work Emails
>
> **Slug:** `ENRICH_BATCH_FIND_WORK_EMAILS`
>
> Submit 1-100 people for asynchronous work-email finding, reserve up to 10 credits per case-insensitively unique lead, poll the batch to completed or failed, fetch all results, and settle or refund no-result reservations before returning.
>
> #### Input Parameters
>
> **leads** `array` *required*
>
> People whose work emails to find. Enrich removes duplicate leads case-insensitively and reserves 10 credits per unique lead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Lookup People by Email
>
> **Slug:** `ENRICH_BATCH_LOOKUP_PEOPLE_BY_EMAIL`
>
> Submit 1–100 emails for asynchronous professional-profile lookup, polling to a terminal state and fetching results to settle credits. Found profiles may omit unmatched inputs and are not necessarily positionally correlated with submitted emails.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> Email addresses to look up. Enrich removes duplicates case-insensitively and reserves up to 10 credits per unique address.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Validate Emails
>
> **Slug:** `ENRICH_BATCH_VALIDATE_EMAILS`
>
> Submit 1-100 emails as one asynchronous Enrich validation batch, reserving up to 1 credit per case-insensitively unique email. This call creates the job once, polls it to completed or failed, then fetches every result to settle charges and refund unused reservations before returning.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> Email addresses to validate. Enrich reserves up to 1 credit per case-insensitively unique address when the batch is submitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count Leads
>
> **Slug:** `ENRICH_COUNT_LEADS`
>
> Count leads matching Enrich Lead Finder filters without returning lead records. The count field is capped at 500,000; use searched\_total\_result for the wider searched population when present.
>
> #### Input Parameters
>
> **filters** `object` *required*
>
> Structured Lead Finder filters. Empty filters are accepted. Additional current keys from ENRICH\_GET\_LEAD\_FILTER\_OPTIONS may be supplied in snake\_case and are converted to lowerCamelCase. Undeclared keys, including possible typos, are validated by Enrich upstream.
>
> **exclude\_filters** `object`
>
> The five exclusion filters accepted by Enrich Lead Finder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Company Employees
>
> **Slug:** `ENRICH_FIND_COMPANY_EMPLOYEES`
>
> Find employees at a company from its LinkedIn URL, optionally filtering by geography and role. Returns one page at a time with at most 100 profiles. Enrich documents a cost of 1 credit per returned profile and no charge when no profiles are returned.
>
> #### Input Parameters
>
> **countries** `array`
>
> Country-name strings to filter by; omit to search all countries. Use full country names such as India, United States, or Germany. Enrich publishes no closed vocabulary for this field.
>
> **continents** `array`
>
> Provider continent strings to filter by; omit to search all continents. Enrich publishes no closed vocabulary or value examples for this field.
>
> **job\_levels** `array`
>
> Provider job-level or seniority strings to filter by; omit to include all job levels. Enrich publishes no closed Employee Finder vocabulary or value examples for this field.
>
> **max\_results** `integer`
>
> Maximum profiles requested for this page (1-100). Enrich documents a cost of 1 credit per returned profile and no charge when no profiles are returned.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the company, filters, and page size.
>
> **job\_functions** `array`
>
> Provider job-function or department strings to filter by; omit to include all job functions. Enrich publishes no closed Employee Finder vocabulary or value examples for this field.
>
> **sales\_regions** `array`
>
> Provider sales-region strings to filter by; omit to search all sales regions. Enrich publishes no closed vocabulary or value examples for this field.
>
> **company\_linkedin\_url** `string` *required*
>
> LinkedIn company URL whose employees should be searched.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Work Email
>
> **Slug:** `ENRICH_FIND_WORK_EMAIL`
>
> Find a person's professional email from their first name, last name, and company domain. A successful match is documented to cost 10 credits; no-result calls are refunded.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Company domain, without a URL path.
>
> **last\_name** `string` *required*
>
> Person's last name.
>
> **first\_name** `string` *required*
>
> Person's first name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Balance
>
> **Slug:** `ENRICH_GET_CREDIT_BALANCE`
>
> Return the connected organization's current Enrich credit balance and the time it was measured. Use this before credit-metered enrichment calls when cost or available balance matters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lead Filter Options
>
> **Slug:** `ENRICH_GET_LEAD_FILTER_OPTIONS`
>
> Return Enrich's current Lead Finder option catalog, keyed by filter name, for constructing count and search filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Credit Transactions
>
> **Slug:** `ENRICH_LIST_CREDIT_TRANSACTIONS`
>
> Return one page of credit top-ups and charges for the connected organization, optionally filtered by transaction type.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum transactions to return in this page; must be at least 1.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the original limit and transaction type.
>
> **transaction\_type** `string`
>
> Provider transaction type to filter by, such as top\_up; omit to include all transaction types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Person by Email
>
> **Slug:** `ENRICH_LOOKUP_PERSON_BY_EMAIL`
>
> Look up a professional profile from one email address. A found profile is documented to cost 10 credits; no-profile calls are refunded and results may be cached for seven days.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Professional email address to look up.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resume Existing Batch
>
> **Slug:** `ENRICH_RESUME_BATCH`
>
> Recover an existing validation, work-email, or people-lookup batch after a timeout or interrupted call. Polls for a terminal status and fetches one requested results page, which can settle reserved credits; pagination metadata supports retrieval of additional pages.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-indexed results page to fetch during settlement.
>
> **limit** `integer`
>
> Results to fetch on this page. Enrich's official maximum is 1000.
>
> **batch\_id** `string` *required*
>
> Existing Enrich batch ID from a prior timed-out or interrupted batch call.
>
> **batch\_type** `string ("validation" | "work_email" | "people_lookup")` *required*
>
> Existing Enrich batch route: validation, work\_email, or people\_lookup. This selects a fixed status/results endpoint and never submits a new batch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Company ICP
>
> **Slug:** `ENRICH_SEARCH_COMPANY_ICP`
>
> Run Enrich's ranked cascade search for ideal-customer-profile employees at one company. Enrich documents a cost of 1 credit per returned profile and no charge for zero results; use a modest max\_results or check the credit balance first.
>
> #### Input Parameters
>
> **cascade** `array`
>
> One to ten ordered ICP criteria levels. Earlier levels take priority and their matches are excluded from later levels. Omit to use Enrich's default CEO/Founder, C-Suite, VP, then Director cascade. Additional provider criteria keys are preserved.
>
> **min\_score** `number`
>
> Minimum normalized ICP score from 0 to 100 required for returned profiles.
>
> **max\_results** `integer`
>
> Maximum ranked profiles to return across all levels. Each returned profile may cost 1 credit, so keep this modest.
>
> **company\_linkedin\_url** `string` *required*
>
> LinkedIn company URL whose employees should be ranked.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Leads
>
> **Slug:** `ENRICH_SEARCH_LEADS`
>
> Return one page of leads matching Lead Finder filters. Free-tier results may mask names and consume a separate free-query allowance; the response includes remaining allowance and applicable page and result limits when supplied.
>
> #### Input Parameters
>
> **filters** `object` *required*
>
> Structured Lead Finder filters. Empty filters are accepted. Additional current keys from ENRICH\_GET\_LEAD\_FILTER\_OPTIONS may be supplied in snake\_case and are converted to lowerCamelCase. Undeclared keys, including possible typos, are validated by Enrich upstream.
>
> **page\_size** `integer`
>
> Maximum leads to return in this page. On the free tier, keep the total requested results within the free result allowance reported in responses.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the original filters and page size.
>
> **exclude\_filters** `object`
>
> The five exclusion filters accepted by Enrich Lead Finder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Email
>
> **Slug:** `ENRICH_VALIDATE_EMAIL`
>
> Check one email address for deliverability and return Enrich's result, confidence, provider, catch-all signal, and credit usage. The endpoint is documented to cost 1 credit, although unsuccessful or inconclusive checks may consume zero credits.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to validate for deliverability.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
