# Enrich

> Use Enrich.so to validate emails, find work and personal emails, look up the person behind an email, and search, count and reveal B2B leads with Lead Finder.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/enrich

## Actions

### Count leads

Count the Lead Finder leads matching a set of filters, to size a search before running it. Free.

**Inputs**

- Job titles (`job_titles`, list): Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority (`job_levels`, list): Only people at these levels. One or more of: `C-Team`, `VP`, `Director`, `Manager`, `Staff`, `Other`.
- Department (`job_functions`, list): Only people in these departments. One or more of: `Advertising & Marketing`, `Art, Culture and Creative Professionals`, `Construction`, `Customer/Client Service`, `Education`, `Engineering`, `Finance & Accounting`, `General Business & Management`, `Healthcare & Human Services`, `Human Resources`, and 12 more.
- Company names (`company_names`, list): Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match (`company_name_mode`, text): Match company names exactly, or any name containing them. One of: `exact` (Exact name), `contains` (Name contains).
- Company domains (`domains`, list): Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in (`cities`, list): City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in (`countries`, list): Only people in these countries. Up to 20.
- Industries (`industries`, list): Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries (`headquarters_countries`, list): Only companies headquartered in these countries. Up to 20.
- Fewest employees (`employee_count_min`, number): Only companies with at least this many employees. At least 0.
- Most employees (`employee_count_max`, number): Only companies with at most this many employees. At least 0.
- LinkedIn headline words (`person_headlines`, list): Words in the person's LinkedIn headline. Up to 10.
- Skills (`skills`, list): Skills listed on the profile, matched exactly. Up to 25.
- Current job only (`current_job_only`, true/false): Match only the job people hold now, not past ones.
- More filters (`more_filters`, object): Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.
- Leave out job titles (`exclude_job_titles`, list): Leave out anyone whose job title contains these words. Up to 25.

**Outputs**

- `count` (number): How many leads match
- `isApproximate` (true/false): Whether the count is an estimate
- `searchType` (text): people, company or unified
- `searchedTotalResult` (number): Rows searched

**Example output**

```json
{
  "count": 1240,
  "isApproximate": false,
  "searchType": "people",
  "searchedTotalResult": 1240
}
```

### Delete saved search

Delete one of your saved Lead Finder searches. Free.

**Inputs**

- Saved search ID (`search_id`, text, required): The id from 'List saved searches' or 'Save search'.

**Outputs**

- `deleted` (true/false): Always true
- `id` (text): The deleted search's id

**Example output**

```json
{
  "deleted": true,
  "id": "ss_664f2b3c9a1e4d0012abcd01"
}
```

### Find best-fit people at a company

Rank the people at a company against your ideal customer profile: titles, seniority, departments, skills and place. Leave those empty to look for CEO and founders, then C-suite, VPs and directors. 1 credit a person returned.

**Inputs**

- Company LinkedIn page (`company_linkedin_url`, text, required): The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
- Job titles (`include_titles`, list): Titles to look for, such as Head of Sales.
- Leave out job titles (`exclude_titles`, list): Titles to leave out, such as Intern.
- Seniority (`job_levels`, list): Levels such as Owner, Founder, C-Level, Partner, VP, Director, Manager, Senior, Staff, Entry or Intern.
- Departments (`job_functions`, list): Departments such as Engineering, Marketing or Sales.
- Skills (`skills`, list): Skills that raise a person's score.
- Locations (`locations`, list): Two-letter country codes (US, DE), continents (NORTH_AMERICA, EUROPE) or WORLD.
- Match titles in headlines (`include_headline_search`, true/false): Also look for the job titles in LinkedIn headlines.
- Most people (`max_results`, number): 1 to 100, each costing a credit. Enrich's default is 25. From 1 to 100.
- Lowest score (`min_score`, number): Leave out people scoring under this, 0 to 100. From 0 to 100.

**Outputs**

- `cascade_stats` (list): Candidates at each level
- `meta` (object): The request id, and the credits this call used and has left
- `results` (list): The people, best first
- `total_found` (number): Candidates found
- `total_returned` (number): People returned

**Example output**

