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

# Changes to Get usage

`GET /v1/usage`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 68 revisions.

- **2026-07-02** `c7b37eaf7c38`: 5 breaking, 33 info
- **2026-06-05** `3985c6090c91`: 37 breaking, 4 warning, 80 info
- **2026-06-01** `80ee119de8db`: 5 info
- **2026-06-01** `3597d11cb5fa`: 1 info
- **2026-06-01** `d4160125c4ac`: 1 info
- **2026-06-01** `d4b6eca958de`: 1 breaking, 1 info
- **2026-06-01** `c6d1a6ebbf7a`: 2 info
- **2026-06-01** `f0d6edef52ef`: 7 breaking
- **2026-06-01** `d02c79f624e6`: 7 info
- **2026-06-01** `bade91c8f931`: 1 info
- **2026-06-01** `8e4c8b36cbd5`: 3 info
- **2026-05-31** `5db274a3cd1d`: 1 breaking, 1 info
- **2026-05-31** `5cb2373aa7b7`: 2 info

## Changes

- **2026-07-02** `c7b37eaf7c38`: 5 breaking, 33 info
  - removed the required property `balanceUsdMicros` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/label` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/quantity` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/unitUsdMicros` from the response with the `200` status
  - removed the required property `ok` from the response with the `200` status
  - added the required property `billingEstimate/autoTopUpAmountUsdCents` to the response with the `200` status
  - added the required property `billingEstimate/autoTopUpEnabled` to the response with the `200` status
  - added the required property `billingEstimate/autoTopUpMonthlyLimitUsdCents` to the response with the `200` status
  - added the required property `billingEstimate/autoTopUpThresholdUsdCents` to the response with the `200` status
  - added the required property `billingEstimate/bonusBalanceUsdCentsPerMonth` to the response with the `200` status
  - added the required property `billingEstimate/currentMonthBonusBalanceUsedUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/currentMonthOverageUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/currentMonthPlanBalanceUsedUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/currentMonthTopUpBalanceUsedUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/estimatedMonthlyTotalUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/includedBalanceUsdCentsPerMonth` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/billableAmount` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/billingUnit` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/billingUnitSize` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/currentMonthUsed` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/estimateBasis` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/includedPerMonth` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/priceUsdMicrosPerBillingUnit` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/product` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/rounding` to the response with the `200` status
  - added the required property `billingEstimate/lineItems/items/usageUnit` to the response with the `200` status
  - added the required property `billingEstimate/nextActions` to the response with the `200` status
  - added the required property `billingEstimate/paidOveragesEnabled` to the response with the `200` status
  - added the required property `billingEstimate/plan` to the response with the `200` status
  - added the required property `billingEstimate/planBalanceUsdCentsPerMonth` to the response with the `200` status
  - added the required property `billingEstimate/subscriptionUsdMicrosPerMonth` to the response with the `200` status
  - added the required property `billingEstimate/topUpBalanceUsdMicros` to the response with the `200` status
  - added the required property `billingEstimate/topUpExpiresAfterInactiveDays` to the response with the `200` status
  - added the required property `billingEstimate/topUpMaximumUsdCents` to the response with the `200` status
  - added the required property `billingEstimate/topUpMinimumUsdCents` to the response with the `200` status
  - added the required property `pricing` to the response with the `200` status
  - added the required property `profile` to the response with the `200` status
  - added the required property `usage` to the response with the `200` status
