---
title: "Changes to Get Characters Usage Metrics (Deprecated)"
method: GET
path: "/v1/usage/character-stats"
---

# Changes to Get Characters Usage Metrics (Deprecated)

`GET /v1/usage/character-stats`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 107 revisions.

- **2026-06-08** `37fac3c5a2d7`: 1 info
- **2026-04-03** `deb5e58ddddf`: 1 info
- **2026-02-08** `5b595807512c`: 10 info
- **2025-05-16** `503db4198a44`: 2 breaking, 16 info
- **2024-11-22** `dd10bbb98a6e`: 5 breaking, 1 info
- **2024-08-28** `0f0a2b37eafb`: 1 info

## Changes

- **2026-06-08** `37fac3c5a2d7`: 1 info
  - endpoint deprecated
- **2026-04-03** `deb5e58ddddf`: 1 info
  - api tag `usage` removed
- **2026-02-08** `5b595807512c`: 10 info
  - api operation id `Get_characters_usage_metrics_v1_usage_character_stats_get` removed and replaced with `usage_characters`
  - added the new optional `query` request parameter `aggregation_bucket_size`
  - added the new enum value `concurrency` to the `query` request parameter `metric`
  - added the new enum value `concurrency_average` to the `query` request parameter `metric`
  - added the new enum value `has_api_key` to the `query` request parameter `breakdown_type`
  - added the new enum value `region` to the `query` request parameter `breakdown_type`
  - added the new enum value `reporting_workspace_id` to the `query` request parameter `breakdown_type`
  - added the new enum value `request_source` to the `query` request parameter `breakdown_type`
  - added the new enum value `subresource_id` to the `query` request parameter `breakdown_type`
  - added the new enum value `tts_characters` to the `query` request parameter `metric`
- **2025-05-16** `503db4198a44`: 2 breaking, 16 info
  - the `query` request parameter `breakdown_type` was restricted to a list of enum values
  - the `usage/additionalProperties/items/` response's property type changed from `integer` to `number` for status `200`
  - added the new optional `query` request parameter `aggregation_interval`
  - added the new optional `query` request parameter `metric`
  - added the new enum value `all_api_keys` to the `query` request parameter `breakdown_type`
  - added the new enum value `api_keys` to the `query` request parameter `breakdown_type`
  - added the new enum value `groups` to the `query` request parameter `breakdown_type`
  - added the new enum value `model` to the `query` request parameter `breakdown_type`
  - added the new enum value `none` to the `query` request parameter `breakdown_type`
  - added the new enum value `product_type` to the `query` request parameter `breakdown_type`
  - added the new enum value `request_queue` to the `query` request parameter `breakdown_type`
  - added the new enum value `resource` to the `query` request parameter `breakdown_type`
  - added the new enum value `user` to the `query` request parameter `breakdown_type`
  - added the new enum value `voice` to the `query` request parameter `breakdown_type`
  - added the new enum value `voice_multiplier` to the `query` request parameter `breakdown_type`
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - for the `query` request parameter `breakdown_type`, the type was generalized from no type to `string`
- **2024-11-22** `dd10bbb98a6e`: 5 breaking, 1 info
  - removed the enum value `api_keys` from the `query` request parameter `breakdown_type`
  - removed the enum value `none` from the `query` request parameter `breakdown_type`
  - removed the enum value `product_type` from the `query` request parameter `breakdown_type`
  - removed the enum value `user` from the `query` request parameter `breakdown_type`
  - removed the enum value `voice` from the `query` request parameter `breakdown_type`
  - for the `query` request parameter `breakdown_type`, the type was generalized from `string` to no type
- **2024-08-28** `0f0a2b37eafb`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/usage/character-stats/get.md) - [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/usage/character-stats/get)