---
title: "Bank balances over time, per account: one point per day (or the last known balance of each month with granularity month_end), each with its source — reported (what the bank said at a sync), statement"
method: POST
path: "/api/v1/bank_balance_history"
---

# Bank balances over time, per account: one point per day (or the last known balance of each month with granularity month_end), each with its source — reported (what the bank said at a sync), statement

`POST /api/v1/bank_balance_history`

## Request

- Base URL: `https://k-phi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://k-phi.com/api/v1/bank_balance_history`
- Auth: HTTP bearer

Bank balances over time, per account: one point per day (or the last known balance of each month with granularity month_end), each with its source — reported (what the bank said at a sync), statement (a statement closing balance) or computed (rebuilt from the transactions). Filter by account, entity, currency and dates (default: the last 90 days). Use for "how did cash evolve this quarter", "what was the balance on 30 June", "month-end balances this year".

## Request body

- object
  - `since` string: YYYY-MM-DD, default 90 days before until
  - `until` string: YYYY-MM-DD, default today
  - `granularity` 'day' | 'month_end': Default day
  - `account` string: Bank account name (part of it) or id
  - `entity` string: Entity code
  - `currency` string: ISO code

## Response `200`

OK

- object
  - `data` object
  - `meta` object
    - `api` string
    - `capability` string
    - `at` string

## Other responses

- `401`: No or invalid credential
- `403`: Scope, extension or Builder Mode refused
- `422`: The capability refused the input
- `429`: Rate or daily quota reached

---

[API](https://skmtc.dev/k-phi/apis/k-api.md) · [All operations](https://skmtc.dev/k-phi/apis/k-api/llms.txt) · [OpenAPI document](https://skmtc.dev/k-phi/apis/k-api/revisions/60b28690ec35?raw)