Skip to main content

Get Dashboard Summary

GET 
/api/ledger/dashboard

The Accounting v2 section landing summary — the whole dashboard in one call. Composed from the existing managers/repositories so it never diverges from the tab it summarizes.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Authentication: Requires Bearer token.

Sections:

  • generation_health — the derived backlog signal (state: healthy | behind | failing | paused) with its label + Vuetify color, plus the raw inputs: kill-switch enabled, environment_override, outbox pending/failed, the drain last_processed_at heartbeat, stale_after_minutes (5), and the next scheduled runs. behind requires BOTH queued work AND a stale heartbeat — a large-but-draining queue stays healthy.
  • kpis — four headline counts: pending_sync (pending_sync + update_pending + syncing + retrying), needs_attention (needs_attention + failed + conflict + removed_in_provider), synced, and outbox_backlog (outbox pending + failed source documents not yet turned into entries).
  • status_breakdown — per-display-status counts in enum order, each with label + color (click a segment to open the All tab filtered on that display_status). Statuses with no entries are included with count 0.
  • needs_attention — the parked total, the group_count, and the top 5 error-cause groups.
  • connections — the accounting connections view-model (provider, health, lock date, rate budget, last inbound, open ops).
  • reconciliation — balance_mismatches: current entries whose line sums disagree with their header totals.
  • recent_entries — the 5 most recent entries (same shape as the entries table).

Request​

Responses​

OK

Response Headers
    Content-Type