---
title: "Get Cost Summary"
method: GET
path: "/gtm-internal/costs/summary"
tags: ["gtm-internal"]
---

# Get Cost Summary

`GET /gtm-internal/costs/summary`

## Request

- Base URL: `https://api-v1.unusual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-v1.unusual.ai/gtm-internal/costs/summary`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Aggregated cost data with filters for the cost dashboard.

Query params:
    date_from: ISO date string (YYYY-MM-DD). Defaults to 30 days ago.
    date_to: ISO date string (YYYY-MM-DD). Defaults to today.
    domain_id: Filter by specific domain.
    task_type: Filter by task type (overview, monitor_probe, monitor_research, etc.)
    provider: Filter by provider (openai, gemini, perplexity)
    group_by: Time series granularity: day | week | month

## Query parameters

- `date_from` string, nullable
- `date_to` string, nullable
- `domain_id` string, nullable
- `task_type` string, nullable
- `provider` string, nullable
- `group_by` string

## Response `200`

Successful Response

- CostSummaryResponse
  - `total_cost` number, required
  - `total_calls` integer, required
  - `total_input_tokens` integer, required
  - `total_output_tokens` integer, required
  - `total_reasoning_tokens` integer, required
  - `by_provider` object[], required
  - `by_task_type` object[], required
  - `time_series` CostTimeSeriesEntry[], required
    - `date` string, required
    - `provider` string, required
    - `cost` number, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `reasoning_tokens` integer, required
    - `call_count` integer, required
  - `by_domain` object[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/unusual/apis/dashboard-server.md) - [All operations](https://skmtc.dev/unusual/apis/dashboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/unusual/apis/dashboard-server/revisions/89f716930ead?raw)