Skip to main content
POST
/
api
/
v1
/
enrich
/
accounts
Batch Enrich Accounts
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>"
  ]
}
'
{
  "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

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