---
title: "Bank movements: recent first, or the largest first"
method: POST
path: "/api/v1/bank_transactions"
---

# Bank movements: recent first, or the largest first

`POST /api/v1/bank_transactions`

## 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_transactions`
- Auth: HTTP bearer

Bank movements: recent first, or the largest first. Filter by date, text (description or counterparty), direction (in / out), account (name or id), entity and currency. A since date older than the recent window searches the Banking archive too, so any period the banks have sent can be read. Returns how many movements matched and which window was searched. Use for "did X pay", "what were the big outflows this week", "everything on the EUR account in March".

## Request body

- object
  - `since` string: YYYY-MM-DD; older than the recent window = the archive is searched too
  - `until` string: YYYY-MM-DD, default today
  - `search` string: Text in the description or the counterparty
  - `direction` 'in' | 'out'
  - `order` 'recent' | 'largest'
  - `account` string: Bank account name (part of it) or id
  - `entity` string: Entity code
  - `currency` string: ISO code, e.g. EUR
  - `limit` number: 1 to 100, default 25

## 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)