Skip to main content
POST
Enrich Company
This endpoint consumes enrichment credits. Each successful enrichment costs 1 credit. Requests that fail to match any provider do not consume a credit and return 409 no_match. If the workspace’s balance is exhausted, the API returns 402 insufficient_credits.

Request

Headers

string
Optional UUID for deduplicating retries within 24 hours.

Body Parameters

string
UUID of an existing company record. Supply either company_id or domain.
string
Canonical company domain (e.g. acme.com). Used when you do not yet have a company record. The API will create or return the matching company.
array
Optional whitelist of firmographic fields: name, industry, size, founded_year, description, hq_location, logo_url, linkedin_url, tech_stack.
boolean
default:"false"
When true, enrichment overwrites non-empty fields. Defaults to false (fill-only mode).

Response

object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.

Example Response

Errors