K-φ (K-Phi) Bank Balance History API

The Bank Balance History API from K-φ (K-Phi) — 1 operation(s) for bank balance history.

GitHub OpenAPI

Operations 2

GET /api/v1/bank_balance_history Bank balances over time #
POST /api/v1/bank_balance_history Bank balances over time #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/k-phi-com:k-phi-com-bank-balance-history-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

k-phi-com-bank-balance-history-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: K-φ Bank Balance History API
  version: 1.0.0
  description: 'Read your K-φ data (statements, cash, forecasts, scenarios) and save scenarios. The tenant always comes from the credential. Every response is { data, meta }; every error { error: { code, message } }.'
tags:
- name: Bank Balance History
paths:
  /api/v1/bank_balance_history:
    get:
      operationId: get_bank_balance_history
      summary: Bank balances over time
      x-audience: data
      description: '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".'
      x-scope: read:cash
      x-extension-only: false
      security:
      - bearer: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                  meta:
                    type: object
                    properties:
                      api:
                        type: string
                      capability:
                        type: string
                      at:
                        type: string
        '401':
          description: No or invalid credential
        '403':
          description: Scope, extension or Builder Mode refused
        '422':
          description: The capability refused the input
        '429':
          description: Rate or daily quota reached
      parameters:
      - name: since
        in: query
        required: false
        description: YYYY-MM-DD, default 90 days before until
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: YYYY-MM-DD, default today
        schema:
          type: string
      - name: granularity
        in: query
        required: false
        description: Default day
        schema:
          type: string
      - name: account
        in: query
        required: false
        description: Bank account name (part of it) or id
        schema:
          type: string
      - name: entity
        in: query
        required: false
        description: Entity code
        schema:
          type: string
      - name: currency
        in: query
        required: false
        description: ISO code
        schema:
          type: string
      tags:
      - Bank Balance History
    post:
      operationId: post_bank_balance_history
      summary: Bank balances over time
      x-audience: data
      description: '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".'
      x-scope: read:cash
      x-extension-only: false
      security:
      - bearer: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                  meta:
                    type: object
                    properties:
                      api:
                        type: string
                      capability:
                        type: string
                      at:
                        type: string
        '401':
          description: No or invalid credential
        '403':
          description: Scope, extension or Builder Mode refused
        '422':
          description: The capability refused the input
        '429':
          description: Rate or daily quota reached
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                since:
                  type: string
                  description: YYYY-MM-DD, default 90 days before until
                until:
                  type: string
                  description: YYYY-MM-DD, default today
                granularity:
                  type: string
                  enum:
                  - day
                  - month_end
                  description: Default day
                account:
                  type: string
                  description: Bank account name (part of it) or id
                entity:
                  type: string
                  description: Entity code
                currency:
                  type: string
                  description: ISO code
              additionalProperties: false
      tags:
      - Bank Balance History
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key, OAuth access token, extension key (kphix_…) or extension session token (kxs1.…)
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with the gl:ingest scope (ERP connectors)
x-scopes:
  gl:ingest: Push GL data from an ERP (/api/gl/mappings, /api/gl/schema, /api/gl/ingest)
  mcp:tools: All read scopes (read:gl read:cash read:forecast read:sheets read:data)
  mcp:write: All MCP write scopes (write:scenarios write:config write:data write:sheets)
  read:gl: Read statements, KPIs, ratios, GL lines, versions, dimensions, variance, data lake, FX rates and FP&A settings
  read:cash: Read bank positions, transactions, balance history, cash forecast, AR/AP
  read:forecast: Read forecasts, budgets, scenarios (levers, list, run) and valuations
  read:sheets: Read the Google Sheets registered as inputs of the account, each tab as JSON (/api/v1/sheets/…), and their webhooks' deliveries (2026-11-02)
  write:sheets: 'Register and remove the Google Sheets the account serves as JSON (read only: K-φ never writes to a sheet), and the webhooks told when one changes'
  read:data: 'Read the Data library (/api/v1/data/…): market, macro and public series with their source and licence (2026-11-03)'
  write:vars: 'Define, load and remove the account''s own variables (var.<CODE>) of the Data library, and nothing else: never the books (2026-11-05)'
  write:scenarios: Save scenarios (Simulation page)
  write:config: 'Change tenant configuration: flow rules, classification overrides, budget versions and templates, valuation refresh'
  write:data: 'Import rows from a spreadsheet Claude read (Excel in, 2026-10-29): cash forecasts, a GL version, a bank statement; preview first, then commit'
  run:build: 'Call the BUILD''s functions that only read (POST /api/v1/fn/<name>): the logic the account built, served as an API (2026-10-29)'
  run:build:write: 'Also call the BUILD''s functions that change data (declared "writes": true in its kphi.json)'
x-limits:
  per_ip_per_min: 200
  extension_per_min: 120
  extension_per_day: 20000