---
title: "Get Roi Dashboard"
method: GET
path: "/me/metrics/roi"
tags: ["User API", "Metrics"]
---

# Get Roi Dashboard

`GET /me/metrics/roi`

## Query parameters

- `days` integer
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `agent_id` string, uuid, nullable

## Response `200`

Successfully retrieved the ROI dashboard

- ROIDashboardResponse
  - `window` ROIWindow, required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `previous_start` string, date-time, required
    - `previous_end` string, date-time, required
  - `currency` 'USD'
  - `selected_kpis` string[], required
  - `totals` ROIKPITotal[], required
    - `kpi` 'tasks_completed' | 'time_saved' | 'cost_savings' | 'revenue_generated', required
    - `value` number, required
    - `previous_value` number, required
    - `change_percent` number, nullable, required
  - `series` ROISeriesPoint[], required
    - `date` string, date, required
    - `values` object, required
  - `agents` ROIAgentRow[], required
    - `agent_id` string, uuid, required
    - `title` string, required
    - `kpis` string[], required
    - `values` object, required
    - `previous_values` object, required
    - `tasks_completed_series` ROIAgentTasksCompletedPoint[], required
      - `date` string, date, required
      - `value` number, required
    - `total_runs` integer, required
    - `latest_run_at` string, date-time, nullable, required

## Other responses

- `403` — Only organisation admins can view ROI metrics
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2026-09-04** `fc441a13cd1f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/toolhouse/apis/toolhouse-api/changes/me/metrics/roi/get.md)

---

[API](https://skmtc.dev/toolhouse/apis/toolhouse-api.md) · [All operations](https://skmtc.dev/toolhouse/apis/toolhouse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/toolhouse/toolhouse-api/revisions/fc441a13cd1f/schema)