---
canonical_url: "https://docs.composio.dev/toolkits/enrich"
markdown_url: "https://docs.composio.dev/toolkits/enrich.md"
product: "platform"
version: null
last_updated: null
---

# Enrich

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

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

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `leads` | array | Yes | People whose work emails to find. Enrich removes duplicate leads case-insensitively and reserves 10 credits per unique lead. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Lookup People by Email

**Slug:** `ENRICH_BATCH_LOOKUP_PEOPLE_BY_EMAIL`

Submit 1-100 emails for asynchronous professional-profile lookup, reserve up to 10 credits per case-insensitively unique email, poll the batch to completed or failed, fetch all found profiles, and settle or refund no-match reservations before returning.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to look up. Enrich removes duplicates case-insensitively and reserves up to 10 credits per unique address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to validate. Enrich reserves up to 1 credit per case-insensitively unique address when the batch is submitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | Yes | 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 | No | The five exclusion filters accepted by Enrich Lead Finder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `countries` | array | No | 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 | No | 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 | No | 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 | No | 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 | No | Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the company, filters, and page size. |
| `job_functions` | array | No | 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 | No | 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 | Yes | LinkedIn company URL whose employees should be searched. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Company domain, without a URL path. |
| `last_name` | string | Yes | Person's last name. |
| `first_name` | string | Yes | Person's first name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum transactions to return in this page; must be at least 1. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the original limit and transaction type. |
| `transaction_type` | string | No | Provider transaction type to filter by, such as top_up; omit to include all transaction types. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Professional email address to look up. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resume Existing Batch

**Slug:** `ENRICH_RESUME_BATCH`

Recover an existing validation, work-email, or people-lookup batch after a timeout or interrupted call. This read-only recovery never submits a batch: it polls the selected fixed status endpoint to completed or failed, then fetches exactly one requested results page to settle reservations. Use the returned pagination metadata to recover additional pages without truncation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-indexed results page to fetch during settlement. |
| `limit` | integer | No | Results to fetch on this page. Enrich's official maximum is 1000. |
| `batch_id` | string | Yes | Existing Enrich batch ID from a prior timed-out or interrupted batch call. |
| `batch_type` | string ("validation" | "work_email" | "people_lookup") | Yes | Existing Enrich batch route: validation, work_email, or people_lookup. This selects a fixed status/results endpoint and never submits a new batch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cascade` | array | No | 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 | No | Minimum normalized ICP score from 0 to 100 required for returned profiles. |
| `max_results` | integer | No | Maximum ranked profiles to return across all levels. Each returned profile may cost 1 credit, so keep this modest. |
| `company_linkedin_url` | string | Yes | LinkedIn company URL whose employees should be ranked. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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 reports the remaining allowance and applicable page and result limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | Yes | 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 | No | 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 | No | Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the original filters and page size. |
| `exclude_filters` | object | No | The five exclusion filters accepted by Enrich Lead Finder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to validate for deliverability. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |