---
title: "Changes to Get Comprehensive Pricing Details"
method: GET
path: "/v1/usage/costs"
---

# Changes to Get Comprehensive Pricing Details

`GET /v1/usage/costs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 101 revisions.

- **2026-11-01** `5753fcf83d0f`: 1 breaking, 1 info
- **2026-10-31** `e330460a5543`: 2 info
- **2026-10-31** `3e13975ede3d`: 2 info
- **2026-10-12** `8c7e22521b26`: 6 warning, 2 info
- **2026-06-06** `7af7a7eefddf`: 2 info

## Changes

- **2026-11-01** `5753fcf83d0f`: 1 breaking, 1 info
  - the response property `usage_pricing/flash_sale_active` became optional for the status `200`
  - the `flash_sale_active` response's property default value `true` was added for the status `200`
- **2026-10-31** `e330460a5543`: 2 info
  - the response property `usage_pricing/flash_sale_active` became required for the status `200`
  - the `flash_sale_active` response's property default value `true` was removed for the status `200`
- **2026-10-31** `3e13975ede3d`: 2 info
  - added the optional property `usage_pricing/flash_sale_active` to the response with the `200` status
  - added the optional property `usage_pricing/flash_sale_discount` to the response with the `200` status
- **2026-10-12** `8c7e22521b26`: 6 warning, 2 info
  - removed the optional property `usage_pricing/agent_completions_input_cost_per_1m` from the response with the `200` status
  - removed the optional property `usage_pricing/agent_completions_mcp_cost` from the response with the `200` status
  - removed the optional property `usage_pricing/agent_completions_output_cost_per_1m` from the response with the `200` status
  - removed the optional property `usage_pricing/scrape_cost` from the response with the `200` status
  - removed the optional property `usage_pricing/swarm_completions_input_cost_per_1m` from the response with the `200` status
  - removed the optional property `usage_pricing/swarm_completions_output_cost_per_1m` from the response with the `200` status
  - added the optional property `usage_pricing/fallback_input_cost_per_1m` to the response with the `200` status
  - added the optional property `usage_pricing/fallback_output_cost_per_1m` to the response with the `200` status
- **2026-06-06** `7af7a7eefddf`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

---

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