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

# Enrich Layer

Enrich Layer provides person, company, school, and professional-network data enrichment and lookup APIs.

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `ENRICH_LAYER`
- **Version:** 00000000_00

## Tools

### Check Email Type

**Slug:** `ENRICH_LAYER_CHECK_EMAIL_TYPE`

Check whether an email address is disposable and whether it belongs to a free email provider. A live request consumed 1 Enrich Layer credit despite the provider documentation describing this endpoint as free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to classify. |

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

### Enrich Company

**Slug:** `ENRICH_LAYER_ENRICH_COMPANY`

Return a structured company profile from its LinkedIn company URL. Uses cache when present and costs 1 credit on a successful base request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_profile_url` | string | Yes | LinkedIn company profile URL to enrich. |

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

### Enrich Person

**Slug:** `ENRICH_LAYER_ENRICH_PERSON`

Return a structured person profile from exactly one LinkedIn, Twitter/X, or Facebook profile URL. Uses cache when present and costs 1 credit on a successful base request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include_skills` | boolean | No | Include inferred or historic skills when available. This currently adds no credits, but coverage is limited. |
| `twitter_profile_url` | string | No | Twitter/X profile URL. Provide exactly one of linkedin_profile_url, twitter_profile_url, or facebook_profile_url. |
| `facebook_profile_url` | string | No | Facebook profile URL. Provide exactly one of linkedin_profile_url, twitter_profile_url, or facebook_profile_url. |
| `linkedin_profile_url` | string | No | LinkedIn profile URL. Provide exactly one of linkedin_profile_url, twitter_profile_url, or facebook_profile_url. LinkedIn URLs with hashed profile IDs are unsupported. |

#### 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 Person By Email

**Slug:** `ENRICH_LAYER_FIND_PERSON_BY_EMAIL`

Resolve social profile URLs for a person from a personal or work email address. Costs 3 credits on a match; the default superficial lookup avoids charging when no result is found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Personal or work email address to resolve. |
| `lookup_depth` | string ("superficial" | "deep") | No | superficial checks the provider database and does not charge when no result is found. deep uses additional heuristics and charges credits even when no match is found. |

#### 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 Person By Role

**Slug:** `ENRICH_LAYER_FIND_PERSON_BY_ROLE`

Return the single person profile URL that most closely matches a role at a named company. Costs 3 credits on any successful 200 response, including no match.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string | Yes | Role or title to find, such as CTO or Head of Finance. |
| `company_name` | string | Yes | Name of the company where the person holds the role. |

#### 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 Social Profiles By Phone

**Slug:** `ENRICH_LAYER_FIND_SOCIAL_PROFILES_BY_PHONE`

Find LinkedIn, Facebook, and Twitter/X profile URLs associated with one E.164 phone number. Costs 3 credits when profiles are found; grouped live balance evidence is consistent with no charge for a 200 no-result response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone_number` | string | Yes | Phone number in E.164 format, including the leading + and country code, for example +14155552671. |

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

Return the connected Enrich Layer account's current credit balance without consuming credits. Use before or after paid enrichment calls to manage cost.

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

### Resolve Company

**Slug:** `ENRICH_LAYER_RESOLVE_COMPANY`

Resolve a LinkedIn company profile URL from a company domain, company name, or both. Costs 2 credits on any successful 200 response, including a null result.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_name` | string | No | Company name. Provide this, company_domain, or both. |
| `company_domain` | string | No | Company website or domain. Provide this, company_name, or both. |
| `company_country` | string | No | Optional ISO 3166-1 alpha-2 country code used to disambiguate the company. |

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

### Resolve Person

**Slug:** `ENRICH_LAYER_RESOLVE_PERSON`

Return the closest person profile URL from a first name and company name or domain, or null when no match is found. Costs 2 credits on a match; the cost-safe default does not charge for null results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | string | Yes | Current company name or website domain. |
| `location` | string | No | Country, city, or state used to disambiguate the person. |
| `job_title` | string | No | Current job title used to disambiguate the person. |
| `last_name` | string | No | Person's last name, when known, to improve matching. |
| `first_name` | string | Yes | Person's first name. |
| `similarity_checks` | string ("skip" | "include") | No | Use skip for the cost-safe default: null results are not charged, but the closest match may be less strictly filtered. Use include for stricter false-positive filtering; it can charge 2 credits even when the result is null. |

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