chargebee · cb-alish · Jun 12, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,40 @@
+### v4.10.0 (2026-06-12)
+* * *
+### New Resources:
+- [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks) has been added.
+- [`LedgerAccountBalance`](https://apidocs.chargebee.com/docs/api/ledger_account_balances) has been added.
+- [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations) has been added.
+- [`PromotionalGrant`](https://apidocs.chargebee.com/docs/api/promotional_grants) has been added.
+
+
+### New Attributes:
+- [`notes`](https://apidocs.chargebee.com/docs/api/credit_notes/credit-note-object#notes) has been added to [`CreditNote`](https://apidocs.chargebee.com/docs/api/credit_notes).
+- [`layout`](https://apidocs.chargebee.com/docs/api/hosted_pages/hosted-page-object#layout) has been added to [`HostedPage`](https://apidocs.chargebee.com/docs/api/hosted_pages).
+
+
+### New Parameters:
+- [`sort_by`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions/list-omnichannel-subscriptions#sort_by) has been added as query parameter to [`list_omnichannel_subscriptions`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions/list-omnichannel-subscriptions) in [`OmnichannelSubscription`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions).
+
+
+### New Enums:
+- `available`, `exhausted`, `scheduled`, and `in_grace_period` have been added as new values enum `Status`.
+- `subscription_created`, `subscription_changed`, `top_up`, `promotional_grants`, and `rollover` have been added as new values to enum attribute [`grant_source`](https://apidocs.chargebee.com/docs/api/grant_blocks/grant-block-object#grant_source) in [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks).
+- `provisioned` and `overdraft` have been added as new values to enum attribute [`account_type`](https://apidocs.chargebee.com/docs/api/grant_blocks/grant-block-object#account_type) in [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks).
+- `credit_unit` has been added as a new value to enum attribute [`unit_type`](https://apidocs.chargebee.com/docs/api/grant_blocks/grant-block-object#unit_type) in [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks).
+- `credit_unit` has been added as a new value to enum attribute [`unit_type`](https://apidocs.chargebee.com/docs/api/ledger_account_balances/ledger-account-balance-object#unit_type) in [`LedgerAccountBalance`](https://apidocs.chargebee.com/docs/api/ledger_account_balances).
+- `allocation`, `capture`, `authorize`, `release_authorization`, `capture_authorization`, `expiry`, `void`, `rollover`, and `adjustment` have been added as new values to enum attribute [`type`](https://apidocs.chargebee.com/docs/api/ledger_operations/ledger-operation-object#type) in [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `credit_unit` has been added as a new value to enum attribute [`unit_type`](https://apidocs.chargebee.com/docs/api/ledger_operations/ledger-operation-object#unit_type) in [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `expires_at`, `created_at`, and `effective_from` have been added as new values to enum query parameter `sort_by.asc` in [`list_grant_blocks`](https://apidocs.chargebee.com/docs/api/grant_blocks/list-grant-blocks) of [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks).
+- `expires_at`, `created_at`, and `effective_from` have been added as new values to enum query parameter `sort_by.desc` in [`list_grant_blocks`](https://apidocs.chargebee.com/docs/api/grant_blocks/list-grant-blocks) of [`GrantBlock`](https://apidocs.chargebee.com/docs/api/grant_blocks).
+- `allocation`, `release_authorization`, `void`, `capture`, `rollover`, `adjustment`, `expiry`, `authorize`, and `capture_authorization` have been added as new values to enum query parameter `type.is` in [`list_ledger_operations`](https://apidocs.chargebee.com/docs/api/ledger_operations/list-ledger-operations) of [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `allocation`, `release_authorization`, `void`, `capture`, `rollover`, `adjustment`, `expiry`, `authorize`, and `capture_authorization` have been added as new values to enum query parameter `type.in` in [`list_ledger_operations`](https://apidocs.chargebee.com/docs/api/ledger_operations/list-ledger-operations) of [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `created_at` has been added as a new value to enum query parameter `sort_by.asc` in [`list_ledger_operations`](https://apidocs.chargebee.com/docs/api/ledger_operations/list-ledger-operations) of [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `created_at` has been added as a new value to enum query parameter `sort_by.desc` in [`list_ledger_operations`](https://apidocs.chargebee.com/docs/api/ledger_operations/list-ledger-operations) of [`LedgerOperation`](https://apidocs.chargebee.com/docs/api/ledger_operations).
+- `updated_at` and `created_at` have been added as new values to enum query parameter `sort_by.asc` in [`list_omnichannel_subscriptions`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions/list-omnichannel-subscriptions) of [`OmnichannelSubscription`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions).
+- `updated_at` and `created_at` have been added as new values to enum query parameter `sort_by.desc` in [`list_omnichannel_subscriptions`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions/list-omnichannel-subscriptions) of [`OmnichannelSubscription`](https://apidocs.chargebee.com/docs/api/omnichannel_subscriptions).
+
+
+
 ### v4.9.0 (2026-06-08)
 * * *
 ### New Attributes:

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-4.9.0
+4.10.0
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -7,7 +7,7 @@ plugins {
 }
 
 group = "com.chargebee"
-version = "4.9.0"
+version = "4.10.0"
 description = "Java client library for ChargeBee"
 
 // Project metadata

diff --git a/src/main/java/com/chargebee/v4/client/ClientMethods.java b/src/main/java/com/chargebee/v4/client/ClientMethods.java
@@ -12,6 +12,8 @@
 
 import com.chargebee.v4.services.OfferEventService;
 
+import com.chargebee.v4.services.PromotionalGrantService;
+
 import com.chargebee.v4.services.InAppSubscriptionService;
 
 import com.chargebee.v4.services.Pc2MigrationService;
@@ -20,6 +22,8 @@
 
 import com.chargebee.v4.services.CouponSetService;
 
+import com.chargebee.v4.services.LedgerAccountBalanceService;
+
 import com.chargebee.v4.services.QuoteService;
 
 import com.chargebee.v4.services.Pc2MigrationItemService;
@@ -60,6 +64,8 @@
 
 import com.chargebee.v4.services.AdditionalBillingLogiqService;
 
+import com.chargebee.v4.services.LedgerOperationService;
+
 import com.chargebee.v4.services.UsageSummaryService;
 
 import com.chargebee.v4.services.AlertStatusService;
@@ -84,6 +90,8 @@
 
 import com.chargebee.v4.services.VirtualBankAccountService;
 
+import com.chargebee.v4.services.GrantBlockService;
+
 import com.chargebee.v4.services.AddonService;
 
 import com.chargebee.v4.services.TpSiteUserService;
@@ -218,6 +226,13 @@ public interface ClientMethods {
    */
   OfferEventService offerEvents();
 
+  /**
+   * Access promotional_grant-related operations.
+   *
+   * @return PromotionalGrantService instance for fluent API access
+   */
+  PromotionalGrantService promotionalGrants();
+
   /**
    * Access in_app_subscription-related operations.
    *
@@ -246,6 +261,13 @@ public interface ClientMethods {
    */
   CouponSetService couponSets();
 
+  /**
+   * Access ledger_account_balance-related operations.
+   *
+   * @return LedgerAccountBalanceService instance for fluent API access
+   */
+  LedgerAccountBalanceService ledgerAccountBalances();
+
   /**
    * Access quote-related operations.
    *
@@ -386,6 +408,13 @@ public interface ClientMethods {
    */
   AdditionalBillingLogiqService additionalBillingLogiqs();
 
+  /**
+   * Access ledger_operation-related operations.
+   *
+   * @return LedgerOperationService instance for fluent API access
+   */
+  LedgerOperationService ledgerOperations();
+
   /**
    * Access usage_summary-related operations.
    *
@@ -470,6 +499,13 @@ public interface ClientMethods {
    */
   VirtualBankAccountService virtualBankAccounts();
 
+  /**
+   * Access grant_block-related operations.
+   *
+   * @return GrantBlockService instance for fluent API access
+   */
+  GrantBlockService grantBlocks();
+
   /**
    * Access addon-related operations.
    *

diff --git a/src/main/java/com/chargebee/v4/client/ClientMethodsImpl.java b/src/main/java/com/chargebee/v4/client/ClientMethodsImpl.java
@@ -12,6 +12,8 @@
 
 import com.chargebee.v4.services.OfferEventService;
 
+import com.chargebee.v4.services.PromotionalGrantService;
+
 import com.chargebee.v4.services.InAppSubscriptionService;
 
 import com.chargebee.v4.services.Pc2MigrationService;
@@ -20,6 +22,8 @@
 
 import com.chargebee.v4.services.CouponSetService;
 
+import com.chargebee.v4.services.LedgerAccountBalanceService;
+
 import com.chargebee.v4.services.QuoteService;
 
 import com.chargebee.v4.services.Pc2MigrationItemService;
@@ -60,6 +64,8 @@
 
 import com.chargebee.v4.services.AdditionalBillingLogiqService;
 
+import com.chargebee.v4.services.LedgerOperationService;
+
 import com.chargebee.v4.services.UsageSummaryService;
 
 import com.chargebee.v4.services.AlertStatusService;
@@ -84,6 +90,8 @@
 
 import com.chargebee.v4.services.VirtualBankAccountService;
 
+import com.chargebee.v4.services.GrantBlockService;
+
 import com.chargebee.v4.services.AddonService;
 
 import com.chargebee.v4.services.TpSiteUserService;
@@ -208,6 +216,11 @@ public OfferEventService offerEvents() {
     return getServiceRegistry().offerEvents();
   }
 
+  @Override
+  public PromotionalGrantService promotionalGrants() {
+    return getServiceRegistry().promotionalGrants();
+  }
+
   @Override
   public InAppSubscriptionService inAppSubscriptions() {
     return getServiceRegistry().inAppSubscriptions();
@@ -228,6 +241,11 @@ public CouponSetService couponSets() {
     return getServiceRegistry().couponSets();
   }
 
+  @Override
+  public LedgerAccountBalanceService ledgerAccountBalances() {
+    return getServiceRegistry().ledgerAccountBalances();
+  }
+
   @Override
   public QuoteService quotes() {
     return getServiceRegistry().quotes();
@@ -328,6 +346,11 @@ public AdditionalBillingLogiqService additionalBillingLogiqs() {
     return getServiceRegistry().additionalBillingLogiqs();
   }
 
+  @Override
+  public LedgerOperationService ledgerOperations() {
+    return getServiceRegistry().ledgerOperations();
+  }
+
   @Override
   public UsageSummaryService usageSummaries() {
     return getServiceRegistry().usageSummaries();
@@ -388,6 +411,11 @@ public VirtualBankAccountService virtualBankAccounts() {
     return getServiceRegistry().virtualBankAccounts();
   }
 
+  @Override
+  public GrantBlockService grantBlocks() {
+    return getServiceRegistry().grantBlocks();
+  }
+
   @Override
   public AddonService addons() {
     return getServiceRegistry().addons();

diff --git a/src/main/java/com/chargebee/v4/client/ServiceRegistry.java b/src/main/java/com/chargebee/v4/client/ServiceRegistry.java
@@ -12,6 +12,8 @@
 
 import com.chargebee.v4.services.OfferEventService;
 
+import com.chargebee.v4.services.PromotionalGrantService;
+
 import com.chargebee.v4.services.InAppSubscriptionService;
 
 import com.chargebee.v4.services.Pc2MigrationService;
@@ -20,6 +22,8 @@
 
 import com.chargebee.v4.services.CouponSetService;
 
+import com.chargebee.v4.services.LedgerAccountBalanceService;
+
 import com.chargebee.v4.services.QuoteService;
 
 import com.chargebee.v4.services.Pc2MigrationItemService;
@@ -60,6 +64,8 @@
 
 import com.chargebee.v4.services.AdditionalBillingLogiqService;
 
+import com.chargebee.v4.services.LedgerOperationService;
+
 import com.chargebee.v4.services.UsageSummaryService;
 
 import com.chargebee.v4.services.AlertStatusService;
@@ -84,6 +90,8 @@
 
 import com.chargebee.v4.services.VirtualBankAccountService;
 
+import com.chargebee.v4.services.GrantBlockService;
+
 import com.chargebee.v4.services.AddonService;
 
 import com.chargebee.v4.services.TpSiteUserService;
@@ -189,6 +197,8 @@ final class ServiceRegistry {
 
   private volatile OfferEventService offerEventService;
 
+  private volatile PromotionalGrantService promotionalGrantService;
+
   private volatile InAppSubscriptionService inAppSubscriptionService;
 
   private volatile Pc2MigrationService pc2MigrationService;
@@ -197,6 +207,8 @@ final class ServiceRegistry {
 
   private volatile CouponSetService couponSetService;
 
+  private volatile LedgerAccountBalanceService ledgerAccountBalanceService;
+
   private volatile QuoteService quoteService;
 
   private volatile Pc2MigrationItemService pc2MigrationItemService;
@@ -237,6 +249,8 @@ final class ServiceRegistry {
 
   private volatile AdditionalBillingLogiqService additionalBillingLogiqService;
 
+  private volatile LedgerOperationService ledgerOperationService;
+
   private volatile UsageSummaryService usageSummaryService;
 
   private volatile AlertStatusService alertStatusService;
@@ -261,6 +275,8 @@ final class ServiceRegistry {
 
   private volatile VirtualBankAccountService virtualBankAccountService;
 
+  private volatile GrantBlockService grantBlockService;
+
   private volatile AddonService addonService;
 
   private volatile TpSiteUserService tpSiteUserService;
@@ -441,6 +457,21 @@ OfferEventService offerEvents() {
     return offerEventService;
   }
 
+  /**
+   * Get or create the PromotionalGrantService instance. Thread-safe lazy initialization using
+   * double-checked locking.
+   */
+  PromotionalGrantService promotionalGrants() {
+    if (promotionalGrantService == null) {
+      synchronized (this) {
+        if (promotionalGrantService == null) {
+          promotionalGrantService = new PromotionalGrantService(client);
+        }
+      }
+    }
+    return promotionalGrantService;
+  }
+
   /**
    * Get or create the InAppSubscriptionService instance. Thread-safe lazy initialization using
    * double-checked locking.
@@ -501,6 +532,21 @@ CouponSetService couponSets() {
     return couponSetService;
   }
 
+  /**
+   * Get or create the LedgerAccountBalanceService instance. Thread-safe lazy initialization using
+   * double-checked locking.
+   */
+  LedgerAccountBalanceService ledgerAccountBalances() {
+    if (ledgerAccountBalanceService == null) {
+      synchronized (this) {
+        if (ledgerAccountBalanceService == null) {
+          ledgerAccountBalanceService = new LedgerAccountBalanceService(client);
+        }
+      }
+    }
+    return ledgerAccountBalanceService;
+  }
+
   /**
    * Get or create the QuoteService instance. Thread-safe lazy initialization using double-checked
    * locking.
@@ -801,6 +847,21 @@ AdditionalBillingLogiqService additionalBillingLogiqs() {
     return additionalBillingLogiqService;
   }
 
+  /**
+   * Get or create the LedgerOperationService instance. Thread-safe lazy initialization using
+   * double-checked locking.
+   */
+  LedgerOperationService ledgerOperations() {
+    if (ledgerOperationService == null) {
+      synchronized (this) {
+        if (ledgerOperationService == null) {
+          ledgerOperationService = new LedgerOperationService(client);
+        }
+      }
+    }
+    return ledgerOperationService;
+  }
+
   /**
    * Get or create the UsageSummaryService instance. Thread-safe lazy initialization using
    * double-checked locking.
@@ -981,6 +1042,21 @@ VirtualBankAccountService virtualBankAccounts() {
     return virtualBankAccountService;
   }
 
+  /**
+   * Get or create the GrantBlockService instance. Thread-safe lazy initialization using
+   * double-checked locking.
+   */
+  GrantBlockService grantBlocks() {
+    if (grantBlockService == null) {
+      synchronized (this) {
+        if (grantBlockService == null) {
+          grantBlockService = new GrantBlockService(client);
+        }
+      }
+    }
+    return grantBlockService;
+  }
+
   /**
    * Get or create the AddonService instance. Thread-safe lazy initialization using double-checked
    * locking.