API Docs

Household Data Fields

Fields returned in the household object when a household match is found. Available fields depend on your Windfall plan.

Identification & Match Quality

windfall_id string

Windfall's unique 32-character household identifier.

confidence float

Match confidence score, 0.1 to 1.0. Higher values indicate a stronger match.

Wealth & Net Worth

net_worth number

Estimated household net worth. Granularity at hundreds of thousands.

low_confidence_net_worth number

Lower bound of the net worth estimate.

high_confidence_net_worth number

Upper bound of the net worth estimate.

net_worth_last_calculated date

Date the net worth was last calculated. Format: YYYY-MM-DD.

loan_to_value float

Outstanding loans against property values, as a decimal (e.g. 0.15 = 15%).

Property & Assets

multi_property_owner boolean

Household owns multiple properties.

rental_property_owner boolean

Household owns a rental property.

boat_owner boolean

Household owns a boat.

plane_owner boolean

Household owns a plane.

Life Events

recent_mover boolean

Household has moved in the last 6 months.

recently_divorced boolean

Household has experienced a divorce in the last 6 months.

recent_death_in_family boolean

Household has had a death in the last 6 months.

Philanthropy

philanthropic_giver boolean

Household has given philanthropically in the last 60 months.

top_philanthropic_donor boolean

At least $10K in philanthropic giving in the last 12 months.

philanthropic_cause string[]

NTEE codes for causes the household supports (e.g. A = Arts, Culture, and Humanities).

regional_focus string[]

Geographical focus of giving: Local, State, Regional, National, International.

donor_advised_funds boolean

Household is associated with a donor-advised fund.

foundation_association boolean

Household is associated with a foundation.

foundation_officer_trustee boolean

A member of the household is a foundation officer or trustee.

nonprofit_board_member boolean

A member of the household is a nonprofit board member.

Political

political_donor boolean

Household has contributed to a political campaign in the last 60 months.

top_political_donor boolean

At least $10K in political donations in the last 12 months.

political_party string

Democrat, Republican, or Independent.

Financial Signals

money_in_motion boolean

Recent SEC insider trading activity (at least $10K in the last 12 months).

liquidity_trigger boolean

Household has had significant recent spend.

has_household_debt boolean

Household has mortgages associated with it.

crypto_interest boolean

Household has an interest in cryptocurrency.

small_business_owner boolean

A member of the household is a small business owner.

trust_association boolean

Household is associated with a trust.

Data Quality

primary_address_incorrect boolean

Windfall has a more accurate address on file for this household.

The fields available to your organization depend on your Windfall plan. Contact us to learn about adding more household data fields.

Windfall updates its data on a weekly basis. Boolean field timeframes (e.g. “last 6 months”, “last 60 months”) can be customized based on your requirements.