Get Income
Get aggregated income report from all payroll and bank sources.
Aggregates income data from all connected payroll providers and bank accounts. Bank income is converted to the same format as payroll employment records. Duplicate income sources (visible from both payroll and bank) are deduplicated using fuzzy name matching, with preference given to payroll data.
Each employment record includes:
data_source:'payroll'or'financial_accounts'provider: data provider name (e.g.'adp','chase')company: employer / income source details, includinglogo_urlwhen a company logo is availablestatements: pay statements filtered to the requested date rangeincome,pay_rate,pay_frequency: compensation details
Authorizations
Bearer authentication with a personal access token (prefix pat_). Generate tokens in the Truv web app under Settings → API keys.
Query Parameters
Number of days of income history to include (1-365). Defaults to 90.
1 <= x <= 365Response
Aggregated income report from payroll and bank sources.
Aggregated income report combining payroll and bank account sources.
Employment records from payroll providers and bank transaction-based income
are merged and deduplicated. Each employment includes a data_source field
('payroll' or 'financial_accounts') to identify its origin.
Combined employment / income records from all connected sources. Each item contains data_source ('payroll' or 'financial_accounts'), provider name, company info, statements, income details, and more.