Bot

Fetch bot usage statistics

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

get/bot/{botId}/usage/fetch

Request

  • Base URL: https://api.chatbotkit.com/api/v1
  • URL: https://api.chatbotkit.com/api/v1/bot/{botId}/usage/fetch
  • Auth: HTTP bearer

Path parameters

botIdstring required

The ID of the bot

Query parameters

fromstring date-time

Start date for the period (ISO 8601 format)

tostring date-time

End date for the period (ISO 8601 format)

Response

Bot usage statistics retrieved successfully

tokensinteger

Total number of BASE tokens used

conversationsinteger

Total number of conversations

messagesinteger

Total number of messages

Changes