```json
{
  "cascade_stats": [
    {
      "candidates_found": 12,
      "candidates_kept": 1,
      "level": 0
    }
  ],
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 1,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "results": [
    {
      "cascade_level": 0,
      "certifications": null,
      "current_position": {
        "company": "Stripe",
        "function": "Engineering",
        "is_current": true,
        "level": "C-Level",
        "start_date": "2020-01-15",
        "title": "CTO"
      },
      "education": "Stanford University",
      "person": {
        "email_domain": "stripe.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "linkedin_headline": "CTO at Stripe",
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "location": "San Francisco, California, United States"
      },
      "ranking": 1,
      "ranking_factors": {
        "current_job": 10,
        "experience": 5,
        "job_level": 20,
        "location_match": 10,
        "priority_bonus": 0,
        "profile_completeness": 7,
        "skills_overlap": 10,
        "title_match": 30
      },
      "score": 92,
      "skills": [
        "Python"
      ],
      "what_matched": [
        "title: CTO"
      ]
    }
  ],
  "total_found": 12,
  "total_returned": 1
}
```

### Find company employees

List people who work at a company, from its LinkedIn page, filtered by place, seniority and department. 1 credit a person returned.

**Inputs**

- Company LinkedIn page (`company_linkedin_url`, text, required): The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
- Countries (`countries`, list): Country names, such as United States. Up to 50.
- Continents (`continents`, list): Continent names, such as Europe.
- Sales regions (`sales_regions`, list): Sales regions, such as EMEA.
- Seniority (`job_levels`, list): Seniority levels, such as Director.
- Departments (`job_functions`, list): Departments, such as Engineering.
- Most people (`max_results`, number): 1 to 100, each costing a credit. Enrich's default is 10. From 1 to 100.
- Page (`page`, number): Which page to return, from 1. At least 1.

**Outputs**

- `company_linkedin_url` (text): The company searched
- `max_results` (number): Most people asked for
- `meta` (object): The request id, and the credits this call used and has left
- `page` (number): This page
- `results` (list): The people
- `results_length` (number): People on this page
- `total_pages` (number): Pages available
- `total_results` (number): People found in all

**Example output**

```json
{
  "company_linkedin_url": "https://www.linkedin.com/company/stripe/",
  "max_results": 10,
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 1,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "page": 1,
  "results": [
    {
      "about_me": null,
      "certifications": null,
      "education": "Stanford University",
      "first_name": "Jane",
      "full_name": "Jane Doe",
      "headline": "VP of Engineering at Stripe",
      "job_function": "Engineering",
      "job_is_current": true,
      "job_level": "VP",
      "job_title": "VP of Engineering",
      "last_name": "Doe",
      "linkedin_url": "https://www.linkedin.com/in/jane-doe",
      "location": {
        "city": "San Francisco",
        "continent": "North America",
        "country": "United States",
        "country_code": "US",
        "state_code": "CA"
      },
      "skills": "Python, Distributed Systems"
    }
  ],
  "results_length": 1,
  "total_pages": 1,
  "total_results": 1
}
```

### Find person by email

Look up the professional profile behind an email address: name, headline, company, location, jobs and schools. 10 credits, none when nobody is found.

**Inputs**

- Email address (`email`, text, required): The email address, such as jane@example.com.

**Outputs**

- `companyName` (text): Current company
- `connectionCount` (number): LinkedIn connections
- `creditsConsumed` (number): Credits the lookup used
- `displayName` (text): Full name
- `email` (text): The email looked up
- `firstName` (text): First name
- `found` (true/false): Whether a profile was found
- `headline` (text): LinkedIn headline
- `id` (text): The profile's id
- `isConnectionCountObfuscated` (true/false): Whether the count is capped, as 500+
- `isPublic` (true/false): Whether the profile is public
- `lastName` (text): Last name
- `locale` (object): The profile's country and language
- `location` (text): Where they are
- `meta` (object): The request id, and the credits this call used and has left
- `photoUrl` (text): Photo URL
- `positions` (object): Work history
- `profileUrl` (text): LinkedIn profile URL
- `reportProfileUrl` (text): Link to report the profile
- `schools` (object): Education
- `skills` (list): Skills listed
- `summary` (text): About section

**Example output**

