Cash Flow Insights is in Beta. It follows the v1 compatibility rules - additive-only, with breaking changes reserved for a new API version - but the shape may still widen as the resource settles. See Versioning and compatibility.
These endpoints show money moving in and out of the business linked to your API Access Token. Both require the transactions:read scope.
GET /api/v1/insights/cashflow shows how much money came in and went out over time. You can view it by day, week, or month to spot busy periods and see whether more money came in than went out.
curl "https://rhoapi.rho.co/api/v1/insights/cashflow?from=2026-05-01T00:00:00Z&to=2026-05-31T23:59:59Z&group=week" \
-H "Authorization: Bearer $RHO_API_TOKEN"group can be day, week, or month. It defaults to day. If you omit from and to, the response covers the last 90 days.
{
"buckets": [
{
"bucket_start": "2026-05-04T00:00:00Z",
"inflow_amount": {"amount": 250000, "currency": "USD"},
"outflow_amount": {"amount": 175000, "currency": "USD"},
"net_amount": {"amount": 75000, "currency": "USD"}
}
]
}GET /api/v1/insights/money-movement shows who sent you the most money and who you paid the most. Use it to quickly find your biggest sources of income and largest payments without looking through every transaction.
curl "https://rhoapi.rho.co/api/v1/insights/money-movement?from=2026-05-01T00:00:00Z&to=2026-07-10T00:00:00Z&limit=10" \
-H "Authorization: Bearer $RHO_API_TOKEN"limit can be from 1 to 100 and defaults to 10. It limits each list, not total_in or total_out.
{
"top_inflows": [
{
"counterparty_name": "Customer A",
"total_amount": {"amount": 1000000, "currency": "USD"}
}
],
"top_outflows": [
{
"counterparty_name": "Example Vendor",
"total_amount": {"amount": 10306, "currency": "USD"}
}
],
"total_in": {"amount": 1010000, "currency": "USD"},
"total_out": {"amount": 23806, "currency": "USD"}
}Full endpoint catalogue - paths, parameters, response shapes, and required scopes - lives in the API Reference.