K-φ (K-Phi) Cash Forecast API
The Cash Forecast API from K-φ (K-Phi) — 1 operation(s) for cash forecast.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/k-phi-com:k-phi-com-cash-forecast-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
openapi: 3.2.0
info:
title: K-φ Cash Forecast 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: Cash Forecast
paths:
/api/v1/cash_forecast:
get:
operationId: get_cash_forecast
summary: Assembled cash forecast
x-audience: data
description: 'K-φ’s cash forecast as of today: bank balances (actual), the recurring movements history predicts (extrapolated, kept apart), open invoices at their due date and transfers in flight (committed), and the FP&A projection by month (planned, net of the invoices due in the month). One line per movement with its source and certainty, a summary per currency (opening, low point and its date, closing, totals by layer), the consumption of the plan by invoices, and an inputs hash: the same data gives the same forecast. Use for "when do I go under", "a 90-day forecast per currency", "what is committed vs planned". Pass extra_lines to add the user’s own movements (a sheet, typed lines).'
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: horizon_days
in: query
required: false
description: 7 to 365, default 90
schema:
type: number
- name: sources
in: query
required: false
description: 'Default: all six (typed = the cash forecasts typed or pasted in Banking)'
schema:
type: string
- name: extra_lines
in: query
required: false
description: The user’s own movements, added as committed unless a certainty is given
schema:
type: string
- name: max_lines
in: query
required: false
description: Lines returned, 50 to 2000, default 400 (the summary always covers all lines)
schema:
type: number
tags:
- Cash Forecast
post:
operationId: post_cash_forecast
summary: Assembled cash forecast
x-audience: data
description: 'K-φ’s cash forecast as of today: bank balances (actual), the recurring movements history predicts (extrapolated, kept apart), open invoices at their due date and transfers in flight (committed), and the FP&A projection by month (planned, net of the invoices due in the month). One line per movement with its source and certainty, a summary per currency (opening, low point and its date, closing, totals by layer), the consumption of the plan by invoices, and an inputs hash: the same data gives the same forecast. Use for "when do I go under", "a 90-day forecast per currency", "what is committed vs planned". Pass extra_lines to add the user’s own movements (a sheet, typed lines).'
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:
horizon_days:
type: number
description: 7 to 365, default 90
sources:
type: array
items:
type: string
enum:
- actual
- extrapolation
- typed
- arap
- transfers
- fpa
description: 'Default: all six (typed = the cash forecasts typed or pasted in Banking)'
extra_lines:
type: array
items:
type: object
properties:
value_date:
type: string
amount:
type: number
currency:
type: string
note:
type: string
certainty:
type: string
enum:
- committed
- planned
- extrapolated
account_name:
type: string
entity:
type: string
reference:
type: string
required:
- value_date
- amount
description: The user’s own movements, added as committed unless a certainty is given
max_lines:
type: number
description: Lines returned, 50 to 2000, default 400 (the summary always covers all lines)
additionalProperties: false
tags:
- Cash Forecast
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