Skip to main content

Get Cash Flow Projection

GET 

/api/v2/cash-flow/projection

Rolling per-month cash runway: sales cash-in vs supplier payables from the PO cash-flow schedule (deposits vs balances), each month's closing cash rolling into the next month's opening cash.

Required scope: purchase-orders:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Sales cash-in splits at the tenant's today (app timezone): days before today are ACTUAL booked line-financial revenue (an order-revenue proxy, not bank settlement); today onward is an ESTIMATED payout — the same estimate cash-constrained buying's headroom uses: average daily booked revenue over the trailing 90 days × payout_haircut_pct, landing from today + payout_lag_days. Each row carries sales_in = sales_in_actual + sales_in_estimated and sales_in_basis (actual for a past month, estimated for a future month, mixed for the current month). Before this split, future months showed $0. The calendar always shows the estimate; the include_sales_inflows setting governs only whether headroom spends against it.

Top-level sales_in_estimate describes the estimate's inputs (lookback_days, payout_lag_days, payout_haircut_pct, daily_payout, first_payout_date) so clients can label it.

opening_cash / closing_cash are omitted (not null) without cash_buying.view_balances.

Permission: cash_buying.index. Token scope: purchase-orders (read).

Request​

Responses​

OK

Response Headers
    Content-Type