Company / Export

Create export job

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.

post/companies/search/async

Request

  • Base URL: https://api.companyenrich.com
  • URL: https://api.companyenrich.com/companies/search/async
  • Auth: API key in header Authorization

Query parameters

expandstring[]

Expandable response fields. Repeat the parameter to request multiple expansions.

Supported values:

  • workforce: costs 5 credits per company and adds the workforce field to CompanyInfo.

Request body

countinteger required

The number of companies to export.

webhook_urlstring uri nullable

The webhook URL to receive the notification when processing completes.

Response

OK

job_idstring uuid

Unique identifier for the search export job.

status'pending' | 'processing' | 'completing' | 'completed' | 'failed'

Current status of the job (pending, processing, completing, completed, failed).

requested_countinteger

Number of companies requested for export.

total_matchinginteger

Total number of companies matching the search criteria.

estimated_creditsinteger

Estimated credit cost for the export job.

Changes

No recorded changes to this operation across all 1 revision of this API.