release: 0.127.0

.github/workflows/ci.yml

@@ -22,10 +22,10 @@ jobs:
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -34,7 +34,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/actions/setup-gradle@v4
+        uses: gradle/actions/setup-gradle@ed408507eac070d1f99cc633dbcf757c94c7933a # v4.4.3
 
       - name: Run lints
         run: ./scripts/lint
@@ -49,10 +49,10 @@ jobs:
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -61,7 +61,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/actions/setup-gradle@v4
+        uses: gradle/actions/setup-gradle@ed408507eac070d1f99cc633dbcf757c94c7933a # v4.4.3
 
       - name: Build SDK
         run: ./scripts/build
@@ -71,7 +71,7 @@ jobs:
           github.repository == 'stainless-sdks/lithic-java' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -91,10 +91,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/lithic-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -103,7 +103,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/gradle-build-action@v2
+        uses: gradle/gradle-build-action@a8f75513eafdebd8141bd1cd4e30fcd194af8dfa # v2.12.0
 
       - name: Run tests
         run: ./scripts/test

.github/workflows/publish-sonatype.yml

@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -26,7 +26,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/gradle-build-action@v2
+        uses: gradle/gradle-build-action@a8f75513eafdebd8141bd1cd4e30fcd194af8dfa # v2.12.0
 
       - name: Publish to Sonatype
         run: |-

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'lithic-com/lithic-java' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.126.0"
+  ".": "0.127.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 193
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-00f07b0edcc0c3c5ef79920ced7f58dac2434df5e4c27ff6041783e8228315f9.yml
-openapi_spec_hash: 963688b09480159a06865075c94a2577
-config_hash: 265a2b679964f4ad5706de101ad2a942
+configured_endpoints: 194
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-55d6cdcb852320054c00ae49deb0e42c086bdb82ada1ab7ac1bbbbc7c7cc0eeb.yml
+openapi_spec_hash: 71f86153c543bc60978d55b8a2634674
+config_hash: 1c5c139a2aa0d1d45c063f953a9bc803

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.127.0 (2026-05-15)
+
+Full Changelog: [v0.126.0...v0.127.0](https://github.com/lithic-com/lithic-java/compare/v0.126.0...v0.127.0)
+
+### Features
+
+* **api:** add card authorization challenge webhook, rename types in authorization models ([295e9f3](https://github.com/lithic-com/lithic-java/commit/295e9f3ce7a09c03f9c31b490f9b176d16c9194a))
+
+
+### Bug Fixes
+
+* **types:** change number from Long to Double in ConditionalValue and conditional actions ([57b5b27](https://github.com/lithic-com/lithic-java/commit/57b5b279f5c23550dbc40946227d483410ca0c14))
+
+
+### Documentation
+
+* **api:** clarify ACCOUNT_AGE attribute behavior in conditional parameters ([c4a5ee1](https://github.com/lithic-com/lithic-java/commit/c4a5ee1383f947a8662ce80c3a2a1d785c76a228))
+
 ## 0.126.0 (2026-05-08)
 
 Full Changelog: [v0.125.0...v0.126.0](https://github.com/lithic-com/lithic-java/compare/v0.125.0...v0.126.0)

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.126.0)
-[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.126.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.126.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.127.0)
+[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.127.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.127.0)
 
 <!-- x-release-please-end -->
 
@@ -22,7 +22,7 @@ Use the Lithic MCP Server to enable AI assistants to interact with this API, all
 
 <!-- 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.126.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.127.0).
 
 <!-- x-release-please-end -->
 
@@ -33,7 +33,7 @@ The REST API documentation can be found on [docs.lithic.com](https://docs.lithic
 ### Gradle
 
 ```kotlin
-implementation("com.lithic.api:lithic-java:0.126.0")
+implementation("com.lithic.api:lithic-java:0.127.0")
 ```
 
 ### Maven
@@ -42,7 +42,7 @@ implementation("com.lithic.api:lithic-java:0.126.0")
 <dependency>
   <groupId>com.lithic.api</groupId>
   <artifactId>lithic-java</artifactId>
-  <version>0.126.0</version>
+  <version>0.127.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.lithic.api"
-    version = "0.126.0" // x-release-please-version
+    version = "0.127.0" // x-release-please-version
 }
 
 subprojects {

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClient.kt

@@ -15,6 +15,7 @@ import com.lithic.api.services.blocking.AuthRuleService
 import com.lithic.api.services.blocking.AuthStreamEnrollmentService
 import com.lithic.api.services.blocking.BalanceService
 import com.lithic.api.services.blocking.BookTransferService
+import com.lithic.api.services.blocking.CardAuthorizationService
 import com.lithic.api.services.blocking.CardBulkOrderService
 import com.lithic.api.services.blocking.CardProgramService
 import com.lithic.api.services.blocking.CardService
@@ -94,6 +95,8 @@ interface LithicClient {
 
     fun cards(): CardService
 
+    fun cardAuthorizations(): CardAuthorizationService
+
     fun cardBulkOrders(): CardBulkOrderService
 
     fun balances(): BalanceService
@@ -202,6 +205,8 @@ interface LithicClient {
 
         fun cards(): CardService.WithRawResponse
 
+        fun cardAuthorizations(): CardAuthorizationService.WithRawResponse
+
         fun cardBulkOrders(): CardBulkOrderService.WithRawResponse
 
         fun balances(): BalanceService.WithRawResponse

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsync.kt

@@ -14,6 +14,7 @@ import com.lithic.api.services.async.AuthRuleServiceAsync
 import com.lithic.api.services.async.AuthStreamEnrollmentServiceAsync
 import com.lithic.api.services.async.BalanceServiceAsync
 import com.lithic.api.services.async.BookTransferServiceAsync
+import com.lithic.api.services.async.CardAuthorizationServiceAsync
 import com.lithic.api.services.async.CardBulkOrderServiceAsync
 import com.lithic.api.services.async.CardProgramServiceAsync
 import com.lithic.api.services.async.CardServiceAsync
@@ -94,6 +95,8 @@ interface LithicClientAsync {
 
     fun cards(): CardServiceAsync
 
+    fun cardAuthorizations(): CardAuthorizationServiceAsync
+
     fun cardBulkOrders(): CardBulkOrderServiceAsync
 
     fun balances(): BalanceServiceAsync
@@ -205,6 +208,8 @@ interface LithicClientAsync {
 
         fun cards(): CardServiceAsync.WithRawResponse
 
+        fun cardAuthorizations(): CardAuthorizationServiceAsync.WithRawResponse
+
         fun cardBulkOrders(): CardBulkOrderServiceAsync.WithRawResponse
 
         fun balances(): BalanceServiceAsync.WithRawResponse

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsyncImpl.kt

@@ -31,6 +31,8 @@ import com.lithic.api.services.async.BalanceServiceAsync
 import com.lithic.api.services.async.BalanceServiceAsyncImpl
 import com.lithic.api.services.async.BookTransferServiceAsync
 import com.lithic.api.services.async.BookTransferServiceAsyncImpl
+import com.lithic.api.services.async.CardAuthorizationServiceAsync
+import com.lithic.api.services.async.CardAuthorizationServiceAsyncImpl
 import com.lithic.api.services.async.CardBulkOrderServiceAsync
 import com.lithic.api.services.async.CardBulkOrderServiceAsyncImpl
 import com.lithic.api.services.async.CardProgramServiceAsync
@@ -131,6 +133,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
     private val cards: CardServiceAsync by lazy { CardServiceAsyncImpl(clientOptionsWithUserAgent) }
 
+    private val cardAuthorizations: CardAuthorizationServiceAsync by lazy {
+        CardAuthorizationServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
     private val cardBulkOrders: CardBulkOrderServiceAsync by lazy {
         CardBulkOrderServiceAsyncImpl(clientOptionsWithUserAgent)
     }
@@ -259,6 +265,8 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
     override fun cards(): CardServiceAsync = cards
 
+    override fun cardAuthorizations(): CardAuthorizationServiceAsync = cardAuthorizations
+
     override fun cardBulkOrders(): CardBulkOrderServiceAsync = cardBulkOrders
 
     override fun balances(): BalanceServiceAsync = balances
@@ -357,6 +365,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
             CardServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val cardAuthorizations: CardAuthorizationServiceAsync.WithRawResponse by lazy {
+            CardAuthorizationServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val cardBulkOrders: CardBulkOrderServiceAsync.WithRawResponse by lazy {
             CardBulkOrderServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
@@ -488,6 +500,9 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
         override fun cards(): CardServiceAsync.WithRawResponse = cards
 
+        override fun cardAuthorizations(): CardAuthorizationServiceAsync.WithRawResponse =
+            cardAuthorizations
+
         override fun cardBulkOrders(): CardBulkOrderServiceAsync.WithRawResponse = cardBulkOrders
 
         override fun balances(): BalanceServiceAsync.WithRawResponse = balances

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientImpl.kt

@@ -31,6 +31,8 @@ import com.lithic.api.services.blocking.BalanceService
 import com.lithic.api.services.blocking.BalanceServiceImpl
 import com.lithic.api.services.blocking.BookTransferService
 import com.lithic.api.services.blocking.BookTransferServiceImpl
+import com.lithic.api.services.blocking.CardAuthorizationService
+import com.lithic.api.services.blocking.CardAuthorizationServiceImpl
 import com.lithic.api.services.blocking.CardBulkOrderService
 import com.lithic.api.services.blocking.CardBulkOrderServiceImpl
 import com.lithic.api.services.blocking.CardProgramService
@@ -128,6 +130,10 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     private val cards: CardService by lazy { CardServiceImpl(clientOptionsWithUserAgent) }
 
+    private val cardAuthorizations: CardAuthorizationService by lazy {
+        CardAuthorizationServiceImpl(clientOptionsWithUserAgent)
+    }
+
     private val cardBulkOrders: CardBulkOrderService by lazy {
         CardBulkOrderServiceImpl(clientOptionsWithUserAgent)
     }
@@ -239,6 +245,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     override fun cards(): CardService = cards
 
+    override fun cardAuthorizations(): CardAuthorizationService = cardAuthorizations
+
     override fun cardBulkOrders(): CardBulkOrderService = cardBulkOrders
 
     override fun balances(): BalanceService = balances
@@ -337,6 +345,10 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
             CardServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val cardAuthorizations: CardAuthorizationService.WithRawResponse by lazy {
+            CardAuthorizationServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val cardBulkOrders: CardBulkOrderService.WithRawResponse by lazy {
             CardBulkOrderServiceImpl.WithRawResponseImpl(clientOptions)
         }
@@ -468,6 +480,9 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
         override fun cards(): CardService.WithRawResponse = cards
 
+        override fun cardAuthorizations(): CardAuthorizationService.WithRawResponse =
+            cardAuthorizations
+
         override fun cardBulkOrders(): CardBulkOrderService.WithRawResponse = cardBulkOrders
 
         override fun balances(): BalanceService.WithRawResponse = balances

lithic-java-core/src/main/kotlin/com/lithic/api/models/AuthRuleCondition.kt

@@ -258,8 +258,11 @@ private constructor(
         /** Alias for calling [value] with `ConditionalValue.ofRegex(regex)`. */
         fun value(regex: String) = value(ConditionalValue.ofRegex(regex))
 
+        /** Alias for calling [value] with `ConditionalValue.ofInteger(integer)`. */
+        fun value(integer: Long) = value(ConditionalValue.ofInteger(integer))
+
         /** Alias for calling [value] with `ConditionalValue.ofNumber(number)`. */
-        fun value(number: Long) = value(ConditionalValue.ofNumber(number))
+        fun value(number: Double) = value(ConditionalValue.ofNumber(number))
 
         /** Alias for calling [value] with `ConditionalValue.ofListOfStrings(listOfStrings)`. */
         fun valueOfListOfStrings(listOfStrings: List<String>) =