Skip to main content
GET
/
v1
/
users
/
balance-history
Get User Balance History Endpoint
curl --request GET \
  --url https://api.mytruv.com/v1/users/balance-history \
  --header 'Authorization: Basic <encoded-value>'
{
  "time_series": [
    {
      "date": "2025-11-03",
      "assets": "98635.00",
      "liabilities": "58320.75",
      "net_worth": "40314.25"
    }
  ],
  "date_range": "3M",
  "start_date": "2025-11-01",
  "end_date": "2026-02-01"
}

Authorizations

​
Authorization
string
header
required

Use user_id as username and access_token as password.

Query Parameters

​
link_ids
string[] | null
Example:
["d192a4f1cc7f4f05a105c9dd8ab703fb"]
​
account_ids
string[] | null
Example:
["545b8f1b114b4d2188998b5c5a5ab79e"]
​
date_range
enum<string>
default:3M

Supported date ranges for balance history queries.

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

Aggregation granularity for balance history data points.

Available options:
day,
week,
month

Response

Successful Response

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"