Batch Enrich Accounts

Start an async job to enrich multiple company accounts with firmographic data.

Accepts up to 500 domains. Domains are deduplicated and normalized. Returns a job_id immediately for polling.

Flow:

1. Call this endpoint with domains list -> receive job_id
2. Poll GET /api/v1/enrich/accounts/{job_id} every 3-5 seconds
3. When status is "completed", the result field contains per-domain enrichment data

POST /api/v1/enrich/accounts

Batch Enrich Accounts

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/enrich/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "domains": [
    "<string>"
  ]
}
'

200

{
  "job_id": "<string>",
  "message": "<string>",
  "total_accounts": 123,
  "status": "pending"
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

Request to enrich multiple company accounts with firmographic data in one batch.

Starts an async job. Poll GET /api/v1/enrich/accounts/{job_id} for results.

domains · string[] · required

List of company domains to enrich (max 500 per request)

Required array length: 1 - 500 elements

Example:

["stripe.com", "notion.so", "databricks.com"]

Response

200

application/json

Successful Response

Response from starting a batch account enrichment job.

job_id · string · required

Unique job ID for polling via GET /api/v1/enrich/accounts/{job_id}

message · string · required

Human-readable status message

total_accounts · integer · required

Number of unique domains queued for enrichment

status · string · default: pending

Job status - always 'pending' at creation