Balances (obsolete)
Last updated
Last updated
The current version of this feature is obsolete. A major redesign of it is in progress.
Authentication: endpoints listed in this page require header authentication with a user token.
GET
https://{domain}.biapi.pro/2.0/users/{userId}/accounts/{accountId}/balances
Get balances (income, outcome and balance) of a single account, for a given period.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Response body: BalanceGroupsList object
Property | Type | Description |
---|---|---|
Property | Type | Description |
---|---|---|
Property | Type | Description |
---|---|---|
accountId*
String
ID of the bank account
min_date
Date
Minimum date (inclusive). The default is the start of the current month.
max_date
Date
Maximum date (inclusive). The default is the end of the current month.
period
String
Split output with the given period. The period is composed with units (days, months, years) and numbers. You can give for example 1month
, 15days
, 1year6months
, etc. The default is 1month
.
bookmarked
String
Whether the bank account is bookmarked.
usage
BankAccountUsage string
Account usage.
balances
Array of BalanceGroup objects
List of balance group items matching the requested period and bounds.
first_date
Date
Minimum available date for results.
last_date
Date
Maximum available date for results.
result_min_date
Date
Minimum date of results in the current response.
result_max_date
Date
Maximum date of results in the current response.
min_date
Date
Start date of the group item.
max_date
Date
End date of the group item.
currencies
Array of BalanceCurrencyGroup objects
List of balance details grouped by currency.
id
String
ISO code of the currency.
symbol
String
Display symbol of the currency.
balance
Decimal
Balance of the account at the end of the period group.
expenses
Decimal
Total of expenses over the period group.
incomes
Decimal
Total of incomes over the period group.
remains
Decimal
Difference between expenses and incomes over the period group.