release: 0.133.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.132.0"
+  ".": "0.133.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-59c09c7355b21b663e001d2ee1086ebd0a70d9b5433823282bca296eedff9eb0.yml
-openapi_spec_hash: d9c3b932c810809abc6e973d662ad376
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-9c9038d362c6a423011de6cfe5bf4a93ca2ea6e6991327583c4dcc47ceb8d7e3.yml
+openapi_spec_hash: c2acf17ac5eb3d9e11f86c57a0af3cb3
 config_hash: 337a99d8cc30006358b7bc2531401669

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.133.0 (2026-08-10)
+
+Full Changelog: [v0.132.0...v0.133.0](https://github.com/lithic-com/lithic-java/compare/v0.132.0...v0.133.0)
+
+### Features
+
+* **api:** add blockchain_addresses field to FinancialAccount and webhook events ([3ac1807](https://github.com/lithic-com/lithic-java/commit/3ac18071466c0d8e43570f4cdf878ec1a506a40c))
+* **api:** add limitCashAmount/limitCashCount fields to VelocityLimitParams ([9507834](https://github.com/lithic-com/lithic-java/commit/9507834f2c34614684d100e960b40a1dca2ce9c5))
+* **api:** add PROGRAM scope to AchPayment/CardTransaction, entity types to Case ([cd6e1c3](https://github.com/lithic-com/lithic-java/commit/cd6e1c3244d56d6c37ea9806d4de572a19ca5244))
+* **api:** add stablecoin event types to FinancialEvent/Payment/StatementLineItems ([46fa6f1](https://github.com/lithic-com/lithic-java/commit/46fa6f1495cab9c378cf03932090cb6710fff7ed))
+* **api:** Add STABLECOIN to approvals request and transfer type enums ([3b3dd7a](https://github.com/lithic-com/lithic-java/commit/3b3dd7ae05e57fd7d4112db5dab1a752cdacbe72))
+
+
+### Chores
+
+* **internal:** codegen related update ([39e4623](https://github.com/lithic-com/lithic-java/commit/39e4623d63b58bc9f048cc6a2592e657cf1706b8))
+
+
+### Documentation
+
+* **api:** update CVV field descriptions to note AMEX uses 4 digits ([2892515](https://github.com/lithic-com/lithic-java/commit/28925154b2b09da8cfc8e8a01d38886698df0156))
+
 ## 0.132.0 (2026-08-03)
 
 Full Changelog: [v0.131.0...v0.132.0](https://github.com/lithic-com/lithic-java/compare/v0.131.0...v0.132.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.132.0)
-[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.132.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.132.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.133.0)
+[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.133.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.133.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.132.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.133.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.132.0")
+implementation("com.lithic.api:lithic-java:0.133.0")
 ```
 
 ### Maven
@@ -42,7 +42,7 @@ implementation("com.lithic.api:lithic-java:0.132.0")
 <dependency>
   <groupId>com.lithic.api</groupId>
   <artifactId>lithic-java</artifactId>
-  <version>0.132.0</version>
+  <version>0.133.0</version>
 </dependency>
 ```
 

build.gradle.kts

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

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

@@ -862,12 +862,15 @@ private constructor(
 
                 @JvmField val FINANCIAL_ACCOUNT = of("FINANCIAL_ACCOUNT")
 
+                @JvmField val PROGRAM = of("PROGRAM")
+
                 @JvmStatic fun of(value: String) = Scope(JsonField.of(value))
             }
 
             /** An enum containing [Scope]'s known values. */
             enum class Known {
-                FINANCIAL_ACCOUNT
+                FINANCIAL_ACCOUNT,
+                PROGRAM,
             }
 
             /**
@@ -881,6 +884,7 @@ private constructor(
              */
             enum class Value {
                 FINANCIAL_ACCOUNT,
+                PROGRAM,
                 /**
                  * An enum member indicating that [Scope] was instantiated with an unknown value.
                  */
@@ -897,6 +901,7 @@ private constructor(
             fun value(): Value =
                 when (this) {
                     FINANCIAL_ACCOUNT -> Value.FINANCIAL_ACCOUNT
+                    PROGRAM -> Value.PROGRAM
                     else -> Value._UNKNOWN
                 }
 
@@ -912,6 +917,7 @@ private constructor(
             fun known(): Known =
                 when (this) {
                     FINANCIAL_ACCOUNT -> Known.FINANCIAL_ACCOUNT
+                    PROGRAM -> Known.PROGRAM
                     else -> throw LithicInvalidDataException("Unknown Scope: $value")
                 }
 

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

@@ -434,7 +434,7 @@ private constructor(
     fun substatus(): Optional<NonPciCard.Substatus> = substatus.getOptional("substatus")
 
     /**
-     * Three digit cvv printed on the back of the card.
+     * Three or four digit CVV printed on the card. Amex cards use four digit CVVs
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -1241,7 +1241,7 @@ private constructor(
             this.substatus = substatus
         }
 
-        /** Three digit cvv printed on the back of the card. */
+        /** Three or four digit CVV printed on the card. Amex cards use four digit CVVs */
         fun cvv(cvv: String) = cvv(JsonField.of(cvv))
 
         /**

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

@@ -866,13 +866,16 @@ private constructor(
 
                 @JvmField val ACCOUNT = of("ACCOUNT")
 
+                @JvmField val PROGRAM = of("PROGRAM")
+
                 @JvmStatic fun of(value: String) = Scope(JsonField.of(value))
             }
 
             /** An enum containing [Scope]'s known values. */
             enum class Known {
                 CARD,
                 ACCOUNT,
+                PROGRAM,
             }
 
             /**
@@ -887,6 +890,7 @@ private constructor(
             enum class Value {
                 CARD,
                 ACCOUNT,
+                PROGRAM,
                 /**
                  * An enum member indicating that [Scope] was instantiated with an unknown value.
                  */
@@ -904,6 +908,7 @@ private constructor(
                 when (this) {
                     CARD -> Value.CARD
                     ACCOUNT -> Value.ACCOUNT
+                    PROGRAM -> Value.PROGRAM
                     else -> Value._UNKNOWN
                 }
 
@@ -920,6 +925,7 @@ private constructor(
                 when (this) {
                     CARD -> Known.CARD
                     ACCOUNT -> Known.ACCOUNT
+                    PROGRAM -> Known.PROGRAM
                     else -> throw LithicInvalidDataException("Unknown Scope: $value")
                 }
 

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

@@ -15,6 +15,7 @@ import com.lithic.api.core.checkRequired
 import com.lithic.api.errors.LithicInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /** The entity a case is associated with */
@@ -37,17 +38,21 @@ private constructor(
     ) : this(entityToken, entityType, mutableMapOf())
 
     /**
-     * Globally unique identifier for the associated entity
+     * Globally unique identifier for the associated entity: the card token for `CARD`, the account
+     * token for `ACCOUNT`, and the financial account token for `FINANCIAL_ACCOUNT`. Null for
+     * `PROGRAM`, which is not scoped to an individual entity
      *
-     * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
-     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
      */
-    fun entityToken(): String = entityToken.getRequired("entity_token")
+    fun entityToken(): Optional<String> = entityToken.getOptional("entity_token")
 
     /**
      * The type of entity a case is associated with:
      * - `CARD` - The case is associated with a card
      * - `ACCOUNT` - The case is associated with an account
+     * - `FINANCIAL_ACCOUNT` - The case is associated with a financial account
+     * - `PROGRAM` - The case is associated with the whole program
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -112,8 +117,15 @@ private constructor(
             additionalProperties = caseEntity.additionalProperties.toMutableMap()
         }
 
-        /** Globally unique identifier for the associated entity */
-        fun entityToken(entityToken: String) = entityToken(JsonField.of(entityToken))
+        /**
+         * Globally unique identifier for the associated entity: the card token for `CARD`, the
+         * account token for `ACCOUNT`, and the financial account token for `FINANCIAL_ACCOUNT`.
+         * Null for `PROGRAM`, which is not scoped to an individual entity
+         */
+        fun entityToken(entityToken: String?) = entityToken(JsonField.ofNullable(entityToken))
+
+        /** Alias for calling [Builder.entityToken] with `entityToken.orElse(null)`. */
+        fun entityToken(entityToken: Optional<String>) = entityToken(entityToken.getOrNull())
 
         /**
          * Sets [Builder.entityToken] to an arbitrary JSON value.
@@ -128,6 +140,8 @@ private constructor(
          * The type of entity a case is associated with:
          * - `CARD` - The case is associated with a card
          * - `ACCOUNT` - The case is associated with an account
+         * - `FINANCIAL_ACCOUNT` - The case is associated with a financial account
+         * - `PROGRAM` - The case is associated with the whole program
          */
         fun entityType(entityType: EntityType2) = entityType(JsonField.of(entityType))
 
@@ -222,6 +236,8 @@ private constructor(
      * The type of entity a case is associated with:
      * - `CARD` - The case is associated with a card
      * - `ACCOUNT` - The case is associated with an account
+     * - `FINANCIAL_ACCOUNT` - The case is associated with a financial account
+     * - `PROGRAM` - The case is associated with the whole program
      */
     class EntityType2 @JsonCreator private constructor(private val value: JsonField<String>) :
         Enum {
@@ -242,13 +258,19 @@ private constructor(
 
             @JvmField val ACCOUNT = of("ACCOUNT")
 
+            @JvmField val FINANCIAL_ACCOUNT = of("FINANCIAL_ACCOUNT")
+
+            @JvmField val PROGRAM = of("PROGRAM")
+
             @JvmStatic fun of(value: String) = EntityType2(JsonField.of(value))
         }
 
         /** An enum containing [EntityType2]'s known values. */
         enum class Known {
             CARD,
             ACCOUNT,
+            FINANCIAL_ACCOUNT,
+            PROGRAM,
         }
 
         /**
@@ -263,6 +285,8 @@ private constructor(
         enum class Value {
             CARD,
             ACCOUNT,
+            FINANCIAL_ACCOUNT,
+            PROGRAM,
             /**
              * An enum member indicating that [EntityType2] was instantiated with an unknown value.
              */
@@ -280,6 +304,8 @@ private constructor(
             when (this) {
                 CARD -> Value.CARD
                 ACCOUNT -> Value.ACCOUNT
+                FINANCIAL_ACCOUNT -> Value.FINANCIAL_ACCOUNT
+                PROGRAM -> Value.PROGRAM
                 else -> Value._UNKNOWN
             }
 
@@ -296,6 +322,8 @@ private constructor(
             when (this) {
                 CARD -> Known.CARD
                 ACCOUNT -> Known.ACCOUNT
+                FINANCIAL_ACCOUNT -> Known.FINANCIAL_ACCOUNT
+                PROGRAM -> Known.PROGRAM
                 else -> throw LithicInvalidDataException("Unknown EntityType2: $value")
             }