```json
{
  "companyName": "Stripe",
  "connectionCount": 500,
  "creditsConsumed": 10,
  "displayName": "Jane Doe",
  "email": "jane@stripe.com",
  "firstName": "Jane",
  "found": true,
  "headline": "VP of Engineering at Stripe",
  "id": "ACoAAB1234",
  "isConnectionCountObfuscated": true,
  "isPublic": true,
  "lastName": "Doe",
  "locale": {
    "country": "US",
    "language": "en"
  },
  "location": "San Francisco, California",
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 10,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "photoUrl": null,
  "positions": {
    "positionHistory": [
      {
        "companyLocation": "San Francisco",
        "companyLogo": null,
        "companyName": "Stripe",
        "description": null,
        "startEndDate": {
          "end": null,
          "start": {
            "month": 1,
            "year": 2020
          }
        },
        "title": "VP of Engineering"
      }
    ],
    "positionsCount": 1
  },
  "profileUrl": "https://www.linkedin.com/in/jane-doe",
  "reportProfileUrl": null,
  "schools": {
    "educationHistory": [
      {
        "degreeName": "BSc Computer Science",
        "schoolLocation": null,
        "schoolLogo": null,
        "schoolName": "Stanford University",
        "startEndDate": {
          "end": {
            "month": 6,
            "year": 2012
          },
          "start": {
            "month": 9,
            "year": 2008
          }
        }
      }
    ],
    "educationsCount": 1
  },
  "skills": [
    "Python",
    "Distributed Systems"
  ],
  "summary": "Building payments infrastructure."
}
```

### Find personal email

Find a personal email address from someone's LinkedIn profile. 10 credits, none when nothing is found.

**Inputs**

- LinkedIn profile (`linkedin_url`, text, required): The person's LinkedIn profile, such as https://www.linkedin.com/in/jane-doe.

**Outputs**

- `found` (true/false): Whether an email was found
- `linkedinUrl` (text): The profile looked up
- `meta` (object): The request id, and the credits this call used and has left
- `personalEmail` (text): The personal email, or empty when none

**Example output**

```json
{
  "found": true,
  "linkedinUrl": "https://www.linkedin.com/in/jane-doe",
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 10,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "personalEmail": "jane.doe@gmail.com"
}
```

### Find work email

Find someone's work email from their name and company domain. 10 credits, none when nothing is found.

**Inputs**

- First name (`first_name`, text, required): The person's first name.
- Last name (`last_name`, text, required): The person's last name.
- Company domain (`domain`, text, required): The company's website, such as figma.com. A full URL or an email address at the company works too.

**Outputs**

- `confidence` (text): high, medium or low
- `domain` (text): Domain searched
- `email` (text): The work email, when found
- `firstName` (text): First name searched
- `found` (true/false): Whether an email was found
- `isCatchAll` (true/false): Whether the domain accepts every address
- `lastName` (text): Last name searched
- `message` (text): Enrich's explanation
- `meta` (object): The request id, and the credits this call used and has left
- `provider` (text): The mail provider

**Example output**

```json
{
  "confidence": "high",
  "domain": "figma.com",
  "email": "jane.doe@figma.com",
  "firstName": "Jane",
  "found": true,
  "isCatchAll": false,
  "lastName": "Doe",
  "message": "Email found",
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 10,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "provider": "GOOGLE"
}
```

### Get credit balance

Get your Enrich organization's credit balance. Free.

**Inputs**: None.

**Outputs**

- `asOf` (text): When the balance was read (ISO 8601)
- `balance` (number): Credits available
- `currency` (text): Always credits
- `organizationId` (text): The Enrich organization's id

**Example output**

```json
{
  "asOf": "2026-03-02T10:00:00.000Z",
  "balance": 100,
  "currency": "credits",
  "organizationId": "org_664f2b3c9a1e4d0012ab"
}
```

### Get email batch results

Get one page of a validation batch's results, optionally waiting for the batch to finish first. Unused reserved credits are refunded once it has.

**Inputs**

- Batch ID (`batch_id`, text, required): The batchId from 'Validate emails in bulk'.
- Wait to finish (seconds) (`wait_seconds`, number): Up to 120. If the batch is still running, check every few seconds until it finishes or this time is up. From 0 to 120.
- Page (`page`, number): Which page to return, from 1. At least 1.
- Page size (`limit`, number): Results per page, 1 to 1,000. Enrich's default is 100. From 1 to 1000.

**Outputs**

