---
title: "Changes to List credit event ledger"
method: GET
path: "/v2/billing/credits/ledger"
---

# Changes to List credit event ledger

`GET /v2/billing/credits/ledger`

> Every recorded change to this operation, newest first.
> 230 revisions in range; 1 not diffed.

## Timeline

Changed in 18 of 230 revisions.

- **2026-10-27** `a015c997fce5`: 3 info
- **2026-10-20** `0368e79bc7a9`: 2 info
- **2026-10-07** `bb4fc11f0a8b`: 1 info
- **2026-10-06** `8eb4adb2bade`: 1 warning, 1 info
- **2026-10-02** `8afd79a78bf2`: 2 breaking, 6 warning, 5 info
- **2026-09-25** `a56c23fa7dbe`: 1 info
- **2026-09-17** `d2fb8bb90eaf`: 1 info
- **2026-09-17** `b5afdab895bd`: 2 warning
- **2026-09-16** `afe97b9908ca`: 1 warning
- **2026-09-14** `1ce13450aec3`: 2 warning
- **2026-07-27** `e83d3358bab3`: 1 warning
- **2026-07-15** `3baa54bf8b3f`: 2 warning
- **2026-07-06** `e6b85f57df53`: 1 warning
- **2026-07-06** `e836d3bfd007`: 1 warning
- **2026-06-26** `b9c1b16b6a1b`: 1 breaking
- **2026-06-10** `4c1ac12569e2`: 1 warning
- **2026-06-05** `c0d7b479cd11`: 1 info
- **2026-06-04** `df525a3b6157`: 1 warning

## Changes

- **2026-10-27** `a015c997fce5`: 3 info
  - added the optional property `data/items/source_id_string` to the response with the `200` status
  - added the optional property `data/items/source_type` to the response with the `200` status
  - response property `data/items/source_id` deprecated
- **2026-10-20** `0368e79bc7a9`: 2 info
  - added the new optional `query` request parameter `source_event_id`
  - added the optional property `params/source_event_id` to the response with the `200` status
- **2026-10-07** `bb4fc11f0a8b`: 1 info
  - added the required property `data/items/event_ids` to the response with the `200` status
- **2026-10-06** `8eb4adb2bade`: 1 warning, 1 info
  - added the new `inference` enum value to the `data/items/usage_reason/allOf[#/components/schemas/CreditUsageReason]/` response property for the response status `200`
  - added the optional property `data/items/burn_breakdown` to the response with the `200` status
- **2026-10-02** `8afd79a78bf2`: 2 breaking, 6 warning, 5 info
  - the response property `data/items/billing_credit_id` became nullable for the status `200`
  - the response property `data/items/billing_credit_id` became optional for the status `200`
  - added the new `adjustment` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `adjustment` enum value to the `params/event_type` response property for the response status `200`
  - added the new `charge` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `charge` enum value to the `params/event_type` response property for the response status `200`
  - added the new `settlement` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `settlement` enum value to the `params/event_type` response property for the response status `200`
  - added the new enum value `adjustment` to the `query` request parameter `event_type`
  - added the new enum value `charge` to the `query` request parameter `event_type`
  - added the new enum value `settlement` to the `query` request parameter `event_type`
  - added the optional property `data/items/currency` to the response with the `200` status
  - added the required property `data/items/kind` to the response with the `200` status
- **2026-09-25** `a56c23fa7dbe`: 1 info
  - added the optional property `data/items/user_id` to the response with the `200` status
- **2026-09-17** `d2fb8bb90eaf`: 1 info
  - added the optional property `data/items/transfer_reason` to the response with the `200` status
- **2026-09-17** `b5afdab895bd`: 2 warning
  - added the new `postpaid_forgiven` enum value to the `data/items/grant_reason/allOf[#/components/schemas/BillingCreditGrantReason]/` response property for the response status `200`
  - added the new `postpaid_settlement` enum value to the `data/items/grant_reason/allOf[#/components/schemas/BillingCreditGrantReason]/` response property for the response status `200`
- **2026-09-16** `afe97b9908ca`: 1 warning
  - added the new `postpaid_overdraft` enum value to the `data/items/grant_reason/allOf[#/components/schemas/BillingCreditGrantReason]/` response property for the response status `200`
- **2026-09-14** `1ce13450aec3`: 2 warning
  - added the new `reservation_hold` enum value to the `data/items/usage_reason/allOf[#/components/schemas/CreditUsageReason]/` response property for the response status `200`
  - added the new `reservation_release` enum value to the `data/items/usage_reason/allOf[#/components/schemas/CreditUsageReason]/` response property for the response status `200`
- **2026-07-27** `e83d3358bab3`: 1 warning
  - added the new `license_retired` enum value to the `data/items/zeroed_out_reason/allOf[#/components/schemas/BillingCreditGrantZeroedOutReason]/` response property for the response status `200`
- **2026-07-15** `3baa54bf8b3f`: 2 warning
  - for the `query` request parameter `limit`, the max was set to `250.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`
- **2026-07-06** `e6b85f57df53`: 1 warning
  - added the new `customer_archived` enum value to the `data/items/zeroed_out_reason/allOf[#/components/schemas/BillingCreditGrantZeroedOutReason]/` response property for the response status `200`
- **2026-07-06** `e836d3bfd007`: 1 warning
  - added the new `integration_uninstalled` enum value to the `data/items/zeroed_out_reason/allOf[#/components/schemas/BillingCreditGrantZeroedOutReason]/` response property for the response status `200`
- **2026-06-26** `b9c1b16b6a1b`: 1 breaking
  - the `data/items/grant_quantity` response's property type changed from `integer` to `number`, and format from `int64` to `double` for status `200`
- **2026-06-10** `4c1ac12569e2`: 1 warning
  - added the new `reconciled` enum value to the `data/items/zeroed_out_reason/allOf[#/components/schemas/BillingCreditGrantZeroedOutReason]/` response property for the response status `200`
- **2026-06-05** `c0d7b479cd11`: 1 info
  - added the optional property `data/items/usage_reason` to the response with the `200` status
- **2026-06-04** `df525a3b6157`: 1 warning
  - added the new `rollover` enum value to the `data/items/grant_reason/allOf[#/components/schemas/BillingCreditGrantReason]/` response property for the response status `200`

---

[Operation](https://skmtc.dev/schematichq/apis/schematic-api/docs/v2/billing/credits/ledger/get.md) - [API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [Page](https://skmtc.dev/schematichq/apis/schematic-api/changes/v2/billing/credits/ledger/get)
