CompanyEnrich

Delete a company list (Delete list) via DELETE /lists/companies/{id}. Deletes a list and all its entries. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Get a company by ID (Get by ID) via GET /companies. **Cost:** 1 credits per call Gets a company information by its CompanyEnrich ID. You can obtain this ID by calling the Enrich endpoint or other endpoints returning company information. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Autocomplete company domains via GET /companies/autocomplete. **Cost:** FREE - No credits deducted 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.

Enrich a company by domain (Enrich by domain) via GET /companies/enrich. **Cost:** 1 credit per call Enriches a company using its domain name as lookup parameter. We map each domain to a unique company so lookups via domain are fast and reliable. It is the preferred way to enrich a company. In case the domain name could not be enriched, the API will return a 404 error. Set `waitForEnrichment=false` to skip waiting for on-demand enrichment. Already stored company data is returned immediately. When the company is not stored yet, the API returns a 404 error without charging any credits and schedules the enrichment in the background, so a later call can return the company quickly. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Get a bulk company enrichment job (Get job status) via GET /companies/enrich/bulk/{jobId}. **Cost:** FREE - No credits deducted Returns the current status of a bulk enrichment job. Once completed, includes the results_url to download the enrichment results.

List bulk company enrichment jobs (List jobs) via GET /companies/enrich/bulk/jobs. **Cost:** FREE - No credits deducted Returns a paginated list of all bulk enrichment jobs for the authenticated user. Supports optional filtering by job status.

Get a company search export job (Get export job status) via GET /companies/search/async/{jobId}. **Cost:** FREE - No credits deducted Returns the current status of a search export job. Once completed, includes the results_url to download the export results.

List company search export jobs (List export jobs) via GET /companies/search/async/jobs. **Cost:** FREE - No credits deducted Returns a paginated list of all search export jobs for the authenticated user. Supports optional filtering by job status.

Get company workforce insights via GET /companies/workforce. **Cost:** 5 credits per successful call 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. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Get a country by code (Get country by code) via GET /geo/countries/{countryCode}. Searches a country by its ISO 3166-1 alpha-2 code. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Get regions via GET /geo/regions. Returns all regions. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

List industries via GET /industries. Obtain a list of all company industries. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

List all jobs via GET /jobs. **Cost:** FREE - No credits deducted Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user. Supports optional filtering by job status and type.

Get job details via GET /jobs/{jobId}. **Cost:** FREE - No credits deducted Returns details for a specific job by ID.

Look up keywords (Lookup keywords) via GET /keywords/autocomplete. Endpoints for looking up keywords used in company search filters. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Get all company lists (Get all lists) via GET /lists/companies. Get all company lists for the current user. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Get a company list by id (Get a list by id) via GET /lists/companies/{id}. Get a company list by id. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Get current user information via GET /me. **Cost:** FREE - No credits deducted Returns information about the authenticated user, including their API key, credit balance, and account capabilities. This endpoint requires authentication via an API key in the Authorization header.

Get a person by ID (Get by ID) via GET /people. **Cost:** 2 credits per call Gets person information by its CompanyEnrich ID. You can obtain this ID from people search results, lookup responses, and other endpoints returning person information. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Get a person's education history via GET /people/education. **Cost:** 1 credit per successful call Returns the education history for a person by their CompanyEnrich ID. The response is an empty array when the person has no education records. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Resolve a person's work email (BETA) via GET /people/email. **BETA:** This endpoint is currently in beta and may change based on provider coverage and response tuning. **Cost:** 10 credits per newly accessed found email Resolves a work email address for a single person on a specific domain. If `domain` is omitted, current experience domains are tried automatically in seniority order. If `domain` is provided, it must match one of the person's experiences. The response does not expose provider details. It returns a person summary, the selected domain, and a status of `pending`, `found`, `not-found`, or `unavailable`. When the lookup completes successfully, the response also includes the resolved email and certainty value. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Get a bulk person email enrichment job (BETA) (Get bulk email enrichment job status (BETA)) via GET /people/email/bulk/{jobId}. **BETA:** This endpoint is currently in beta and may change based on provider coverage, job orchestration, and response tuning. **Cost:** FREE - No credits deducted Returns the current status of a bulk person email enrichment job. Once completed, includes the results_url to download the full results.

Get a people search export job (Get export job status) via GET /people/search/async/{jobId}. **Cost:** FREE - No credits deducted Returns the current status of a person search export job. Once completed, includes the results_url to download the export results.

List people search export jobs (List export jobs) via GET /people/search/async/jobs. **Cost:** FREE - No credits deducted Returns a paginated list of all person search export jobs for the authenticated user. Supports optional filtering by job status.