- `batchId` (text): The batch's id
- `meta` (object): The request id, the credits settled for the batch, and progress
- `processedCount` (number): Addresses checked
- `results` (list): One per address
- `status` (text): The batch's status
- `totalItems` (number): Addresses in the batch

**Example output**

```json
{
  "batchId": "batch_664f2b3c9a1e4d0012ab",
  "meta": {
    "creditsRefunded": 0,
    "creditsRemaining": 88,
    "creditsUsed": 1,
    "processedItems": 1,
    "requestId": "req_664f2b3c9a1e4d0012abcdf1",
    "totalItems": 1
  },
  "processedCount": 1,
  "results": [
    {
      "confidence": "high",
      "email": "jane@example.com",
      "hasSEG": false,
      "isCatchAll": false,
      "isFederated": false,
      "message": "Mailbox exists",
      "provider": "GOOGLE",
      "result": "valid",
      "segProvider": null
    }
  ],
  "status": "completed",
  "totalItems": 1
}
```

### Get email batch status

Get a validation batch's status (queued, processing, completed or failed) and progress. Free.

**Inputs**

- Batch ID (`batch_id`, text, required): The batchId from 'Validate emails in bulk'.

**Outputs**

- `batchId` (text): The batch's id
- `processedItems` (number): Addresses checked so far
- `progress` (number): Percent done, 0 to 100
- `status` (text): queued, processing, completed or failed
- `totalItems` (number): Addresses in the batch

**Example output**

```json
{
  "batchId": "batch_664f2b3c9a1e4d0012ab",
  "processedItems": 2,
  "progress": 100,
  "status": "completed",
  "totalItems": 2
}
```

### Get reveal job

Get a reveal job's status and, once completed, the revealed contacts. Free.

**Inputs**

- Job ID (`job_id`, text, required): The jobId from 'Reveal lead contacts' (it starts with rj_).

**Outputs**

- `completedAt` (text): When it finished (ISO 8601)
- `createdAt` (text): When it was submitted (ISO 8601)
- `creditsRefunded` (number): Credits given back when it failed
- `error` (text): Why the job failed
- `fields` (list): The contact fields asked for
- `jobId` (text): The job's id (rj_...)
- `jobType` (text): reveal or enrich
- `progress` (object): How far the job has got
- `results` (object): What was revealed, once completed
- `status` (text): pending, processing, completed or failed

**Example output**

```json
{
  "completedAt": "2026-03-02T10:00:04.000Z",
  "createdAt": "2026-03-02T10:00:00.000Z",
  "creditsRefunded": null,
  "error": null,
  "fields": [
    "email"
  ],
  "jobId": "rj_a1b2c3d4e5f6g7h8",
  "jobType": "enrich",
  "progress": {
    "processed": 1,
    "total": 1
  },
  "results": {
    "alreadyRevealed": 0,
    "creditsRefunded": 0,
    "creditsUsed": 10,
    "newlyRevealed": 1,
    "revealed": [
      {
        "companyName": "Stripe",
        "domain": "stripe.com",
        "emailAddress": "jane@stripe.com",
        "firstName": "Jane",
        "id": "enc_abc123def456",
        "jobTitle": "VP of Engineering",
        "lastName": "Doe",
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe",
        "personalEmail": null
      }
    ]
  },
  "status": "completed"
}
```

### List credit transactions

List credits spent, bought, adjusted and refunded, newest first, one page at a time. Free.

**Inputs**

- Type (`transaction_type`, text): Only this kind of transaction. Leave empty for all. One of: `deduction` (Credits spent), `topup` (Top-ups), `adjustment` (Adjustments), `refund` (Refunds).
- Page (`page`, number): Which page to return, from 1. At least 1.
- Page size (`limit`, number): 1 to 100. Enrich's default is 50. From 1 to 100.

**Outputs**

- `pagination` (object): Where this page sits
- `transactions` (list): The transactions

**Example output**

```json
{
  "pagination": {
    "limit": 50,
    "page": 1,
    "total": 1,
    "totalPages": 1
  },
  "transactions": [
    {
      "amount": -10,
      "balanceAfter": 90,
      "createdAt": "2026-03-02T10:00:00.000Z",
      "description": "Email finder",
      "id": "txn_664f2b3c9a1e4d0012ab",
      "metadata": {},
      "organizationId": "org_664f2b3c9a1e4d0012ab",
      "type": "deduction"
    }
  ]
}
```

