---
title: "Changes to Get a customer's credit balance"
method: GET
path: "/openmeter/customers/{customerId}/credits/balance"
---

# Changes to Get a customer's credit balance

`GET /openmeter/customers/{customerId}/credits/balance`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 63 revisions.

- **2026-08-25** (v3) `bd7fb1027684` — 1 breaking, 1 info
- **2026-07-30** (v3) `b4f5102c436d` — 1 breaking, 2 info
- **2026-07-03** (v3) `3be06f269447` — 3 info
- **2026-06-29** (v3) `cf64127756eb` — 1 breaking, 2 info
- **2026-05-20** (v3) `55836d0ad2f5` — 1 info
- **2026-05-11** (v3) `9d0042cb3815` — 2 breaking, 1 warning, 1 info

## Changes

- **2026-08-25** (v3) `bd7fb1027684` — 1 breaking, 1 info
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `balances/items/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `balances/items/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `200`
- **2026-07-30** (v3) `b4f5102c436d` — 1 breaking, 2 info
  - the `balances/items/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response's property type changed from `string` to no type for status `200`
  - removed `#/components/schemas/CurrencyCode` from the `balances/items/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `balances/items/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `200`
- **2026-07-03** (v3) `3be06f269447` — 3 info
  - for the `query` request parameter `filter`, the format of property `currency/allOf[subschema #1: String Field Filter Exact]/anyOf[subschema #2]/oeq` was generalized from `ArrayEncoding.commaDelimited` to no format
  - for the `query` request parameter `filter`, the format of property `feature_key/allOf[#/components/schemas/StringFieldFilter]/anyOf[subschema #2]/ocontains` was generalized from `ArrayEncoding.commaDelimited` to no format
  - for the `query` request parameter `filter`, the format of property `feature_key/allOf[#/components/schemas/StringFieldFilter]/anyOf[subschema #2]/oeq` was generalized from `ArrayEncoding.commaDelimited` to no format
- **2026-06-29** (v3) `cf64127756eb` — 1 breaking, 2 info
  - removed the required property `balances/items/available` from the response with the `200` status
  - added the required property `balances/items/live` to the response with the `200` status
  - added the required property `balances/items/settled` to the response with the `200` status
- **2026-05-20** (v3) `55836d0ad2f5` — 1 info
  - added the new optional `query` request parameter `timestamp`
- **2026-05-11** (v3) `9d0042cb3815` — 2 breaking, 1 warning, 1 info
  - removed the required property `balances/items/live` from the response with the `200` status
  - removed the required property `balances/items/settled` from the response with the `200` status
  - deleted the `query` request parameter `timestamp`
  - added the required property `balances/items/available` to the response with the `200` status

---

[Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/customers/:customerId/credits/balance/get.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/customers/:customerId/credits/balance/get)