---
title: "Get Dashboard"
method: GET
path: "/internal/cost-analytics/dashboard"
tags: ["cost-analytics"]
---

# Get Dashboard

`GET /internal/cost-analytics/dashboard`

## Query parameters

- `start_time` string, nullable — Inclusive ISO 8601 start time. Defaults to 30 days ago.
- `end_time` string, nullable — Exclusive ISO 8601 end time. Defaults to now.
- `session_limit` integer — Max sessions to return.
- `session_offset` integer — Sessions to skip for pagination.
- `mode` string, nullable — Filter to sessions with this mode (e.g. 'ALERT_STORY').

## Response `200`

Successful Response

- CostDashboardResponse
  - `total_cost_usd` number, required
  - `total_sessions` integer, required
  - `total_llm_calls` integer, required
  - `avg_cost_per_session` number, required
  - `cache_hit_rate` number, required — Cache hit rate as a 0-1 ratio.
  - `overhead_pct` number, required — Non-agent overhead cost share as a 0-1 ratio.
  - `period_comparison` PeriodComparison — Comparison against the previous equal-length period.
    - `previous_total_cost_usd` number, required — Total cost in the previous period.
    - `cost_change_pct` number, nullable — Relative change vs the previous period; unbounded and None when the prior value is 0.
    - `previous_session_count` integer, required — Session count in the previous period.
    - `session_count_change_pct` number, nullable — Relative change vs the previous period; unbounded and None when the prior value is 0.
    - `previous_avg_cost_per_session` number, required — Average session cost in the previous period.
    - `avg_cost_change_pct` number, nullable — Relative change vs the previous period; unbounded and None when the prior value is 0.
  - `cost_by_org` OrgCostRow[], required
    - `org_id` string, required
    - `org_name` string, required
    - `org_display_name` string, nullable
    - `total_cost_usd` number, required
    - `session_count` integer, required
    - `call_count` integer, required
    - `avg_cost_per_session` number, required
    - `cache_hit_rate` number, required
  - `cost_by_day` DailyCostRow[], required
    - `date` string, required
    - `total_cost_usd` number, required
    - `session_count` integer, required
  - `cost_by_model` ModelCostRow[], required
    - `model` string, required
    - `total_cost_usd` number, required
    - `call_count` integer, required
    - `total_prompt_tokens` integer, required
    - `total_completion_tokens` integer, required
    - `total_cached_tokens` integer, required
    - `cache_hit_rate` number, required
    - `avg_cost_per_call` number, required
  - `cost_by_mode` ModeCostRow[], required
    - `mode` string, required
    - `total_cost_usd` number, required
    - `session_count` integer, required
    - `avg_cost_per_session` number, required
  - `cost_by_trigger` TriggerCostRow[], required
    - `trigger_type` string, required
    - `total_cost_usd` number, required
    - `session_count` integer, required
    - `avg_cost_per_session` number, required
  - `cost_by_task_type` TaskTypeCostRow[], required
    - `task_type` string, nullable, required
    - `total_cost_usd` number, required
    - `call_count` integer, required
  - `sessions` SessionCostRow[], required
    - `session_id` string, required
    - `org_name` string, nullable, required
    - `session_title` string, nullable, required
    - `mode` string, nullable, required
    - `trigger_type` string, nullable, required
    - `created_at` string, date-time, required
    - `estimated_cost_usd` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)