Skip to main content

Get Dashboard Metrics

GET 

/api/v1/account/dashboard/metrics

Get dashboard KPI metrics for the authenticated user.

Returns key performance indicators for the dashboard:

  • Active Workflows: Workflows that are active and were created or executed in the period
  • Events Total: Total geofence entry/exit events triggered in the period
  • Action Delivery Success: Success rate for webhook deliveries and workflow step executions (north-star metric)

Time Ranges:

  • today: From midnight to now, in the workspace timezone (UTC when unset)
  • 7d: Last 7 days
  • 30d: Last 30 days
  • custom: Whole workspace-local days from start_date through end_date, inclusive (requires start_date and end_date; one day is start_date equal to end_date)

Formulas:

  • Action Delivery Success Rate = (successful_deliveries / total_attempts) * 100
  • Returns null when total_attempts = 0 (UI should show "—")

Authentication: JWT token required

Example:

GET /api/v1/accounts/dashboard/metrics?time_range=7d
GET /api/v1/accounts/dashboard/metrics?time_range=custom&start_date=2025-01-01&end_date=2025-01-31

Request​

Responses​

OK