Skip to main content
GET
Get User Balance History V2

Authorizations

Authorization
string
header
required

Bearer authentication with a personal access token (prefix pat_). Generate tokens in the Truv web app under Settings → API keys.

Query Parameters

link_ids
string[] | null

Filter by specific link IDs. Omit to include all links.

account_ids
string[] | null

Filter by specific account IDs. Omit to include all accounts.

date_range
enum<string>
default:3M

How far back to look. One of: 1_month, 3_months, 6_months, 1_year, all.

Available options:
1M,
3M,
6M,
1Y,
ALL
time_period
enum<string>
default:week

Aggregation granularity for data points. One of: day, week, month.

Available options:
day,
week,
month

Response

Historical balance time series (v2, ClickHouse-backed).

Balance history time series showing assets, liabilities, and net worth over time.

time_series
BalanceHistoryPoint · object[]
required

Chronologically ordered data points.

date_range
string
required

Date range code used for this query.

Example:

"3M"

start_date
string
required

Start date of the time series (YYYY-MM-DD).

Example:

"2025-11-01"

end_date
string
required

End date of the time series (YYYY-MM-DD).

Example:

"2026-02-01"