---
title: "Changes to Get Usage"
method: GET
path: "/v1/usage/"
---

# Changes to Get Usage

`GET /v1/usage/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 25 revisions.

- **2025-10-29** `9b529d67a7d0` — 1 breaking, 10 warning, 15 info
- **2025-05-06** `39873621da54` — 4 info
- **2025-05-06** `b9afd900cfb1` — 1 info

## Changes

- **2025-10-29** `9b529d67a7d0` — 1 breaking, 10 warning, 15 info
  - removed the required property `billing_cycles/anyOf[subschema #1]/items/score_runs` from the response with the `200` status
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `400`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `401`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `403`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `404`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `409`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `422`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `429`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `500`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `503`
  - added the new `video` enum value to the `free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - added the new optional `query` request parameter `billing_cycle_uuid`
  - added the new optional `query` request parameter `date_from`
  - added the new optional `query` request parameter `date_to`
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/balance_remaining` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/credits_available` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/credits_used` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/pricing_rules_count` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/total_usage` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/usage_breakdown` to the response with the `200` status
  - added the optional property `billing_cycles/anyOf[subschema #1]/items/workspace_groups` to the response with the `200` status
  - added the optional property `free_score_runs/anyOf[subschema #1]/items/created_by/anyOf[subschema #1: UserOutSchema]/org_admin_emails` to the response with the `200` status
  - added the optional property `free_score_runs/anyOf[subschema #1]/items/created_by/anyOf[subschema #1: UserOutSchema]/workspace` to the response with the `200` status
  - added the optional property `free_score_runs/anyOf[subschema #1]/items/workspace_name` to the response with the `200` status
  - added the optional property `free_score_runs/anyOf[subschema #1]/items/workspace_uuid` to the response with the `200` status
  - added the required property `billing_cycles/anyOf[subschema #1]/items/pricing_model` to the response with the `200` status
- **2025-05-06** `39873621da54` — 4 info
  - removed the `audio` enum value from the `billing_cycles/anyOf[subschema #1]/items/score_runs/items/test/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `audio` enum value from the `free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `video` enum value from the `billing_cycles/anyOf[subschema #1]/items/score_runs/items/test/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `video` enum value from the `free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
- **2025-05-06** `b9afd900cfb1` — 1 info
  - removed the `multiturn_safety` enum value from the `test_type_displays/propertyNames/` response property for the response status `200`

---

[Operation](https://skmtc.dev/aymara-ai/apis/aymara-api/docs/v1/usage/get.md) · [API](https://skmtc.dev/aymara-ai/apis/aymara-api.md) · [Page](https://skmtc.dev/aymara-ai/apis/aymara-api/changes/v1/usage/get)