Look up positions (Lookup positions) via GET /positions/autocomplete. Endpoints for looking up job positions and titles used in people search filters. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Look up technologies (Lookup technologies) via GET /technologies/autocomplete. Endpoints for looking up technologies used in company search filters. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Enrich a company by properties (Enrich by properties) via POST /companies/enrich. **Cost:** 1 credit per call Enriches a company using its properties. You need to 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. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Batch enrich companies by domain via POST /companies/enrich/batch. **Cost:** 1 credit per domain enriched Enriches a list of companies using their domain names. Up to 50 domains can be provided in a single request. We map each domain to a unique company so lookups via domain are fast and reliable. It is the preferred way to enrich a company. Batching is recommended for larger lists of domains. It allows you to enrich multiple companies in a single request. Eliminating the need to make multiple requests to the API. Also the rate limiter would be able to handle more requests. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Create a bulk company enrichment job (Create job) via POST /companies/enrich/bulk. **Cost:** 1 credit per domain successfully enriched (charged on completion) Creates an asynchronous bulk enrichment job for up to 10,000 domains. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Search companies via POST /companies/search. **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. If you need more results, please use the pagination parameters. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search, Preview a company search.

Create a company search export job (Create export job) via POST /companies/search/async. **Cost:** 1 credit per company returned (reserved when the job is created, settled on completion) Creates an asynchronous search export job for up to 50,000 companies. Supports both standard company search and similar-company search. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search.

Count companies matching a search via POST /companies/search/count. **Cost:** FREE - No credits deducted Returns the total count of companies matching the given search criteria without retrieving the actual results.

Preview a company search via POST /companies/search/preview. **Cost:** FREE - No credits deducted **Requirements:** Requires **Scale** plans **Notice:** Returns top 25 results only Preview search for companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. This endpoint returns the top 25 results for free, perfect for previewing search results before running a full search.

Scroll a company search via POST /companies/search/scroll. **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search, Preview a company search.

Find similar companies via POST /companies/similar. **Cost:** 5 credit per company returned. 5 credits if no results are found. Finds similar companies to the given company by id or domain. The POST route allows specifying further filtering parameters. At most 100 companies are returned per request. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count similar companies, Preview similar companies.

Count similar companies via POST /companies/similar/count. **Cost:** FREE - No credits deducted Returns the total count of similar companies matching the given search criteria without retrieving the actual results. CompanyEnrich's own OpenAPI document declares no success response for this endpoint (only 400, 401, 402, 404, 422 and 429), so no output schema is advertised. Its twin, Count companies matching a search, returns a bare integer.

Preview similar companies via POST /companies/similar/preview. **Cost:** FREE - No credits deducted **Requirements:** Requires **Scale** plans **Notice:** Returns top 25 results only Preview search for similar companies based on given criteria. You can search by domain, industry, employees, revenue, founded year, and more. This endpoint returns the top 25 similar companies for free, perfect for previewing results before running a full similar search.

Scroll similar companies via POST /companies/similar/scroll. **Cost:** 5 credit per company returned. 5 credits if no results are found. Finds similar companies to the given company by id or domain. The POST route allows specifying further filtering parameters. At most 100 companies are returned per request. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count similar companies, Preview similar companies.

Search cities via POST /geo/cities. Searches cities by name or country codes. Returns up to 100 cities per page. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Search countries via POST /geo/countries. Searches countries by name. Returns up to 100 countries per page. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Search states via POST /geo/states. Searches states by name or country codes. Returns up to 100 states per page. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.

Create a company list (Create list) via POST /lists/companies. **Cost:** - For search: 1 credit per company returned. 1 credit if no results are found. - For similar: 5 credits per company returned. 5 credits if no results are found. Creates a new list based on a search or similar company request. Up to first 5000 results can be selected to be added to the list. If no companies are found, the list is not created. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search, Count similar companies.

Create a bulk person email enrichment job (BETA) (Create bulk email enrichment job (BETA)) via POST /people/email/bulk. **BETA:** This endpoint is currently in beta and may change based on provider coverage, job orchestration, and response tuning. **Cost:** up to 10 credits per item (charged on completion for newly accessed found emails only) Creates an asynchronous bulk person email enrichment job for up to 1,000 lookup items. When `domain` is omitted for an item, current experience domains are tried in seniority order. Processing happens asynchronously in the background. Use the status endpoint to monitor progress and retrieve the results download URL. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Look up a person by email (Lookup person) via POST /people/lookup. **Cost:** 5 credits per successful call Looks 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. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Search people via POST /people/search. **Cost:** 2 credits per person returned. 2 credits minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches people based on given criteria using page-based pagination. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search.

Create a people search export job (Create export job) via POST /people/search/async. **Cost:** 2 credits per person returned (reserved when the job is created, settled on completion) Creates an asynchronous search export job for up to 50,000 people. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance.

Scroll a people search via POST /people/search/scroll. **Cost:** 2 credits per person returned. 2 credits minimum if no results are found. Searches people based on given criteria using cursor-based pagination. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. SPENDS CREDITS: this call is billed against the connected CompanyEnrich account's credit balance on the terms in the cost line above -- per call and, where it says so, per result returned. A free trial carries 500 credits. GET /me reports the remaining balance. Size the same query for free first with: Count companies matching a search.

Update a company list (Update list) via PUT /lists/companies/{id}. Updates a list's properties. CompanyEnrich's endpoint reference states no credit cost for this call. Its pricing guide groups autocomplete, count, job-status and list endpoints with the free ones, but the cost is not documented here, so treat it as unstated rather than guaranteed free.