lithic-com · stainless-app · Dec 15, 2025 · Dec 19, 2025 · Dec 23, 2025 · Dec 23, 2025
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.114.0"
+  ".": "0.115.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 176
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-abe6a4f82f696099fa8ecb1cc44f08979e17d56578ae7ea68b0e9182e21df508.yml
-openapi_spec_hash: d2ce51592a9a234c6f34a1168a31f91f
-config_hash: 739714a3fead0b26ee3a3b7bc51081f6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-854de7cc8f79e150ffe98f038ce9f39367010b2bdfffc9992be2738697dc4880.yml
+openapi_spec_hash: fd471b20f3eda1e00cdebf028cbfe867
+config_hash: 9dddee5f7af579864599849cb28a0770
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.115.0 (2025-12-23)
+
+Full Changelog: [v0.114.0...v0.115.0](https://github.com/lithic-com/lithic-java/compare/v0.114.0...v0.115.0)
+
+### Features
+
+* **api:** add external_id to payment_event ([7e8636d](https://github.com/lithic-com/lithic-java/commit/7e8636dfea36aff2e4bebc432f3d89375c2da25e))
+* **api:** add get /v1/transfer_limits endpoint ([7e8636d](https://github.com/lithic-com/lithic-java/commit/7e8636dfea36aff2e4bebc432f3d89375c2da25e))
+* **api:** add post /v1/book_transfers/{book_transfer_token}/retry endpoint ([7e8636d](https://github.com/lithic-com/lithic-java/commit/7e8636dfea36aff2e4bebc432f3d89375c2da25e))
+* **api:** add WIRE_DRAWDOWN_REQUEST transfer type ([7d05a12](https://github.com/lithic-com/lithic-java/commit/7d05a12c19b115f9b3a7f7c410523e04c7a4c3c6))
+* **api:** remove unnecessary X-Lithic-Pagination header ([7d05a12](https://github.com/lithic-com/lithic-java/commit/7d05a12c19b115f9b3a7f7c410523e04c7a4c3c6))
+* **api:** remove v1/aggregate_balances and related models ([5af17d0](https://github.com/lithic-com/lithic-java/commit/5af17d0a2f9d70199ff755fffef3b5ef7f23ab41))
+
+
+### Documentation
+
+* **api:** clarify description of token /  retry_token when it serves as idempotency key ([7d05a12](https://github.com/lithic-com/lithic-java/commit/7d05a12c19b115f9b3a7f7c410523e04c7a4c3c6))
+
 ## 0.114.0 (2025-12-11)
 
 Full Changelog: [v0.113.0...v0.114.0](https://github.com/lithic-com/lithic-java/compare/v0.113.0...v0.114.0)

diff --git a/README.md b/README.md
@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.lithic.api/lithic-java)](https://central.sonatype.com/artifact/com.lithic.api/lithic-java/0.114.0)
-[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.114.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.114.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.lithic.api/lithic-java)](https://central.sonatype.com/artifact/com.lithic.api/lithic-java/0.115.0)
+[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.115.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.115.0)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ The Lithic Java SDK is similar to the Lithic Kotlin SDK but with minor differenc
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [docs.lithic.com](https://docs.lithic.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.lithic.api/lithic-java/0.114.0).
+The REST API documentation can be found on [docs.lithic.com](https://docs.lithic.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.lithic.api/lithic-java/0.115.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [docs.lithic.com](https://docs.lithic
 ### Gradle
 
 ```kotlin
-implementation("com.lithic.api:lithic-java:0.114.0")
+implementation("com.lithic.api:lithic-java:0.115.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.lithic.api:lithic-java:0.114.0")
 <dependency>
   <groupId>com.lithic.api</groupId>
   <artifactId>lithic-java</artifactId>
-  <version>0.114.0</version>
+  <version>0.115.0</version>
 </dependency>
 ```
 

diff --git a/build.gradle.kts b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.lithic.api"
-    version = "0.114.0" // x-release-please-version
+    version = "0.115.0" // x-release-please-version
 }
 
 subprojects {

diff --git a/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClient.kt b/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClient.kt
@@ -11,7 +11,6 @@ import com.lithic.api.models.ClientApiStatusParams
 import com.lithic.api.services.blocking.AccountActivityService
 import com.lithic.api.services.blocking.AccountHolderService
 import com.lithic.api.services.blocking.AccountService
-import com.lithic.api.services.blocking.AggregateBalanceService
 import com.lithic.api.services.blocking.AuthRuleService
 import com.lithic.api.services.blocking.AuthStreamEnrollmentService
 import com.lithic.api.services.blocking.BalanceService
@@ -39,6 +38,7 @@ import com.lithic.api.services.blocking.ThreeDSService
 import com.lithic.api.services.blocking.TokenizationDecisioningService
 import com.lithic.api.services.blocking.TokenizationService
 import com.lithic.api.services.blocking.TransactionService
+import com.lithic.api.services.blocking.TransferLimitService
 import com.lithic.api.services.blocking.TransferService
 import com.lithic.api.services.blocking.WebhookService
 import java.util.function.Consumer
@@ -97,8 +97,6 @@ interface LithicClient {
 
     fun balances(): BalanceService
 
-    fun aggregateBalances(): AggregateBalanceService
-
     fun disputes(): DisputeService
 
     fun disputesV2(): DisputesV2Service
@@ -143,6 +141,8 @@ interface LithicClient {
 
     fun accountActivity(): AccountActivityService
 
+    fun transferLimits(): TransferLimitService
+
     fun webhooks(): WebhookService
 
     /** Status of api */
@@ -203,8 +203,6 @@ interface LithicClient {
 
         fun balances(): BalanceService.WithRawResponse
 
-        fun aggregateBalances(): AggregateBalanceService.WithRawResponse
-
         fun disputes(): DisputeService.WithRawResponse
 
         fun disputesV2(): DisputesV2Service.WithRawResponse
@@ -249,6 +247,8 @@ interface LithicClient {
 
         fun accountActivity(): AccountActivityService.WithRawResponse
 
+        fun transferLimits(): TransferLimitService.WithRawResponse
+
         fun webhooks(): WebhookService.WithRawResponse
 
         /**

diff --git a/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsync.kt b/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsync.kt
@@ -10,7 +10,6 @@ import com.lithic.api.models.ClientApiStatusParams
 import com.lithic.api.services.async.AccountActivityServiceAsync
 import com.lithic.api.services.async.AccountHolderServiceAsync
 import com.lithic.api.services.async.AccountServiceAsync
-import com.lithic.api.services.async.AggregateBalanceServiceAsync
 import com.lithic.api.services.async.AuthRuleServiceAsync
 import com.lithic.api.services.async.AuthStreamEnrollmentServiceAsync
 import com.lithic.api.services.async.BalanceServiceAsync
@@ -38,6 +37,7 @@ import com.lithic.api.services.async.ThreeDSServiceAsync
 import com.lithic.api.services.async.TokenizationDecisioningServiceAsync
 import com.lithic.api.services.async.TokenizationServiceAsync
 import com.lithic.api.services.async.TransactionServiceAsync
+import com.lithic.api.services.async.TransferLimitServiceAsync
 import com.lithic.api.services.async.TransferServiceAsync
 import com.lithic.api.services.async.WebhookServiceAsync
 import java.util.concurrent.CompletableFuture
@@ -97,8 +97,6 @@ interface LithicClientAsync {
 
     fun balances(): BalanceServiceAsync
 
-    fun aggregateBalances(): AggregateBalanceServiceAsync
-
     fun disputes(): DisputeServiceAsync
 
     fun disputesV2(): DisputesV2ServiceAsync
@@ -143,6 +141,8 @@ interface LithicClientAsync {
 
     fun accountActivity(): AccountActivityServiceAsync
 
+    fun transferLimits(): TransferLimitServiceAsync
+
     fun webhooks(): WebhookServiceAsync
 
     /** Status of api */
@@ -206,8 +206,6 @@ interface LithicClientAsync {
 
         fun balances(): BalanceServiceAsync.WithRawResponse
 
-        fun aggregateBalances(): AggregateBalanceServiceAsync.WithRawResponse
-
         fun disputes(): DisputeServiceAsync.WithRawResponse
 
         fun disputesV2(): DisputesV2ServiceAsync.WithRawResponse
@@ -252,6 +250,8 @@ interface LithicClientAsync {
 
         fun accountActivity(): AccountActivityServiceAsync.WithRawResponse
 
+        fun transferLimits(): TransferLimitServiceAsync.WithRawResponse
+
         fun webhooks(): WebhookServiceAsync.WithRawResponse
 
         /**

diff --git a/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsyncImpl.kt b/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsyncImpl.kt
@@ -23,8 +23,6 @@ import com.lithic.api.services.async.AccountHolderServiceAsync
 import com.lithic.api.services.async.AccountHolderServiceAsyncImpl
 import com.lithic.api.services.async.AccountServiceAsync
 import com.lithic.api.services.async.AccountServiceAsyncImpl
-import com.lithic.api.services.async.AggregateBalanceServiceAsync
-import com.lithic.api.services.async.AggregateBalanceServiceAsyncImpl
 import com.lithic.api.services.async.AuthRuleServiceAsync
 import com.lithic.api.services.async.AuthRuleServiceAsyncImpl
 import com.lithic.api.services.async.AuthStreamEnrollmentServiceAsync
@@ -79,6 +77,8 @@ import com.lithic.api.services.async.TokenizationServiceAsync
 import com.lithic.api.services.async.TokenizationServiceAsyncImpl
 import com.lithic.api.services.async.TransactionServiceAsync
 import com.lithic.api.services.async.TransactionServiceAsyncImpl
+import com.lithic.api.services.async.TransferLimitServiceAsync
+import com.lithic.api.services.async.TransferLimitServiceAsyncImpl
 import com.lithic.api.services.async.TransferServiceAsync
 import com.lithic.api.services.async.TransferServiceAsyncImpl
 import com.lithic.api.services.async.WebhookServiceAsync
@@ -137,10 +137,6 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
         BalanceServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
-    private val aggregateBalances: AggregateBalanceServiceAsync by lazy {
-        AggregateBalanceServiceAsyncImpl(clientOptionsWithUserAgent)
-    }
-
     private val disputes: DisputeServiceAsync by lazy {
         DisputeServiceAsyncImpl(clientOptionsWithUserAgent)
     }
@@ -229,6 +225,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
         AccountActivityServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
+    private val transferLimits: TransferLimitServiceAsync by lazy {
+        TransferLimitServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
     private val webhooks: WebhookServiceAsync by lazy {
         WebhookServiceAsyncImpl(clientOptionsWithUserAgent)
     }
@@ -259,8 +259,6 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
     override fun balances(): BalanceServiceAsync = balances
 
-    override fun aggregateBalances(): AggregateBalanceServiceAsync = aggregateBalances
-
     override fun disputes(): DisputeServiceAsync = disputes
 
     override fun disputesV2(): DisputesV2ServiceAsync = disputesV2
@@ -305,6 +303,8 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
     override fun accountActivity(): AccountActivityServiceAsync = accountActivity
 
+    override fun transferLimits(): TransferLimitServiceAsync = transferLimits
+
     override fun webhooks(): WebhookServiceAsync = webhooks
 
     override fun apiStatus(
@@ -359,10 +359,6 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
             BalanceServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val aggregateBalances: AggregateBalanceServiceAsync.WithRawResponse by lazy {
-            AggregateBalanceServiceAsyncImpl.WithRawResponseImpl(clientOptions)
-        }
-
         private val disputes: DisputeServiceAsync.WithRawResponse by lazy {
             DisputeServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
@@ -451,6 +447,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
             AccountActivityServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val transferLimits: TransferLimitServiceAsync.WithRawResponse by lazy {
+            TransferLimitServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val webhooks: WebhookServiceAsync.WithRawResponse by lazy {
             WebhookServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
@@ -482,9 +482,6 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
         override fun balances(): BalanceServiceAsync.WithRawResponse = balances
 
-        override fun aggregateBalances(): AggregateBalanceServiceAsync.WithRawResponse =
-            aggregateBalances
-
         override fun disputes(): DisputeServiceAsync.WithRawResponse = disputes
 
         override fun disputesV2(): DisputesV2ServiceAsync.WithRawResponse = disputesV2
@@ -536,6 +533,8 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
         override fun accountActivity(): AccountActivityServiceAsync.WithRawResponse =
             accountActivity
 
+        override fun transferLimits(): TransferLimitServiceAsync.WithRawResponse = transferLimits
+
         override fun webhooks(): WebhookServiceAsync.WithRawResponse = webhooks
 
         private val apiStatusHandler: Handler<ApiStatus> =

diff --git a/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientImpl.kt b/lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientImpl.kt
@@ -23,8 +23,6 @@ import com.lithic.api.services.blocking.AccountHolderService
 import com.lithic.api.services.blocking.AccountHolderServiceImpl
 import com.lithic.api.services.blocking.AccountService
 import com.lithic.api.services.blocking.AccountServiceImpl
-import com.lithic.api.services.blocking.AggregateBalanceService
-import com.lithic.api.services.blocking.AggregateBalanceServiceImpl
 import com.lithic.api.services.blocking.AuthRuleService
 import com.lithic.api.services.blocking.AuthRuleServiceImpl
 import com.lithic.api.services.blocking.AuthStreamEnrollmentService
@@ -79,6 +77,8 @@ import com.lithic.api.services.blocking.TokenizationService
 import com.lithic.api.services.blocking.TokenizationServiceImpl
 import com.lithic.api.services.blocking.TransactionService
 import com.lithic.api.services.blocking.TransactionServiceImpl
+import com.lithic.api.services.blocking.TransferLimitService
+import com.lithic.api.services.blocking.TransferLimitServiceImpl
 import com.lithic.api.services.blocking.TransferService
 import com.lithic.api.services.blocking.TransferServiceImpl
 import com.lithic.api.services.blocking.WebhookService
@@ -132,10 +132,6 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     private val balances: BalanceService by lazy { BalanceServiceImpl(clientOptionsWithUserAgent) }
 
-    private val aggregateBalances: AggregateBalanceService by lazy {
-        AggregateBalanceServiceImpl(clientOptionsWithUserAgent)
-    }
-
     private val disputes: DisputeService by lazy { DisputeServiceImpl(clientOptionsWithUserAgent) }
 
     private val disputesV2: DisputesV2Service by lazy {
@@ -212,6 +208,10 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
         AccountActivityServiceImpl(clientOptionsWithUserAgent)
     }
 
+    private val transferLimits: TransferLimitService by lazy {
+        TransferLimitServiceImpl(clientOptionsWithUserAgent)
+    }
+
     private val webhooks: WebhookService by lazy { WebhookServiceImpl(clientOptionsWithUserAgent) }
 
     override fun async(): LithicClientAsync = async
@@ -239,8 +239,6 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     override fun balances(): BalanceService = balances
 
-    override fun aggregateBalances(): AggregateBalanceService = aggregateBalances
-
     override fun disputes(): DisputeService = disputes
 
     override fun disputesV2(): DisputesV2Service = disputesV2
@@ -285,6 +283,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     override fun accountActivity(): AccountActivityService = accountActivity
 
+    override fun transferLimits(): TransferLimitService = transferLimits
+
     override fun webhooks(): WebhookService = webhooks
 
     override fun apiStatus(
@@ -339,10 +339,6 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
             BalanceServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val aggregateBalances: AggregateBalanceService.WithRawResponse by lazy {
-            AggregateBalanceServiceImpl.WithRawResponseImpl(clientOptions)
-        }
-
         private val disputes: DisputeService.WithRawResponse by lazy {
             DisputeServiceImpl.WithRawResponseImpl(clientOptions)
         }
@@ -431,6 +427,10 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
             AccountActivityServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val transferLimits: TransferLimitService.WithRawResponse by lazy {
+            TransferLimitServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val webhooks: WebhookService.WithRawResponse by lazy {
             WebhookServiceImpl.WithRawResponseImpl(clientOptions)
         }
@@ -462,9 +462,6 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
         override fun balances(): BalanceService.WithRawResponse = balances
 
-        override fun aggregateBalances(): AggregateBalanceService.WithRawResponse =
-            aggregateBalances
-
         override fun disputes(): DisputeService.WithRawResponse = disputes
 
         override fun disputesV2(): DisputesV2Service.WithRawResponse = disputesV2
@@ -514,6 +511,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
         override fun accountActivity(): AccountActivityService.WithRawResponse = accountActivity
 
+        override fun transferLimits(): TransferLimitService.WithRawResponse = transferLimits
+
         override fun webhooks(): WebhookService.WithRawResponse = webhooks
 
         private val apiStatusHandler: Handler<ApiStatus> =

diff --git a/lithic-java-core/src/main/kotlin/com/lithic/api/core/ClientOptions.kt b/lithic-java-core/src/main/kotlin/com/lithic/api/core/ClientOptions.kt
@@ -475,7 +475,6 @@ private constructor(
             headers.put("X-Stainless-Package-Version", getPackageVersion())
             headers.put("X-Stainless-Runtime", "JRE")
             headers.put("X-Stainless-Runtime-Version", getJavaVersion())
-            headers.put("X-Lithic-Pagination", "cursor")
             apiKey.let {
                 if (!it.isEmpty()) {
                     headers.put("Authorization", it)