Skip to main content
POST
/
v1
/
enrich
/
company
Enrich Company
curl --request POST \
  --url https://api.example.com/v1/enrich/company \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": "<string>",
  "domain": "<string>",
  "fields": [
    {}
  ],
  "overwrite": true
}
'
{
  "data": {
    "company": {},
    "fields_updated": [
      {}
    ],
    "source": "<string>",
    "confidence": 123,
    "credits_remaining": 123
  }
}
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

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json
​
Idempotency-Key
string
Optional UUID for deduplicating retries within 24 hours.

​
Body Parameters

​
company_id
string
UUID of an existing company record. Supply either company_id or domain.
​
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.
​
fields
array
Optional whitelist of firmographic fields: name, industry, size, founded_year, description, hq_location, logo_url, linkedin_url, tech_stack.
​
overwrite
boolean
default:"false"
When true, enrichment overwrites non-empty fields. Defaults to false (fill-only mode).

​
Response

​
data
object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID. 
curl -X POST \
  https://data.leadlex.com/functions/v1/api-gateway/v1/enrich/company \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain": "acme.com"}'

​
Example Response

{
  "data": {
    "company": {
      "id": "c0mpany-uuid-0001",
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Legal Services",
      "size": "201-500",
      "founded_year": 1998,
      "hq_location": "New York, NY, US",
      "linkedin_url": "https://linkedin.com/company/acme"
    },
    "fields_updated": ["industry", "size", "founded_year", "hq_location"],
    "source": "vendor_a",
    "confidence": 0.87,
    "credits_remaining": 4870
  }
}

​
Errors

StatusCodeDescription
400validation_errorNeither company_id nor domain provided
401invalid_keyInvalid or expired API key
402insufficient_creditsWorkspace credit balance is exhausted
403insufficient_permissionsMissing write:enrich permission
404not_foundSupplied company_id does not exist in this workspace
409no_matchUpstream providers returned no data for the input
429rate_limitedRate limit exceeded