- **2026-06-05** `3985c6090c91`: 37 breaking, 4 warning, 80 info
  - the response property `checkout_url` became nullable for the status `400`
  - the response property `checkout_url` became nullable for the status `401`
  - the response property `checkout_url` became nullable for the status `429`
  - the response property `checkout_url` became nullable for the status `500`
  - the response property `checkout_url` became optional for the status `400`
  - the response property `checkout_url` became optional for the status `401`
  - the response property `checkout_url` became optional for the status `429`
  - the response property `checkout_url` became optional for the status `500`
  - the `agent_instruction` response property's maxLength was unset from `1000` for the response status `400`
  - the `agent_instruction` response property's maxLength was unset from `1000` for the response status `401`
  - the `agent_instruction` response property's maxLength was unset from `1000` for the response status `429`
  - the `agent_instruction` response property's maxLength was unset from `1000` for the response status `500`
  - the `billingEstimate/lineItems/items/meter` response property's maxLength was unset from `128` for the response status `200`
  - the `message` response property's maxLength was unset from `240` for the response status `400`
  - the `message` response property's maxLength was unset from `240` for the response status `401`
  - the `message` response property's maxLength was unset from `240` for the response status `429`
  - the `message` response property's maxLength was unset from `240` for the response status `500`
  - removed the required property `billingEstimate/currentMonthOverageUsdMicros` from the response with the `200` status
  - removed the required property `billingEstimate/estimatedMonthlyTotalUsdMicros` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/billableAmount` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/billingUnit` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/billingUnitSize` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/currentMonthUsed` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/estimateBasis` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/includedPerMonth` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/priceUsdMicrosPerBillingUnit` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/product` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/rounding` from the response with the `200` status
  - removed the required property `billingEstimate/lineItems/items/usageUnit` from the response with the `200` status
  - removed the required property `billingEstimate/nextActions` from the response with the `200` status
  - removed the required property `billingEstimate/paidOveragesEnabled` from the response with the `200` status
  - removed the required property `billingEstimate/plan` from the response with the `200` status
  - removed the required property `billingEstimate/subscriptionUsdMicrosPerMonth` from the response with the `200` status
  - removed the required property `limits` from the response with the `200` status
  - removed the required property `pricing` from the response with the `200` status
  - removed the required property `profile` from the response with the `200` status
  - removed the required property `usage` from the response with the `200` status
  - the optional response header `Retry-After` removed for the status `200`
  - the optional response header `Retry-After` removed for the status `400`
  - the optional response header `Retry-After` removed for the status `401`
  - …81 more
- **2026-06-01** `80ee119de8db`: 5 info
  - added the optional property `usage/meters/day/object_storage_egress_bytes` to the response with the `200` status
  - added the optional property `usage/meters/month/object_storage_egress_bytes` to the response with the `200` status
  - added the required property `limits/objectStorageEgressBytesPerMonth` to the response with the `200` status
  - added the required property `pricing/objectStorage/egressOverageUsdMicrosPerTb` to the response with the `200` status
  - added the required property `pricing/objectStorage/includedEgressBytesPerMonth` to the response with the `200` status
- **2026-06-01** `3597d11cb5fa`: 1 info
  - added the required property `limits/serviceBindingInvocationsPerRequest` to the response with the `200` status
- **2026-06-01** `d4160125c4ac`: 1 info
  - added the required property `limits/stateAlarmDurationSeconds` to the response with the `200` status
- **2026-06-01** `d4b6eca958de`: 1 breaking, 1 info
  - removed the required property `limits/buildCpuMillis` from the response with the `200` status
  - added the required property `limits/buildCpuMillicores` to the response with the `200` status
- **2026-06-01** `c6d1a6ebbf7a`: 2 info
  - added the required property `limits/buildDeployHooksPerAccountPerMinute` to the response with the `200` status
  - added the required property `limits/buildDeployHooksPerServicePerMinute` to the response with the `200` status
- **2026-06-01** `f0d6edef52ef`: 7 breaking
  - removed the required property `limits/storageBucketBandwidthGbitPerSecond` from the response with the `200` status
  - removed the required property `limits/storageBucketMaxTb` from the response with the `200` status
  - removed the required property `limits/storageMinimumBillableObjectBytes` from the response with the `200` status
  - removed the required property `limits/storageObjectsPerBucket` from the response with the `200` status
  - removed the required property `limits/storageParallelSessionsPerSourceIp` from the response with the `200` status
  - removed the required property `limits/storageRequestsPerSecondPerBucket` from the response with the `200` status
  - removed the required property `limits/storageRequestsPerSecondPerSourceIp` from the response with the `200` status
- **2026-06-01** `d02c79f624e6`: 7 info
  - added the required property `limits/storageBucketBandwidthGbitPerSecond` to the response with the `200` status
  - added the required property `limits/storageBucketMaxTb` to the response with the `200` status
  - added the required property `limits/storageMinimumBillableObjectBytes` to the response with the `200` status
  - added the required property `limits/storageObjectsPerBucket` to the response with the `200` status
  - added the required property `limits/storageParallelSessionsPerSourceIp` to the response with the `200` status
  - added the required property `limits/storageRequestsPerSecondPerBucket` to the response with the `200` status
  - added the required property `limits/storageRequestsPerSecondPerSourceIp` to the response with the `200` status
- **2026-06-01** `bade91c8f931`: 1 info
  - added the required property `billingEstimate` to the response with the `200` status
- **2026-06-01** `8e4c8b36cbd5`: 3 info
  - added the required property `limits/buildEnvVarSizeKib` to the response with the `200` status
  - added the required property `limits/buildEnvVars` to the response with the `200` status
  - added the required property `limits/logEventSizeBytes` to the response with the `200` status
- **2026-05-31** `5db274a3cd1d`: 1 breaking, 1 info
  - removed the required property `limits/stateSqliteStorageMib` from the response with the `200` status
  - added the required property `limits/stateSqliteStorageMibPerObject` to the response with the `200` status
- **2026-05-31** `5cb2373aa7b7`: 2 info
  - added the optional property `usage/meters/day/build_minutes` to the response with the `200` status
  - added the optional property `usage/meters/month/build_minutes` to the response with the `200` status

---

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