What's New in v1.0.64: Reserve Status & Holding Account Dashboard Widget

Release date: 2025-07-14

One of the quieter complexities of running a Direct Debit collection service is knowing, at any given moment, whether the holding account has enough in reserve to safely forward funds — and how much is actually ready to move. Version 1.0.64 brings that information to the surface.

The Problem

Funds collected from tenants don't move straight to an agent's client account. They sit in a Griffin DD holding account for a configurable hold period, and a portion of that balance must be kept back as a clawback reserve — a buffer against reversed payments. Until now, understanding the state of that holding account meant querying the Griffin account directly or reading raw transaction logs. Neither is practical for day-to-day operations.

What We Shipped

A dedicated reserve status widget on the main dashboard

The overview page now includes a widget that shows, in one glance:

How much is in the holding account
How much needs to stay there (the required clawback reserve)
How much can move (available-to-forward balance)
Whether the reserve is healthy — via a green / amber / red indicator
What's in flight — pending sweeps from Modulr and forwards scheduled to go out

The traffic-light health indicator is particularly useful: a red signal means the reserve has dropped below its minimum threshold and forwarding is restricted. Amber is an early warning. Green means everything is operating normally.

A tRPC endpoint for agentOS and other consumers

The same data is exposed via a tRPC endpoint (reserveStatus.get), so agentOS can embed reserve status directly in its own interface without building a separate integration. The response includes the full breakdown — balances, health status, pending sweeps, and scheduled forwards — all scoped to the authenticated letting agent.

Why It Matters

Reserve health has a direct operational impact. If the reserve drops into the red, funds that agents are expecting to receive may be delayed. Surfacing this proactively — both on the dashboard and via API — means issues can be spotted and acted on before they become agent-facing problems.

The pending sweeps and scheduled forwards panels also help with reconciliation: agents can see money that is confirmed but not yet settled, and money that is queued to leave, rather than just a static balance figure.

Configuration

The clawback reserve amount and health thresholds are configurable per letting agent. If you need to adjust the minimum reserve level or the amber/red boundaries for a customer, refer to the alerting and thresholds configuration in the admin API.

Full Details

See the Reserve Status & Holding Account Widget feature page for the complete field reference and API response schema.