Skip to main content
POST
/
api
/
v1
/
enrich
/
account
Enrich Account
curl --request POST \
  --url https://api.openfunnel.dev/api/v1/enrich/account \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "domain": "<string>"
}
'
{
  "account_id": 123,
  "domain": "<string>",
  "is_new_account": true,
  "firmographics": {
    "employee_count": 123,
    "funding_stage": "<string>",
    "location": "<string>",
    "hq_city": "<string>",
    "hq_region": "<string>",
    "hq_country": "<string>",
    "industry": "<string>",
    "revenue_usd": 123,
    "linkedin_follower_count": 123
  },
  "name": "<string>",
  "linkedin_url": "<string>",
  "fields_updated": [
    "<string>"
  ]
}

Headers

X-API-Key
string
required
X-User-ID
string
required

Body

application/json

Request to enrich a company account with firmographic data.

Provide a company domain to look up firmographic data (employee count, funding stage, HQ location, industry, revenue, LinkedIn followers, description). If the account already exists, missing fields are backfilled. If not, a new account is created with all available data.

domain
string
required

Company website domain (e.g., 'stripe.com', 'notion.so')

Required string length: 1 - 200
Examples:

"stripe.com"

"notion.so"

"databricks.com"

Response

Successful Response

Response from account firmographic enrichment.

Contains the enriched account with all available firmographic data. fields_updated lists which fields were newly populated (empty if the account already had all data or no data was found for this domain).

account_id
integer
required

Account ID in OpenFunnel

domain
string
required

Normalized company domain

is_new_account
boolean
required

True if a new account was created, False if an existing account was updated

firmographics
AccountFirmographics · object
required

Firmographic data from enrichment

name
string | null

Company name

linkedin_url
string | null

LinkedIn company page URL

fields_updated
string[]

List of firmographic field names that were newly populated. Empty if all fields were already set or no data was found. Possible values: employee_count, funding_stage, location, hq_city, hq_region, hq_country, industry, revenue_usd, linkedin_follower_count, description