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

# CompanyEnrich

> CompanyEnrich provides instant company data enrichment, search, and similar company discovery through API endpoints.

![CompanyEnrich logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/companyenrich.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=89c7dcdd95ca68b715909a6afd08bf2a)

* **Category:** company data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 48
* **Triggers:** 0
* **Slug:** `COMPANYENRICH`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Autocomplete Companies
>
> **Slug:** `COMPANYENRICH_AUTOCOMPLETE_COMPANIES`
>
> Returns a list of companies matching the given partial domain name. This is useful for autocompleting domain names in your application. Up to 10 companies are returned per request. Free; no charge. Use when you need to autocomplete company domains in your application.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The domain name to autocomplete (e.g., 'google', 'stripe', 'amazon')
>
> #### 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] Autocomplete Keywords
>
> **Slug:** `COMPANYENRICH_AUTOCOMPLETE_KEYWORDS`
>
> Lookup keywords for use in company search filters. This endpoint returns a list of keywords that match the provided query string. Use this action to discover valid keyword values before using them in company search filters. The results are sorted by relevance. Example: query="tech" might return \["Technology", "Tech", "Information Technology", ...]
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The search query for keywords. Use this to find matching keywords for company 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] Autocomplete Positions
>
> **Slug:** `COMPANYENRICH_AUTOCOMPLETE_POSITIONS`
>
> Lookup positions/job titles for use in people search filters. This endpoint returns a list of job titles that match the provided query string. Use this action to discover valid position values before using them in people search filters. The results are sorted by relevance. Example: query="engineer" might return \["Software Engineer", "Data Engineer", "Sales Engineer", ...]
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The search query for job titles/positions. Use this to find matching job titles for people 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] Autocomplete Technologies
>
> **Slug:** `COMPANYENRICH_AUTOCOMPLETE_TECHNOLOGIES`
>
> Lookup technologies for use in company search filters. This endpoint returns a list of technology names that match the provided query string. Use this action to discover valid technology values before using them in company search filters. The results are sorted by relevance. Example: query="react" might return \["React", "React Native", "ReactJS", ...]
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The search query for technologies. Use this to find matching technology names for company 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] Count companies matching search criteria
>
> **Slug:** `COMPANYENRICH_COUNT_COMPANIES`
>
> Returns the total count of companies matching the given search criteria without retrieving the actual results. Use this action to check how many companies match your filters before performing a full search. Free; no charge.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **type** `array`
>
> The list of company types to filter by
>
> **lists** `array`
>
> The list IDs to filter by
>
> **query** `string`
>
> The search query to apply on the company name and domain
>
> **cities** `array`
>
> The city IDs to filter by
>
> **states** `array`
>
> The state IDs to filter by
>
> **exclude** `object`
>
> Exclusion filters to apply on the companies.
>
> **regions** `array`
>
> The region IDs to filter by
>
> **require** `array`
>
> The features that must exist for the company
>
> **revenue** `array`
>
> The list of revenue ranges to filter by
>
> **category** `array`
>
> The list of company categories to filter by
>
> **keywords** `array`
>
> The keywords to filter by
>
> **countries** `array`
>
> The 2 letter country codes to filter by
>
> **employees** `array`
>
> The list of employee counts to filter by
>
> **naics\_code** `array`
>
> The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included
>
> **founded\_year** `object`
>
> The range of years
>
> **funding\_year** `object`
>
> The range of years
>
> **technologies** `array`
>
> The technologies to filter by
>
> **funding\_amount** `object`
>
> The funding amount range to filter by
>
> **funding\_rounds** `array`
>
> The funding rounds to filter by
>
> **semantic\_query** `string`
>
> The semantic search query to find companies with. More natural language version of the standard query.
>
> **semantic\_weight** `number`
>
> The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default.
>
> **workforce\_growth** `object`
>
> Filter companies by workforce growth percentage over a selected period and department.
>
> **category\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> **keywords\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> **technologies\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> #### 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 Similar Companies
>
> **Slug:** `COMPANYENRICH_COUNT_SIMILAR_COMPANIES`
>
> Tool to count the total number of similar companies matching the given search criteria without retrieving the actual results. Use when you need to know how many similar companies exist before making a request to fetch them, or when you only need the count without the full company details. Free; no charge.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **type** `array`
>
> The list of company types to filter by.
>
> **query** `string`
>
> The search query to apply on the company name and domain.
>
> **cities** `array`
>
> The city IDs to filter by.
>
> **states** `array`
>
> The state IDs to filter by.
>
> **domains** `array` *required*
>
> The domains to find similar companies for. Up to 10 domains are allowed.
>
> **exclude** `object`
>
> Exclusion filters to apply on the companies. If a company matches any of the filters here, it will be excluded from the results.
>
> **regions** `array`
>
> The region IDs to filter by.
>
> **require** `array`
>
> The features that must exist for the company.
>
> **revenue** `array`
>
> The list of revenue ranges to filter by.
>
> **category** `array`
>
> The list of company categories to filter by.
>
> **keywords** `array`
>
> The keywords to filter by.
>
> **countries** `array`
>
> The 2 letter country codes to filter by.
>
> **employees** `array`
>
> The list of employee counts to filter by.
>
> **naicsCode** `array`
>
> The NAICS codes to filter by. Can be 2 to 6 digit codes.
>
> **foundedYear** `object`
>
> The range of years to filter by.
>
> **fundingYear** `object`
>
> The funding year range to filter by.
>
> **technologies** `array`
>
> The technologies to filter by.
>
> **fundingAmount** `object`
>
> The funding amount range to filter by.
>
> **fundingRounds** `array`
>
> The funding rounds to filter by.
>
> **workforceGrowth** `object`
>
> Filter companies by workforce growth percentage over a selected period and department.
>
> **categoryOperator** `string ("And" | "Or")`
>
> Operator for category filters.
>
> **keywordsOperator** `string ("And" | "Or")`
>
> Operator for category filters.
>
> **similarityWeight** `number`
>
> The similarity weight to apply to the results. Must be between -1 and 1. 0 is default.
>
> **technologiesOperator** `string ("And" | "Or")`
>
> Operator for category 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] Create Bulk Enrichment Job
>
> **Slug:** `COMPANYENRICH_CREATE_BULK_ENRICHMENT_JOB`
>
> Create an asynchronous enrichment job for up to 10,000 domains. Costs 1 credit per domain successfully enriched, charged on completion. The `workforce` expansion costs 5 credits per company.
>
> #### Input Parameters
>
> **expand** `array`
>
> Response expansions. `workforce` costs 5 credits per company.
>
> **domains** `array` *required*
>
> Domains to enrich; between 1 and 10,000 domains are accepted.
>
> **webhook\_url** `string`
>
> Webhook URL notified when processing completes.
>
> #### 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] Create Bulk Person Email Job
>
> **Slug:** `COMPANYENRICH_CREATE_BULK_PERSON_EMAIL_JOB`
>
> Start an asynchronous job containing 1 to 1,000 person email lookups. Each item costs up to 10 credits, charged on completion only when a newly accessed email is found. Beta: coverage, orchestration, and response behavior may change.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> Person email lookup items; between 1 and 1,000 are required.
>
> **webhook\_url** `string`
>
> Optional webhook URL notified when processing completes.
>
> #### 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] Create Company List
>
> **Slug:** `COMPANYENRICH_CREATE_COMPANY_LIST`
>
> Create a durable company list from search or similar-company results. This action is charged per company added: search lists cost 1 credit per company (1-credit minimum); similar lists cost 5 credits per company (5-credit minimum). If no companies are found, CompanyEnrich does not create the list. Although count accepts up to 10,000, the provider selects only the first 5,000 results for the list.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the company list.
>
> **count** `integer` *required*
>
> The count schema accepts 1-10,000, but the provider selects only the first 5,000 matching results for a list.
>
> **search** `object`
>
> Company filters for selecting list entries by search criteria.
>
> **similar** `object`
>
> Company filters for selecting list entries similar to seed domains.
>
> #### 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] Create people search export job
>
> **Slug:** `COMPANYENRICH_CREATE_PEOPLE_SEARCH_EXPORT_JOB`
>
> Creates an asynchronous search export job for up to 50,000 people, returning a job ID and notifying a provided webhook on completion. Costs 2 credits per person returned, reserved when the job is created and settled on completion.
>
> #### Input Parameters
>
> **count** `integer` *required*
>
> The number of people to export (1-1000000)
>
> **query** `string`
>
> The search query to apply on the company name and domain
>
> **domains** `array`
>
> The domains to find people for. Up to 100 domains are allowed.
>
> **exclude** `object`
>
> Exclusion filters to apply on the people. If a person matches any of the filters here, it will be excluded from the results.
>
> **countries** `array`
>
> The 2 letter country codes to filter by
>
> **seniority** `array`
>
> The seniorities to filter by (e.g., c-suite, director, manager, senior, entry)
>
> **department** `array`
>
> The departments to filter by (e.g., engineering-technical, sales, marketing, c-suite)
>
> **webhook\_url** `string`
>
> The webhook URL to receive the notification when processing completes.
>
> **company\_filter** `object`
>
> The filters to be applied on the companies to find people for
>
> **position\_query** `array`
>
> The list of search queries to apply on the person's current job position/title
>
> **at\_current\_company\_after** `string`
>
> Filter by current company join date - only include people who joined after this UTC date (ISO 8601 format)
>
> **at\_current\_company\_before** `string`
>
> Filter by current company join date - only include people who joined before this UTC date (ISO 8601 format)
>
> **at\_current\_position\_after** `string`
>
> Filter by current position start date - only include people who started after this UTC date (ISO 8601 format)
>
> **at\_current\_position\_before** `string`
>
> Filter by current position start date - only include people who started before this UTC date (ISO 8601 format)
>
> #### 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] Create search export job
>
> **Slug:** `COMPANYENRICH_CREATE_SEARCH_EXPORT_JOB`
>
> Creates an asynchronous company search or similar-company export job for up to 50,000 companies, returning a job ID and notifying a provided webhook on completion. Costs 1 credit per company returned, reserved when the job is created and settled on completion.
>
> #### Input Parameters
>
> **count** `integer` *required*
>
> The number of companies to export (up to 50,000).
>
> **search** `object`
>
> Search filters to apply on the companies. Supports fields like query, keywords, countries, cities, states, regions, industries, categories, technologies, employees, revenue, fundingAmount, fundingRounds, foundedYear, naicsCode, and more.
>
> **similar** `object`
>
> Filters to find similar companies. Use the 'domains' field (up to 10 domains) to find companies similar to those domains.
>
> **webhook\_url** `string`
>
> The webhook URL to receive a notification when processing completes.
>
> #### 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] Delete Company List
>
> **Slug:** `COMPANYENRICH_DELETE_COMPANY_LIST`
>
> Permanently delete a company list and all of its entries.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the CompanyEnrich company list to permanently delete.
>
> #### 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] Enrich company by domain
>
> **Slug:** `COMPANYENRICH_ENRICH_BY_DOMAIN`
>
> Enriches a company using its domain name as lookup parameter. This is the preferred way to enrich a company as domain lookups are fast and reliable. Each domain maps to a unique company. Costs 1 credit per call (5 credits with the workforce expansion). Returns found=false with null company fields when no company matches the domain; there is no charge in that case.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per company enriched; \$0.049 per company enriched with workforce data
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain name of the company to enrich (e.g., 'stripe.com').
>
> **expand** `array`
>
> Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: workforce (adds the workforce field; costs 5 credits per company).
>
> #### 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] Enrich company by properties
>
> **Slug:** `COMPANYENRICH_ENRICH_BY_PROPERTIES`
>
> Enriches a company using its properties. You must provide at least one of the following properties: name, linkedinUrl, linkedinId, twitterUrl, facebookUrl, instagramUrl. Best match is used to determine the company in case of ambiguity. Costs 1 credit per call (5 credits with the workforce expansion).
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per company enriched; \$0.049 per company enriched with workforce data
>
> #### Input Parameters
>
> **name** `string`
>
> The name of the company to enrich.
>
> **expand** `array`
>
> Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: workforce (adds the workforce field; costs 5 credits per company).
>
> **linkedin\_id** `string`
>
> The LinkedIn ID of the company to enrich.
>
> **twitter\_url** `string`
>
> The Twitter URL of the company to enrich.
>
> **facebook\_url** `string`
>
> The Facebook URL of the company to enrich.
>
> **linkedin\_url** `string`
>
> The LinkedIn URL of the company to enrich.
>
> **you\_tube\_url** `string`
>
> The YouTube URL of the company to enrich.
>
> **instagram\_url** `string`
>
> The Instagram URL of the company to enrich.
>
> #### 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 Enrich Companies
>
> **Slug:** `COMPANYENRICH_ENRICH_COMPANIES`
>
> Enriches a list of companies using their domain names. Use when you need to enrich multiple companies in a single request. Up to 50 domains can be provided. Each domain maps to a unique company. Costs 1 credit per domain enriched (5 credits with the workforce expansion).
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per company enriched; \$0.049 with workforce data
>
> #### Input Parameters
>
> **expand** `array`
>
> Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: `workforce` (adds the `workforce` field; costs 5 credits per company).
>
> **domains** `array` *required*
>
> A list of domains to enrich. Up to 50 domains can be provided in a single request.
>
> #### 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 Similar Companies
>
> **Slug:** `COMPANYENRICH_FIND_SIMILAR_COMPANIES`
>
> Tool to find similar companies to the given company by domain. Use when you need to find companies similar to a target company based on industry, size, or other characteristics. Returns up to 100 companies per request. Costs 5 credits per company returned, and 5 credits if no results are found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.049 per similar company returned (min \$0.049); +\$0.049 each with workforce.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number to return. Must be greater than 0.
>
> **type** `array`
>
> The list of company types to filter by.
>
> **query** `string`
>
> The search query to apply on the company name and domain.
>
> **cities** `array`
>
> The city IDs to filter by.
>
> **expand** `array`
>
> Expandable response fields. Supported values: workforce (adds the workforce field; costs 5 more credits per company).
>
> **states** `array`
>
> The state IDs to filter by.
>
> **domains** `array` *required*
>
> The domains to find similar companies for. Up to 10 domains are allowed.
>
> **regions** `array`
>
> The region IDs to filter by.
>
> **require** `array`
>
> The features that must exist for the company.
>
> **revenue** `array`
>
> The list of revenue ranges to filter by.
>
> **category** `array`
>
> The list of company categories to filter by.
>
> **keywords** `array`
>
> The keywords to filter by.
>
> **pageSize** `integer`
>
> The number of results to return. Must be between 1 and 100.
>
> **countries** `array`
>
> The 2 letter country codes to filter by.
>
> **employees** `array`
>
> The list of employee counts to filter by.
>
> **naicsCode** `array`
>
> The NAICS codes to filter by. Can be 2 to 6 digit codes.
>
> **technologies** `array`
>
> The technologies to filter by.
>
> **fundingRounds** `array`
>
> The funding rounds to filter by.
>
> **categoryOperator** `string ("And" | "Or")`
>
> Operator for category filters.
>
> **keywordsOperator** `string ("And" | "Or")`
>
> Operator for category filters.
>
> **similarityWeight** `number`
>
> The similarity weight to apply to the results. Must be between -1 and 1. 0 is default.
>
> **technologiesOperator** `string ("And" | "Or")`
>
> Operator for category 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] Get Bulk Enrichment Job Status
>
> **Slug:** `COMPANYENRICH_GET_BULK_ENRICHMENT_JOB_STATUS`
>
> Returns the current status of a bulk enrichment job. Once the job is completed, the response includes a results\_url to download the enrichment results. Free; no charge. Use when you need to check the progress of a bulk enrichment job or get the results URL after the job completes.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> The unique identifier of the bulk enrichment job (UUID format). This ID is obtained when creating a bulk enrichment job.
>
> #### 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 Bulk Person Email Job Status
>
> **Slug:** `COMPANYENRICH_GET_BULK_PERSON_EMAIL_JOB_STATUS`
>
> Check a bulk person email job for free. Returns its status, credits\_charged, and results\_url when available; status checks are free. Beta: provider coverage, orchestration, and response behavior may change.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> The bulk person email job UUID.
>
> #### 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 Company
>
> **Slug:** `COMPANYENRICH_GET_COMPANY`
>
> Retrieve a company by its CompanyEnrich UUID. Costs 1 credit per call. Requesting the `workforce` expansion costs 5 more credits per company.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> CompanyEnrich company UUID.
>
> **expand** `array`
>
> Optional response expansions. `workforce` costs 5 more credits.
>
> #### 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 Company List
>
> **Slug:** `COMPANYENRICH_GET_COMPANY_LIST`
>
> Retrieve one saved company list by its UUID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the CompanyEnrich company list to retrieve.
>
> #### 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 Company Workforce
>
> **Slug:** `COMPANYENRICH_GET_COMPANY_WORKFORCE`
>
> Returns workforce insights for a single company. You must provide exactly one lookup parameter: id or domain. The response includes observed employee count, an employee range bucket, and headcounts grouped by root departments. Costs 5 credits per successful call. Returns found=false with null workforce fields when no company matches; there is no charge in that case. Use when you need to find workforce details (employee count, department breakdown) for a specific company given its domain or company ID.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.049 per company workforce lookup
>
> #### Input Parameters
>
> **id** `string`
>
> CompanyEnrich company ID. Provide either `id` or `domain`.
>
> **domain** `string`
>
> Company domain. Provide either `id` or `domain`.
>
> #### 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 Country by Code
>
> **Slug:** `COMPANYENRICH_GET_COUNTRY_BY_CODE`
>
> Tool to search for a country by its ISO 3166-1 alpha-2 code. Returns country information including name, coordinates, and country code. Use when you need to retrieve details about a specific country. Example: Get country details for US, GB, DE, etc.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **country\_code** `string` *required*
>
> The ISO 3166-1 alpha-2 country code (e.g., US, GB, DE, FR).
>
> #### 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 Current User
>
> **Slug:** `COMPANYENRICH_GET_CURRENT_USER`
>
> Returns information about the authenticated user, including their credit balance and account capabilities. This endpoint requires authentication via an API key in the Authorization header. Free; no charge.
>
> #### 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 Job Details
>
> **Slug:** `COMPANYENRICH_GET_JOB_DETAILS`
>
> Retrieve details for a specific job by ID, including its status, timestamps, credits charged, and any error message. Free; no charge.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> The unique identifier of the job to retrieve
>
> #### 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 People Search Export Job Status
>
> **Slug:** `COMPANYENRICH_GET_PEOPLE_SEARCH_EXPORT_JOB_STATUS`
>
> Returns the current status of a person search export job. Once completed, includes the results\_url to download the export results. Use when: - Checking if an async person search export job has completed - Getting the download URL for completed exports - Monitoring job progress or checking for errors Status checks are free.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> The unique identifier (UUID) of the person search export job to check the status of.
>
> #### 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 Person
>
> **Slug:** `COMPANYENRICH_GET_PERSON`
>
> Retrieve a person by CompanyEnrich ID for 2 credits. Optionally request the education expansion, which adds 1 credit.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The CompanyEnrich person ID.
>
> **expand** `array`
>
> Optional response expansions. The lookup costs 2 credits; education adds 1 credit.
>
> #### 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 Person Education
>
> **Slug:** `COMPANYENRICH_GET_PERSON_EDUCATION`
>
> Retrieve a person's education history. Costs 1 credit per successful call.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The CompanyEnrich person ID.
>
> #### 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 Regions
>
> **Slug:** `COMPANYENRICH_GET_REGIONS`
>
> Tool to get all available regions. Returns a list of all geographic regions supported by the API. Use when you need to retrieve region information for filtering or validation purposes.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### 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 search export job status
>
> **Slug:** `COMPANYENRICH_GET_SEARCH_EXPORT_JOB_STATUS`
>
> Returns the current status of a search export job. Once the job is completed, the response will include a results\_url that can be used to download the exported company data. This action is free. Use this action to: - Check if an export job has completed - Get the download URL for completed exports - Monitor job progress and troubleshoot failures
>
> #### Input Parameters
>
> **jobId** `string` *required*
>
> The unique identifier (UUID) of the search export job. This is returned when you create an export job.
>
> #### 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 all jobs
>
> **Slug:** `COMPANYENRICH_LIST_ALL_JOBS`
>
> Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user. Supports optional filtering by job status and type. Free; no charge. Use this action to: - View all your jobs - Check the status of jobs - Monitor job progress and completion - Filter jobs by status (pending, processing, completed, failed, etc.) - Filter jobs by type (bulk\_enrichment, etc.)
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (default: 1).
>
> **type** `string`
>
> Filter jobs by type (bulk\_enrichment, etc.).
>
> **status** `string ("pending" | "processing" | "completing" | "completed" | "failed")`
>
> Filter jobs by status.
>
> **pageSize** `integer`
>
> Number of items per page (default: 20, max: 100).
>
> #### 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 bulk enrichment jobs
>
> **Slug:** `COMPANYENRICH_LIST_BULK_ENRICHMENT_JOBS`
>
> Returns a paginated list of all bulk enrichment jobs for the authenticated user. Supports optional filtering by job status. This action is free. Use this action to: - View all your bulk enrichment jobs - Check the status of enrichment jobs - Monitor enrichment job progress and completion - Filter jobs by status (pending, processing, completing, completed, failed)
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (default: 1).
>
> **status** `string ("pending" | "processing" | "completing" | "completed" | "failed")`
>
> Filter jobs by status.
>
> **pageSize** `integer`
>
> Number of items per page (default: 20, max: 100).
>
> #### 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 Company Lists
>
> **Slug:** `COMPANYENRICH_LIST_COMPANY_LISTS`
>
> Return all saved company lists for the authenticated user.
>
> #### 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 Industries
>
> **Slug:** `COMPANYENRICH_LIST_INDUSTRIES`
>
> Obtain a list of all company industries. Returns all industry names along with their associated NAICS code prefixes. Use when you need to retrieve the complete list of industries for filtering or categorization.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### 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 Person Search Export Jobs
>
> **Slug:** `COMPANYENRICH_LIST_PEOPLE_SEARCH_EXPORT_JOBS`
>
> Returns a free, paginated list of the authenticated user's person search export jobs, optionally filtered by status. Use it to check job status and export progress.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (default: 1).
>
> **status** `string ("pending" | "processing" | "completing" | "completed" | "failed")`
>
> Status of the async export job.
>
> **page\_size** `integer`
>
> Number of items per page (default: 20, max: 100).
>
> #### 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 search export jobs
>
> **Slug:** `COMPANYENRICH_LIST_SEARCH_EXPORT_JOBS`
>
> Lists the authenticated user's company search export jobs in pages, optionally filtered by status. The action is free.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (default: 1).
>
> **status** `string ("pending" | "processing" | "completing" | "completed" | "failed")`
>
> Filter jobs by status.
>
> **pageSize** `integer`
>
> Number of items per page (default: 20, max: 100).
>
> #### 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:** `COMPANYENRICH_LOOKUP_PERSON`
>
> Look up a person by email address. We resolve the company from the email domain first, then match the person by email local-part patterns. Returns the best deterministic match when found. Costs 5 credits per successful call. Use when you need to find person details (name, position, company, etc.) given an email address.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.049 per person found
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address of the person to look up (e.g., '[sarah.chen@stripe.com](mailto:sarah.chen@stripe.com)')
>
> #### 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 Email by ID
>
> **Slug:** `COMPANYENRICH_LOOKUP_PERSON_EMAIL_BY_ID`
>
> Resolve a work email for a person, optionally on a specific domain. Charged only when a newly accessed email is found. Beta: provider coverage and response behavior may change.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The CompanyEnrich person ID.
>
> **domain** `string`
>
> Optional company domain to resolve the email on. If omitted, current experience domains are tried in seniority order.
>
> #### 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] Preview Company Search
>
> **Slug:** `COMPANYENRICH_PREVIEW_COMPANY_SEARCH`
>
> Preview the top 25 companies matching a search. Free; no charge. Requirements: Requires Scale plans. Notice: Returns the top 25 results only.
>
> #### Input Parameters
>
> **type** `array`
>
> Company types to include.
>
> **lists** `array`
>
> Saved list IDs to filter by.
>
> **query** `string`
>
> Query applied to company names and domains.
>
> **cities** `array`
>
> City IDs to include.
>
> **states** `array`
>
> State IDs to include.
>
> **exclude** `object`
>
> Filters that exclude matching companies.
>
> **regions** `array`
>
> Region IDs to include.
>
> **require** `array`
>
> Company features that must be present.
>
> **revenue** `array`
>
> Revenue ranges to include.
>
> **category** `array`
>
> Company categories to include.
>
> **keywords** `array`
>
> Keywords to include.
>
> **countries** `array`
>
> Two-letter country codes to include.
>
> **employees** `array`
>
> Employee-count ranges to include.
>
> **naicsCode** `array`
>
> NAICS codes to include.
>
> **foundedYear** `object`
>
> Company founding-year range.
>
> **fundingYear** `object`
>
> Company funding-year range.
>
> **technologies** `array`
>
> Technologies to include.
>
> **fundingAmount** `object`
>
> Company funding-amount range.
>
> **fundingRounds** `array`
>
> Funding rounds to include.
>
> **semanticQuery** `string`
>
> Natural-language semantic company search query.
>
> **workforceSize** `array`
>
> Absolute workforce filters by department.
>
> **semanticWeight** `number`
>
> Semantic ranking weight from 0 to 1.
>
> **workforceGrowth** `object`
>
> Workforce growth filter.
>
> **categoryOperator** `string ("And" | "Or")`
>
> Operator for category filters; defaults to And.
>
> **keywordsOperator** `string ("And" | "Or")`
>
> Operator for keyword filters; defaults to And.
>
> **reportedEmployees** `array`
>
> Reported employee-count ranges to include.
>
> **technologiesOperator** `string ("And" | "Or")`
>
> Operator for technology filters; defaults to And.
>
> #### 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] Preview Similar Companies
>
> **Slug:** `COMPANYENRICH_PREVIEW_SIMILAR_COMPANIES`
>
> Preview the top 25 similar companies for free. Requires a Scale plan. By default, a missing seed company is enriched on demand. With `wait_for_enrichment=False`, missing domains are scheduled for background enrichment and the request returns 404 with no charge.
>
> #### Input Parameters
>
> **query** `string`
>
> Text query applied to company names and domains.
>
> **cities** `array`
>
> City IDs to include.
>
> **states** `array`
>
> State IDs to include.
>
> **domains** `array`
>
> Seed company domains. Provide between 1 and 10 domains.
>
> **exclude** `object`
>
> Company filters that exclude matching results.
>
> **regions** `array`
>
> Region IDs to include.
>
> **require** `array`
>
> Company features that each result must have.
>
> **revenue** `array`
>
> Revenue ranges to include.
>
> **category** `array`
>
> Company categories to include.
>
> **keywords** `array`
>
> Keywords to include.
>
> **countries** `array`
>
> Two-letter country codes to include.
>
> **employees** `array`
>
> Employee-count ranges to include.
>
> **min\_score** `number`
>
> Minimum similarity score from 0 to 1.
>
> **naics\_code** `array`
>
> NAICS codes, from 2 through 6 digits, to include.
>
> **founded\_year** `object`
>
> Inclusive founded-year range with optional min and max values.
>
> **funding\_year** `object`
>
> Inclusive funding-year range with optional min and max values.
>
> **technologies** `array`
>
> Technologies to include.
>
> **company\_types** `array`
>
> Company types to include.
>
> **funding\_amount** `object`
>
> Inclusive funding amount range with optional min and max values.
>
> **funding\_rounds** `array`
>
> Funding round types to include.
>
> **workforce\_size** `array`
>
> Absolute workforce headcount filters, optionally by department.
>
> **workforce\_growth** `object`
>
> Workforce growth filter including period, department, and percent bounds.
>
> **category\_operator** `string ("And" | "Or")`
>
> Operator used to combine category filters.
>
> **keywords\_operator** `string ("And" | "Or")`
>
> Operator used to combine keyword filters.
>
> **similarity\_weight** `number`
>
> Similarity weighting from -1 to 1; larger values prioritize similarity.
>
> **reported\_employees** `array`
>
> Externally reported employee-count ranges to include.
>
> **wait\_for\_enrichment** `boolean`
>
> Wait for missing seed companies to be enriched. When false, missing domains are scheduled in the background and the request returns 404 with no charge.
>
> **technologies\_operator** `string ("And" | "Or")`
>
> Operator used to combine technology 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] Scroll Company Search
>
> **Slug:** `COMPANYENRICH_SCROLL_COMPANY_SEARCH`
>
> Search and continue company results with an opaque cursor. Costs 1 credit per company returned, with a 1-credit minimum when no results are found. The optional workforce expansion costs 5 credits per company. Returns at most 100 companies per request and supports results beyond 10,000.
>
> #### Input Parameters
>
> **type** `array`
>
> Company types to include.
>
> **lists** `array`
>
> Saved list IDs to filter by.
>
> **query** `string`
>
> Query applied to company names and domains.
>
> **cities** `array`
>
> City IDs to include.
>
> **cursor** `string`
>
> Opaque cursor returned by the preceding scroll response.
>
> **expand** `array`
>
> Response expansions. `workforce` costs 5 credits per company.
>
> **states** `array`
>
> State IDs to include.
>
> **exclude** `object`
>
> Filters that exclude matching companies.
>
> **regions** `array`
>
> Region IDs to include.
>
> **require** `array`
>
> Company features that must be present.
>
> **revenue** `array`
>
> Revenue ranges to include.
>
> **category** `array`
>
> Company categories to include.
>
> **keywords** `array`
>
> Keywords to include.
>
> **pageSize** `integer`
>
> Number of companies to return, between 1 and 100.
>
> **countries** `array`
>
> Two-letter country codes to include.
>
> **employees** `array`
>
> Employee-count ranges to include.
>
> **naicsCode** `array`
>
> NAICS codes to include.
>
> **foundedYear** `object`
>
> Company founding-year range.
>
> **fundingYear** `object`
>
> Company funding-year range.
>
> **technologies** `array`
>
> Technologies to include.
>
> **fundingAmount** `object`
>
> Company funding-amount range.
>
> **fundingRounds** `array`
>
> Funding rounds to include.
>
> **semanticQuery** `string`
>
> Natural-language semantic company search query.
>
> **workforceSize** `array`
>
> Absolute workforce filters by department.
>
> **semanticWeight** `number`
>
> Semantic ranking weight from 0 to 1.
>
> **workforceGrowth** `object`
>
> Workforce growth filter.
>
> **categoryOperator** `string ("And" | "Or")`
>
> Operator for category filters; defaults to And.
>
> **keywordsOperator** `string ("And" | "Or")`
>
> Operator for keyword filters; defaults to And.
>
> **reportedEmployees** `array`
>
> Reported employee-count ranges to include.
>
> **technologiesOperator** `string ("And" | "Or")`
>
> Operator for technology filters; defaults to And.
>
> #### 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 people with cursor pagination
>
> **Slug:** `COMPANYENRICH_SCROLL_PEOPLE_SEARCH`
>
> Searches people based on given criteria using cursor-based pagination. Use when you need to find people at specific companies or with particular roles. You can request the next page of results by using the cursor parameter. Costs 2 credits per person returned, with a 2-credit minimum if no results are found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per person returned; at least one result is billed per request.
>
> #### Input Parameters
>
> **query** `string`
>
> The search query to apply on the company name and domain
>
> **cursor** `string`
>
> The cursor to use for pagination. This is used for cursor based pagination. If this is set, Page will be ignored.
>
> **domains** `array`
>
> The domains to find people for. Up to 100 domains are allowed.
>
> **countries** `array`
>
> The 2 letter country codes to filter by
>
> **page\_size** `integer`
>
> The number of results to return in each page. Must be between 1 and 100
>
> **seniority** `array`
>
> The seniorities to filter by (e.g., c-suite, director, manager, senior, entry)
>
> **department** `array`
>
> The departments to filter by (e.g., engineering-technical, sales, marketing)
>
> **position\_query** `array`
>
> The list of search queries to apply on the person's current job position/title
>
> #### 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] Scroll Similar Companies
>
> **Slug:** `COMPANYENRICH_SCROLL_SIMILAR_COMPANIES`
>
> Scroll similar-company results using an opaque cursor. Costs 5 credits per company returned, with a 5-credit minimum when no results are found. By default, a missing seed company is enriched on demand. With `wait_for_enrichment=False`, missing domains are scheduled for background enrichment and the request returns 404 with no charge.
>
> #### Input Parameters
>
> **query** `string`
>
> Text query applied to company names and domains.
>
> **cities** `array`
>
> City IDs to include.
>
> **cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> **expand** `array`
>
> Optional response expansions. `workforce` costs 5 more credits per company.
>
> **states** `array`
>
> State IDs to include.
>
> **domains** `array`
>
> Seed company domains. Provide between 1 and 10 domains.
>
> **exclude** `object`
>
> Company filters that exclude matching results.
>
> **regions** `array`
>
> Region IDs to include.
>
> **require** `array`
>
> Company features that each result must have.
>
> **revenue** `array`
>
> Revenue ranges to include.
>
> **category** `array`
>
> Company categories to include.
>
> **keywords** `array`
>
> Keywords to include.
>
> **countries** `array`
>
> Two-letter country codes to include.
>
> **employees** `array`
>
> Employee-count ranges to include.
>
> **min\_score** `number`
>
> Minimum similarity score from 0 to 1.
>
> **page\_size** `integer`
>
> Number of companies to return, from 1 through 100.
>
> **naics\_code** `array`
>
> NAICS codes, from 2 through 6 digits, to include.
>
> **founded\_year** `object`
>
> Inclusive founded-year range with optional min and max values.
>
> **funding\_year** `object`
>
> Inclusive funding-year range with optional min and max values.
>
> **technologies** `array`
>
> Technologies to include.
>
> **company\_types** `array`
>
> Company types to include.
>
> **funding\_amount** `object`
>
> Inclusive funding amount range with optional min and max values.
>
> **funding\_rounds** `array`
>
> Funding round types to include.
>
> **workforce\_size** `array`
>
> Absolute workforce headcount filters, optionally by department.
>
> **workforce\_growth** `object`
>
> Workforce growth filter including period, department, and percent bounds.
>
> **category\_operator** `string ("And" | "Or")`
>
> Operator used to combine category filters.
>
> **keywords\_operator** `string ("And" | "Or")`
>
> Operator used to combine keyword filters.
>
> **similarity\_weight** `number`
>
> Similarity weighting from -1 to 1; larger values prioritize similarity.
>
> **reported\_employees** `array`
>
> Externally reported employee-count ranges to include.
>
> **wait\_for\_enrichment** `boolean`
>
> Wait for missing seed companies to be enriched. When false, missing domains are scheduled in the background and the request returns 404 with no charge.
>
> **technologies\_operator** `string ("And" | "Or")`
>
> Operator used to combine technology 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] Search cities by name or country
>
> **Slug:** `COMPANYENRICH_SEARCH_CITIES`
>
> Search for cities by name or country codes. Returns up to 100 cities per page. Use when you need to find cities matching a query string, optionally filtered by country codes.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number to retrieve. 1-indexed.
>
> **query** `string`
>
> The city name to search for. Maximum 30 characters.
>
> **country\_codes** `array`
>
> Filter cities by country codes (ISO 2-letter codes).
>
> #### 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 companies by criteria
>
> **Slug:** `COMPANYENRICH_SEARCH_COMPANIES`
>
> Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. Up to 10,000 results can be returned from this endpoint (page \* pageSize cannot exceed 10,000). For more results, use the scroll endpoint. Costs 1 credit per company returned, with a 1-credit minimum if no results are found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per company returned; at least one result is billed per request.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number to return. Must be greater than 0
>
> **type** `array`
>
> The list of company types to filter by
>
> **lists** `array`
>
> The list IDs to filter by
>
> **query** `string`
>
> The search query to apply on the company name and domain
>
> **cities** `array`
>
> The city IDs to filter by
>
> **states** `array`
>
> The state IDs to filter by
>
> **exclude** `object`
>
> Exclusion filters to apply on the companies.
>
> **regions** `array`
>
> The region IDs to filter by
>
> **require** `array`
>
> The features that must exist for the company
>
> **revenue** `array`
>
> The list of revenue ranges to filter by
>
> **category** `array`
>
> The list of company categories to filter by
>
> **keywords** `array`
>
> The keywords to filter by
>
> **countries** `array`
>
> The 2 letter country codes to filter by
>
> **employees** `array`
>
> The list of employee counts to filter by
>
> **page\_size** `integer`
>
> The number of results to return in each page. Must be between 1 and 100
>
> **naics\_code** `array`
>
> The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included
>
> **founded\_year** `object`
>
> The range of years
>
> **funding\_year** `object`
>
> The range of years
>
> **technologies** `array`
>
> The technologies to filter by
>
> **funding\_amount** `object`
>
> The funding amount range to filter by
>
> **funding\_rounds** `array`
>
> The funding rounds to filter by
>
> **semantic\_query** `string`
>
> The semantic search query to find companies with. More natural language version of the standard query.
>
> **semantic\_weight** `number`
>
> The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default.
>
> **workforce\_growth** `object`
>
> Filter companies by workforce growth percentage over a selected period and department.
>
> **category\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> **keywords\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> **technologies\_operator** `string ("And" | "Or")`
>
> The operator to apply to the filters. Defaults to And.
>
> #### 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 Countries
>
> **Slug:** `COMPANYENRICH_SEARCH_COUNTRIES`
>
> Tool to search countries by name. Returns up to 100 countries per page. Use when you need to find country information including codes, names, and coordinates. Supports pagination and filtering by name query.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination. 1-indexed.
>
> **query** `string`
>
> Search query to filter countries by name. Maximum 30 characters.
>
> #### 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 People
>
> **Slug:** `COMPANYENRICH_SEARCH_PEOPLE`
>
> Searches people based on given criteria using page-based pagination. Up to 10,000 results can be returned from this endpoint (page \* pageSize cannot exceed 10,000). For more results, use the scroll endpoint. Costs 2 credits per person returned, with a 2-credit minimum if no results are found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per person returned; at least one result is billed per request.
>
> #### Input Parameters
>
> **page** `integer` *required*
>
> The page number to return. Must be greater than 0
>
> **query** `string`
>
> The search query to apply on the company name and domain
>
> **domains** `array`
>
> The domains to find people for. Up to 100 domains are allowed.
>
> **pageSize** `integer` *required*
>
> The number of results to return in each page. Must be between 1 and 100
>
> **countries** `array`
>
> The 2 letter country codes to filter by
>
> **seniority** `array`
>
> The seniorities to filter by
>
> **department** `array`
>
> The departments to filter by
>
> **positionQuery** `array`
>
> The list of search queries to apply on the person's current job position/title
>
> #### 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 States
>
> **Slug:** `COMPANYENRICH_SEARCH_STATES`
>
> Tool to search states by name or country codes. Returns up to 100 states per page. Use when you need to find states within a country or search states by name.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.009 per credit used.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number to retrieve (1-indexed).
>
> **query** `string`
>
> The search query for state name (max 30 characters).
>
> **country\_codes** `array`
>
> List of country codes to filter states by (e.g., \['US', 'CA']).
>
> #### 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] Update Company List
>
> **Slug:** `COMPANYENRICH_UPDATE_COMPANY_LIST`
>
> Rename a saved company list. This is a durable mutation of the list.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the CompanyEnrich company list to update.
>
> **name** `string` *required*
>
> The new durable name for the company list.
>
> #### 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
