# Tax balances

GET https://api.bb.no/v1/tax/balance

Fetches the user's current balances: the NOK balance, and the balance of
 each bitcoin account.

## Authentication

x-bb-api-key: Public part of your API key. Starts with `bb/public/`.

Or:

OAuth: Authorization: Bearer <access token>. Required scopes: api:accounts:bitcoin:read.

[API keys and signing](https://barebitcoin.no/developers/authentication/api-keys)

## Parameters

### includeDeleted

query parameter · boolean

Include accounts that have previously been deleted. Useful for resolving
 the name of an account referenced by an older transaction.



## Examples

### API key

```sh
curl -X GET \
  https://api.bb.no/v1/tax/balance \
  -H "x-bb-api-key: $BB_API_KEY"
```


### OAuth

```sh
curl -X GET \
  https://api.bb.no/v1/tax/balance \
  -H "Authorization: Bearer $BB_TOKEN"
```



## Responses

### 200

OK

Example:

```json
{
  "balanceNok": "12500.5",
  "bitcoinAccounts": [
    {
      "id": "acc_01HQZX3V9KJ4M2P8R6T0W5Y7BC",
      "name": "Sparekonto",
      "balanceBtc": "1.89975850",
      "deleteTime": "2025-11-14T09:03:11Z"
    }
  ]
}
```

[GetTaxBalanceResponse](https://barebitcoin.no/developers/models/GetTaxBalanceResponse).

Source: https://barebitcoin.no/developers/api/tax/balances


## Model: GetTaxBalanceResponse





### balanceNok

Type: string.

Stringified decimal number: the user's NOK balance.





### bitcoinAccounts

Type: array of TaxAccountBalance.





Items: [TaxAccountBalance](https://barebitcoin.no/developers/models/TaxAccountBalance).

## Model: TaxAccountBalance





### id

Type: string.







### name

Type: string.







### balanceBtc

Type: string.

Stringified decimal number with 8 decimal places: the BTC balance of the
 account.





### deleteTime

Type: string · date-time.

When this account was deleted. Empty if the account is not deleted. Only
 ever set when the request asked for deleted accounts.