---
title: "Fetch conversation usage statistics"
method: GET
path: "/conversation/{conversationId}/usage/fetch"
tags: ["Conversation"]
---

# Fetch conversation usage statistics

`GET /conversation/{conversationId}/usage/fetch`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/conversation/{conversationId}/usage/fetch`
- Auth: HTTP bearer

Retrieve usage statistics for a specific conversation, including total tokens
(BASE type only) and total messages. Optionally filter by date range.

## Path parameters

- `conversationId` string, required: The ID of the conversation

## Query parameters

- `from` string, date-time: Start date for the period (ISO 8601 format)
- `to` string, date-time: End date for the period (ISO 8601 format)

## Response `200`

Conversation usage statistics retrieved successfully

- object
  - `tokens` integer: Total number of BASE tokens used
  - `messages` integer: Total number of messages

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)