---
title: "Get Bot Usage"
method: GET
path: "/bots/{bot_id}/usage"
tags: ["bots"]
---

# Get Bot Usage

`GET /bots/{bot_id}/usage`

## Request

- Base URL: `https://speaking.meetingbaas.com`
- URL: `https://speaking.meetingbaas.com/bots/{bot_id}/usage`
- Auth: API key in header `x-meeting-baas-api-key`
- TypeScript: <https://skmtc.dev/meeting-baas/apis/meeting-baas-api/docs/bots/:bot_id/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

What the bot has consumed so far on speech-to-text, text-to-speech and the LLM.

Live while the bot is in the call, final once it has left. key_sources says
per provider whether the bot ran on the server's key (billed by Meeting
BaaS) or on one the request brought. Only the API key that created the bot
may read it.

## Path parameters

- `bot_id` string, required

## Response `200`

Successful Response

- UsageReport: What one bot consumed on each provider, from Pipecat's usage metrics.
  - `bot_id` string, required
  - `meetingbaas_bot_id` string, nullable
  - `stt_provider` string, required
  - `tts_provider` string, required
  - `llm_provider` string, nullable
  - `llm_model` string, nullable
  - `key_sources` object: Per provider: 'platform' (ran on the server's key) or 'caller'
  - `started_at` number, required
  - `ended_at` number, nullable
  - `duration_seconds` number, required
  - `stt_audio_seconds` number, required
  - `tts_characters` integer, required
  - `tts_requests` integer, required
  - `llm_turns` integer, required
  - `llm_prompt_tokens` integer, required
  - `llm_cached_prompt_tokens` integer, required
  - `llm_completion_tokens` integer, required
  - `llm_total_tokens` integer, required

## Other responses

- `404`: No usage recorded for that bot yet
- `422`: Validation Error

## Changes

- **2026-10-30** `e496ccb3de9f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/changes/bots/:bot_id/usage/get.md)

---

[API](https://skmtc.dev/meeting-baas/apis/meeting-baas-api.md) - [All operations](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/revisions/1a4957849576?raw)