### List saved searches

List your saved Lead Finder searches and their filters. Free.

**Inputs**: None.

**Outputs**

- `count` (number): How many there are
- `searches` (list): The saved searches

**Example output**

```json
{
  "count": 1,
  "searches": [
    {
      "createdAt": "2026-03-02T10:00:00.000Z",
      "filters": {
        "companyName": [
          "Stripe"
        ],
        "jobLevel": [
          "VP",
          "Director"
        ]
      },
      "id": "ss_664f2b3c9a1e4d0012abcd01",
      "name": "Engineering leaders at Stripe",
      "updatedAt": "2026-03-02T10:00:00.000Z"
    }
  ]
}
```

### Reveal lead contacts

Reveal work and personal emails for up to 25 leads from 'Search leads', waiting for Enrich to finish. 10 credits a lead for each field; free again within 24 hours and refunded when nothing is on file.

**Inputs**

- Leads (`lead_ids`, list, required): Up to 25 lead ids from 'Search leads', or the search's results themselves.
- What to reveal (`fields`, list, required): Which contact details to reveal for each lead. One or more of: `email` (Work email (10 credits a lead)), `personalEmail` (Personal email (10 credits a lead)).

**Outputs**

- `completedAt` (text): When it finished (ISO 8601)
- `createdAt` (text): When it was submitted (ISO 8601)
- `creditsRefunded` (number): Credits given back when it failed
- `error` (text): Why the job failed
- `fields` (list): The contact fields asked for
- `jobId` (text): The job's id (rj_...)
- `jobType` (text): reveal or enrich
- `progress` (object): How far the job has got
- `results` (object): What was revealed, once completed
- `status` (text): pending, processing, completed or failed

**Example output**

```json
{
  "completedAt": "2026-03-02T10:00:04.000Z",
  "createdAt": "2026-03-02T10:00:00.000Z",
  "creditsRefunded": null,
  "error": null,
  "fields": [
    "email"
  ],
  "jobId": "rj_a1b2c3d4e5f6g7h8",
  "jobType": "enrich",
  "progress": {
    "processed": 1,
    "total": 1
  },
  "results": {
    "alreadyRevealed": 0,
    "creditsRefunded": 0,
    "creditsUsed": 10,
    "newlyRevealed": 1,
    "revealed": [
      {
        "companyName": "Stripe",
        "domain": "stripe.com",
        "emailAddress": "jane@stripe.com",
        "firstName": "Jane",
        "id": "enc_abc123def456",
        "jobTitle": "VP of Engineering",
        "lastName": "Doe",
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe",
        "personalEmail": null
      }
    ]
  },
  "status": "completed"
}
```

### Save search

Save a set of Lead Finder filters under a name. Free.

**Inputs**

- Name (`name`, text, required): A name for the search, up to 100 characters.
- Job titles (`job_titles`, list): Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority (`job_levels`, list): Only people at these levels. One or more of: `C-Team`, `VP`, `Director`, `Manager`, `Staff`, `Other`.
- Department (`job_functions`, list): Only people in these departments. One or more of: `Advertising & Marketing`, `Art, Culture and Creative Professionals`, `Construction`, `Customer/Client Service`, `Education`, `Engineering`, `Finance & Accounting`, `General Business & Management`, `Healthcare & Human Services`, `Human Resources`, and 12 more.
- Company names (`company_names`, list): Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match (`company_name_mode`, text): Match company names exactly, or any name containing them. One of: `exact` (Exact name), `contains` (Name contains).
- Company domains (`domains`, list): Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in (`cities`, list): City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in (`countries`, list): Only people in these countries. Up to 20.
- Industries (`industries`, list): Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries (`headquarters_countries`, list): Only companies headquartered in these countries. Up to 20.
- Fewest employees (`employee_count_min`, number): Only companies with at least this many employees. At least 0.
- Most employees (`employee_count_max`, number): Only companies with at most this many employees. At least 0.
- LinkedIn headline words (`person_headlines`, list): Words in the person's LinkedIn headline. Up to 10.
- Skills (`skills`, list): Skills listed on the profile, matched exactly. Up to 25.
- Current job only (`current_job_only`, true/false): Match only the job people hold now, not past ones.
- More filters (`more_filters`, object): Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.

