---
title: "List Conversation Costs Endpoint"
method: GET
path: "/api/admin/conversations/costs"
tags: ["admin_conversations"]
---

# List Conversation Costs Endpoint

`GET /api/admin/conversations/costs`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/admin/conversations/costs`
- Auth: HTTP bearer

## Query parameters

- `company_uuid` string, uuid, nullable: Filter by conversations.company_uuid
- `agent_type` string, nullable: Filter by agent_type (e.g. agent/regdoor)
- `created_from` string, date-time, nullable: Filter by created_at from (inclusive)
- `created_to` string, date-time, nullable: Filter by created_at to (inclusive)
- `include_deleted` boolean: Include soft-deleted conversations (default true for cost reporting)
- `limit` integer

## Response `200`

Successful Response

- ConversationCostsResponse
  - `totals` ConversationCostTotals
    - `conversations` integer
    - `estimated_cost_usd` number
    - `input_tokens` integer
    - `output_tokens` integer
    - `cache_creation_input_tokens` integer
    - `cache_read_input_tokens` integer
  - `companies` ConversationCostByCompany[]
    - `company_uuid` string, uuid, required
    - `company_name` string, required
    - `conversations` integer
    - `estimated_cost_usd` number
  - `items` ConversationCostItem[]
    - `uuid` string, uuid, required
    - `title` string, required
    - `session_id` string, required
    - `company_uuid` string, uuid, required
    - `company_name` string, required
    - `user_uuid` string, uuid, required
    - `estimated_cost_usd` number
    - `input_tokens` integer
    - `output_tokens` integer
    - `cache_creation_input_tokens` integer
    - `cache_read_input_tokens` integer
    - `model_used` string, nullable
    - `agent_type` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `langsmith_url` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)