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

# Get Dashboard

`GET /internal/cost-analytics/dashboard`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/internal/cost-analytics/dashboard`
- Auth: none declared

## 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.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)