wealthschema
wealthschema/schemas

Schema Browser

A high-level view of the WealthSynth household schema across 7 sections. Two representative fields per section are shown below; the full field-level reference — types, ranges, derivation logic, and example values — ships in the Methodology PDF with every Wealth Data Set.

Sections
→household→demographics→income→net_worth→accounts→liabilities→taxes

household

Top-level household record with demographics and summary statistics

field
type
example
description
household_id
string
syn_A-01_0017
Unique synthetic household identifier. Format: syn_{archetype_id}_{sequence}
archetype
string
young-family-first-home
Archetype slug. Maps to one of the 71 defined archetypes.

+4 more fields in household — full reference in the Methodology PDF.

demographics

Household composition, ages, and filing status

field
type
example
description
household_type
enum
married_joint
single | married_joint | married_separate | head_of_household | qualifying_widow
primary_age
integer
42
Age of primary earner in years

+4 more fields in demographics — full reference in the Methodology PDF.

income

All income sources with gross and net breakdowns

field
type
example
description
w2_primary
number
215000
Primary earner W-2 gross income (USD)
w2_spouse
number | null
0
Spouse W-2 gross income. Null for single earner households.

+5 more fields in income — full reference in the Methodology PDF.

net_worth

Total, liquid, and illiquid net worth components

field
type
example
description
total
number
312500
Total net worth (assets minus liabilities)
liquid
number
38000
Liquid assets (cash + taxable investments)

+4 more fields in net_worth — full reference in the Methodology PDF.

accounts

Individual account balances by type

field
type
example
description
checking_savings
number
22000
Combined checking and savings balances
taxable_brokerage
number
16000
Taxable investment account balance

+6 more fields in accounts — full reference in the Methodology PDF.

liabilities

Debt obligations with balance and rate

field
type
example
description
mortgage_balance
number
415000
Outstanding primary mortgage balance
mortgage_rate
number
0.0625
Primary mortgage interest rate (decimal)

+4 more fields in liabilities — full reference in the Methodology PDF.

taxes

Tax profile and estimated liability

field
type
example
description
filing_status
enum
MFJ
MFJ | MFS | S | HOH | QW
effective_rate
number
0.21
Effective federal income tax rate

+4 more fields in taxes — full reference in the Methodology PDF.

See the full schema in context

Every Wealth Data Set ships with a Methodology PDF that documents every field by type, range, derivation, and source. Want to see the full schema before you buy? Request the watermarked sample household — it lands in your inbox in a real WealthSynth JSON, with every section populated.

Request the sample householdBrowse Wealth Data Sets