**Outputs**

- `createdAt` (text): When it was saved (ISO 8601)
- `filters` (object): The Lead Finder filters, as Enrich names them
- `id` (text): The saved search's id
- `name` (text): Its name
- `updatedAt` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "createdAt": "2026-03-02T10:00:00.000Z",
  "filters": {
    "companyName": [
      "Stripe"
    ],
    "jobLevel": [
      "VP",
      "Director"
    ]
  },
  "id": "ss_664f2b3c9a1e4d0012abcd01",
  "name": "Engineering leaders at Stripe",
  "updatedAt": "2026-03-02T10:00:00.000Z"
}
```

### Search leads

Search Enrich's Lead Finder for people by job, company and place. Returns one page of leads without contact details; 'Reveal lead contacts' gets their emails. 50 free searches a month, then 1 credit a result past the first 75.

**Inputs**

- Job titles (`job_titles`, list): Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority (`job_levels`, list): Only people at these levels. One or more of: `C-Team`, `VP`, `Director`, `Manager`, `Staff`, `Other`.
- Department (`job_functions`, list): Only people in these departments. One or more of: `Advertising & Marketing`, `Art, Culture and Creative Professionals`, `Construction`, `Customer/Client Service`, `Education`, `Engineering`, `Finance & Accounting`, `General Business & Management`, `Healthcare & Human Services`, `Human Resources`, and 12 more.
- Company names (`company_names`, list): Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match (`company_name_mode`, text): Match company names exactly, or any name containing them. One of: `exact` (Exact name), `contains` (Name contains).
- Company domains (`domains`, list): Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in (`cities`, list): City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in (`countries`, list): Only people in these countries. Up to 20.
- Industries (`industries`, list): Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries (`headquarters_countries`, list): Only companies headquartered in these countries. Up to 20.
- Fewest employees (`employee_count_min`, number): Only companies with at least this many employees. At least 0.
- Most employees (`employee_count_max`, number): Only companies with at most this many employees. At least 0.
- LinkedIn headline words (`person_headlines`, list): Words in the person's LinkedIn headline. Up to 10.
- Skills (`skills`, list): Skills listed on the profile, matched exactly. Up to 25.
- Current job only (`current_job_only`, true/false): Match only the job people hold now, not past ones.
- More filters (`more_filters`, object): Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.
- Leave out job titles (`exclude_job_titles`, list): Leave out anyone whose job title contains these words. Up to 25.
- Page (`page`, number): Which page to return, from 1. At least 1.
- Page size (`page_size`, number): Leads per page, 1 to 100. Enrich's default is 25. From 1 to 100.

**Outputs**

- `meta` (object): What the search cost, and the free searches left this month
- `pagination` (object): Where this page sits
- `results` (list): The matching leads

**Example output**

```json
{
  "meta": {
    "alreadyCharged": false,
    "creditsRequired": 0,
    "creditsUsed": 0,
    "freeQueriesRemaining": 49,
    "freeQueryLimit": 50,
    "freeResultLimit": 75,
    "freeResults": 1,
    "isFreeQuery": true,
    "paidResults": 0,
    "requestId": "req_664f2b3c9a1e4d0012abcdf2",
    "resultsWithheld": 0,
    "searchCreditRate": 1
  },
  "pagination": {
    "hasMore": false,
    "isApproximate": false,
    "page": 1,
    "pageSize": 25,
    "searchedTotalResult": 1,
    "totalPages": 1,
    "totalResults": 1
  },
  "results": [
    {
      "city": "San Francisco",
      "companyHeadline": "Financial infrastructure for the internet",
      "companyName": "Stripe",
      "countryName": "United States",
      "domain": "stripe.com",
      "emailDomain": "stripe.com",
      "employeeCount": 8000,
      "employeeOnLinkedinGrowthRateOrg": 12,
      "firstName": "Jane",
      "foundedOn": "2010",
      "headquartersCity": "San Francisco",
      "headquartersCountry": "United States",
      "headquartersState": "California",
      "id": "enc_abc123def456",
      "industryNaicsDescription": "Data Processing, Hosting, and Related Services",
      "industrySicDescription": "Computer Processing & Data Preparation",
      "jobFunction": "Engineering",
      "jobLevel": "VP",
      "jobTitle": "VP of Engineering",
      "lastFundingDateOrg": "2023-03-15",
      "lastFundingTypeOrg": "Series I",
      "lastName": "Doe",
      "linkedinConnectionsCount": 500,
      "linkedinHeadline": "VP of Engineering at Stripe",
      "linkedinUrl": "https://www.linkedin.com/in/jane-doe",
      "logoUrl": null,
      "logoUrlOrg": null,
      "orgLinkedinUrl": "https://linkedin.com/company/stripe",
      "revenue": "$1B+",
      "skills": "Python, Distributed Systems",
      "specialties": "Payments, Financial Infrastructure",
      "stateName": "California",
      "totalFundingAmountOrg": 8700000000,
      "totalMonthlyTrafficOrg": 5000000
    }
  ]
}
```

### Suggest cities

Find the city names Lead Finder knows that match some text, to use in a search's 'Cities people live in'. Free.

**Inputs**

- Text to match (`query`, text, required): At least 2 characters of the city's name.
- Which cities (`city_field`, text): Cities people live in, or where companies are based. One of: `city` (Where people live (default)), `headquartersCity` (Where companies have their headquarters).
- How many (`limit`, number): 1 to 20. Enrich's default is 20. From 1 to 20.

**Outputs**

- `values` (list): The suggested names, best match first

**Example output**

```json
{
  "values": [
    "San Francisco",
    "San Fernando"
  ]
}
```

### Suggest company names

Find the company names Lead Finder knows that match some text, to use in a search's 'Company names'. Free.

**Inputs**

- Text to match (`query`, text, required): At least 2 characters of the company's name.
- How many (`limit`, number): 1 to 50. Enrich's default is 20. From 1 to 50.

**Outputs**

- `values` (list): The suggested names, best match first

**Example output**

```json
{
  "values": [
    "Stripe",
    "Stripe Partners"
  ]
}
```

### Validate email

Check whether an email address can receive mail: valid, invalid or risky, with the mail provider and whether the domain accepts every address. 1 credit, none when risky.

**Inputs**

- Email address (`email`, text, required): The email address, such as jane@example.com.

**Outputs**

- `confidence` (text): definitive, high, medium, low, temporary or none
- `email` (text): The address checked
- `hasSEG` (true/false): Whether a secure email gateway screens the domain's mail
- `isCatchAll` (true/false): Whether the domain accepts every address
- `isFederated` (true/false): Whether the domain signs in through another provider
- `message` (text): Enrich's explanation
- `meta` (object): The request id, and the credits this call used and has left
- `provider` (text): GOOGLE, MICROSOFT or SMTP
- `result` (text): valid, invalid or risky
- `segProvider` (text): The gateway, such as mimecast

**Example output**

```json
{
  "confidence": "high",
  "email": "jane@example.com",
  "hasSEG": false,
  "isCatchAll": false,
  "isFederated": false,
  "message": "Mailbox exists",
  "meta": {
    "creditsRemaining": 89,
    "creditsUsed": 1,
    "processingTimeMs": 840,
    "requestId": "req_664f2b3c9a1e4d0012abcdef"
  },
  "provider": "GOOGLE",
  "result": "valid",
  "segProvider": null
}
```

### Validate emails in bulk

Queue up to 1,000 email addresses for validation. Repeats are dropped. Returns a batch ID for 'Get email batch results'. 1 credit an address, reserved now.

**Inputs**

- Email addresses (`emails`, list, required): The addresses to check, one per entry. Up to 1,000.

**Outputs**

- `batchId` (text): The batch's id
- `duplicatesRemoved` (number): Repeats dropped
- `itemCount` (number): Addresses queued
- `meta` (object): The request id and the credits reserved for the batch
- `originalCount` (number): Addresses sent
- `status` (text): Usually queued

**Example output**

```json
{
  "batchId": "batch_664f2b3c9a1e4d0012ab",
  "duplicatesRemoved": 0,
  "itemCount": 2,
  "meta": {
    "creditsPerItem": 1,
    "creditsReserved": 2,
    "estimatedCredits": 2,
    "requestId": "req_664f2b3c9a1e4d0012abcdf0"
  },
  "originalCount": 2,
  "status": "queued"
}
```
