> ## Documentation Index
> Fetch the complete documentation index at: https://help.mytruv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Balance History object

> Historical balance time series showing assets, liabilities, and net worth over time.

The Balance History response provides chronologically ordered data points tracking assets, liabilities, and net worth. Supports filtering by link, account, date range, and time period.

## Response attributes

| Attribute    | Type             | Description                                                 |
| :----------- | :--------------- | :---------------------------------------------------------- |
| time\_series | array of objects | Chronologically ordered data points                         |
| date\_range  | string           | Date range code used for this query (e.g. `3M`, `6M`, `1Y`) |
| start\_date  | string           | Start date of the time series (YYYY-MM-DD)                  |
| end\_date    | string           | End date of the time series (YYYY-MM-DD)                    |

## Time series point attributes

| Attribute   | Type   | Description                          |
| :---------- | :----- | :----------------------------------- |
| date        | string | Date of this data point (YYYY-MM-DD) |
| assets      | string | Total asset balance                  |
| liabilities | string | Total liability balance              |
| net\_worth  | string | Net worth (assets minus liabilities) |

***

## Endpoints

* [Get balance history](/api-reference/balance-history/get-balance-history)

***

## Example response

```json theme={null}
{
  "time_series": [
    {
      "date": "2025-11-03",
      "assets": "98635.00",
      "liabilities": "58320.75",
      "net_worth": "40314.25"
    },
    {
      "date": "2025-11-10",
      "assets": "99100.00",
      "liabilities": "58100.00",
      "net_worth": "41000.00"
    }
  ],
  "date_range": "3M",
  "start_date": "2025-11-01",
  "end_date": "2026-02-01"
}
```
