Reference
Our 8 core endpoints — one envelope
Cashytics exposes our 8 core endpoints as POST routes under /api/v1/<slug> only.
Each successful response returns the same top-level JSON shape: endpoint, account_id, processing, structured, and narrative. Retired slugs respond with 410 Gone and a structured migration payload — see API Simplification – April 2026.
cashflow-health-score forecast-30d-cash-position liquidity-runout-forecast simulated-scenario-runner ar-aging-accelerator burn-rate-optimizer distress-early-warning early-payment-discount-leak
POST /api/v1/cashflow-health-score
Turn messy bank feeds into one 0–100 cash health score in a single POST.
Composite 0–100 score summarizing real-time cash health — your primary conversion endpoint.
POST /api/v1/forecast-30d-cash-position
Project where cash lands thirty days out with a defensible confidence band from recent net flow.
Linear projection of net cash thirty days forward with a confidence band.
Extras: payables optional for payable-aware drift
POST /api/v1/liquidity-runout-forecast
Answer when cash hits zero and what funding you need in the next thirty days if trends hold.
Calendar-time path to zero cash and the 30-day funding gap if recent daily net continues — treasury-grade triage in one response.
POST /api/v1/simulated-scenario-runner
Stress revenue, opex, and payable timing on the same envelope to compare base, stressed, and upside balances.
Deterministic stress / upside scenarios against the supplied envelope.
Extras: scenario
POST /api/v1/ar-aging-accelerator
Rank AR buckets so collections starts with the dollars that move the needle.
Prioritized collection list across AR buckets.
Extras: ar_aging
POST /api/v1/burn-rate-optimizer
Surface the top spend categories driving burn so cuts and negotiations line up on one list.
Observed monthly burn with ranked reduction opportunities by category.
Extras: categorized outflows improve ranking
POST /api/v1/distress-early-warning
Collapse volatility, runway, and drain signals into one composite risk you can alert on.
Composite early warning rail with tripped structural signals.
POST /api/v1/early-payment-discount-leak
Quantify supplier early-pay discounts you can still capture—and the AP effort to go get them.
Discounts suppliers already offered that finance rarely captures — dollars and AP clerk hours to reclaim them.
Extras: payables.items[].discount_minor recommended
Compact matrix
| Slug | Value prop | Structured highlights |
|---|---|---|
| cashflow-health-score | Turn messy bank feeds into one 0–100 cash health score in a single POST. | score, drivers.net_position_minor, drivers.monthly_outflow_minor, drivers.volatility_index |
| forecast-30d-cash-position | Project where cash lands thirty days out with a defensible confidence band from recent net flow. | forecast_30d_minor, confidence_band_minor, assumptions[] |
| liquidity-runout-forecast | Answer when cash hits zero and what funding you need in the next thirty days if trends hold. | runway_stable, estimated_days_to_zero_balance, projected_balance_30d_minor, funding_gap_30d_minor, treasury_war_room_hours_recommended_next_30d, methodology_note |
| simulated-scenario-runner | Stress revenue, opex, and payable timing on the same envelope to compare base, stressed, and upside balances. | scenarios[] |
| ar-aging-accelerator | Rank AR buckets so collections starts with the dollars that move the needle. | prioritized[] |
| burn-rate-optimizer | Surface the top spend categories driving burn so cuts and negotiations line up on one list. | monthly_burn_minor, reduction_opportunities[] |
| distress-early-warning | Collapse volatility, runway, and drain signals into one composite risk you can alert on. | composite_risk, signals[] |
| early-payment-discount-leak | Quantify supplier early-pay discounts you can still capture—and the AP effort to go get them. | invoices_with_discount_terms, discounts_on_table_minor, estimated_recoverable_minor, assumed_capture_rate_pct, ap_clerk_hours_to_capture_estimate, methodology_note |