release: 0.125.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.124.0"
+  ".": "0.125.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 191
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-d29b68bb85936070878d8badaa8a7c5991313285e70a990bc812c838eba85373.yml
-openapi_spec_hash: 54b44da68df22eb0ea99f2bc564667a2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-ab626b78e088455e814b80debc85d420839bc11f95416491fef6a0460f2d95ed.yml
+openapi_spec_hash: f6ae1bbed371a5d45927cd63797a9908
 config_hash: ac8326134e692f3f3bdec82396bbec80

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.125.0 (2026-04-24)
+
+Full Changelog: [v0.124.0...v0.125.0](https://github.com/lithic-com/lithic-java/compare/v0.124.0...v0.125.0)
+
+### Features
+
+* **api:** add AMEX to Network enum in settlement params and models ([638084a](https://github.com/lithic-com/lithic-java/commit/638084a329e3e2da55a350e950f6752e185b5ae4))
+
+
+### Bug Fixes
+
+* **types:** add EMPTY exemption type, make fields optional in Account/Card/NonPciCard ([2a2a00a](https://github.com/lithic-com/lithic-java/commit/2a2a00acc9cd3a92991a7ae50b6e02cdebaa930d))
+
 ## 0.124.0 (2026-04-20)
 
 Full Changelog: [v0.123.0...v0.124.0](https://github.com/lithic-com/lithic-java/compare/v0.123.0...v0.124.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.124.0)
-[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.124.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.124.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.125.0)
+[![javadoc](https://javadoc.io/badge2/com.lithic.api/lithic-java/0.125.0/javadoc.svg)](https://javadoc.io/doc/com.lithic.api/lithic-java/0.125.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.124.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.125.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.124.0")
+implementation("com.lithic.api:lithic-java:0.125.0")
 ```
 
 ### Maven
@@ -42,7 +42,7 @@ implementation("com.lithic.api:lithic-java:0.124.0")
 <dependency>
   <groupId>com.lithic.api</groupId>
   <artifactId>lithic-java</artifactId>
-  <version>0.124.0</version>
+  <version>0.125.0</version>
 </dependency>
 ```
 

build.gradle.kts

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

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

@@ -504,7 +504,10 @@ private constructor(
          * * `OTHER` - The reason for the account's current status does not fall into any of the
          *   above categories. A comment should be provided to specify the particular reason.
          */
-        fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.

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

@@ -209,7 +209,7 @@ private constructor(
     fun email(): Optional<String> = email.getOptional("email")
 
     /**
-     * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder is
+     * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder is
      * not KYC-Exempt.
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -733,10 +733,15 @@ private constructor(
         fun email(email: JsonField<String>) = apply { this.email = email }
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          */
-        fun exemptionType(exemptionType: ExemptionType) = exemptionType(JsonField.of(exemptionType))
+        fun exemptionType(exemptionType: ExemptionType?) =
+            exemptionType(JsonField.ofNullable(exemptionType))
+
+        /** Alias for calling [Builder.exemptionType] with `exemptionType.orElse(null)`. */
+        fun exemptionType(exemptionType: Optional<ExemptionType>) =
+            exemptionType(exemptionType.getOrNull())
 
         /**
          * Sets [Builder.exemptionType] to an arbitrary JSON value.
@@ -1871,7 +1876,7 @@ private constructor(
     }
 
     /**
-     * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder is
+     * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder is
      * not KYC-Exempt.
      */
     class ExemptionType @JsonCreator private constructor(private val value: JsonField<String>) :

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

@@ -402,7 +402,7 @@ private constructor(
         fun email(): Optional<String> = email.getOptional("email")
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -927,7 +927,7 @@ private constructor(
             fun email(email: JsonField<String>) = apply { this.email = email }
 
             /**
-             * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account
+             * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account
              * holder is not KYC-Exempt.
              */
             fun exemptionType(exemptionType: ExemptionType) =
@@ -2098,7 +2098,7 @@ private constructor(
         }
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          */
         class ExemptionType @JsonCreator private constructor(private val value: JsonField<String>) :

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

@@ -337,7 +337,10 @@ private constructor(
          * * `OTHER` - The reason for the account's current status does not fall into any of the
          *   above categories. A comment should be provided to specify the particular reason.
          */
-        fun substatus(substatus: Substatus) = apply { body.substatus(substatus) }
+        fun substatus(substatus: Substatus?) = apply { body.substatus(substatus) }
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -864,7 +867,10 @@ private constructor(
              * * `OTHER` - The reason for the account's current status does not fall into any of the
              *   above categories. A comment should be provided to specify the particular reason.
              */
-            fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+            fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+            /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+            fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
             /**
              * Sets [Builder.substatus] to an arbitrary JSON value.

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

@@ -206,12 +206,12 @@ private constructor(
     fun created(): OffsetDateTime = created.getRequired("created")
 
     /**
-     * Deprecated: Funding account for the card.
+     * Funding account for a card
      *
-     * @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 funding(): NonPciCard.FundingAccount = funding.getRequired("funding")
+    fun funding(): Optional<NonPciCard.FundingAccount> = funding.getOptional("funding")
 
     /**
      * Last four digits of the card number.
@@ -822,8 +822,11 @@ private constructor(
          */
         fun created(created: JsonField<OffsetDateTime>) = apply { this.created = created }
 
-        /** Deprecated: Funding account for the card. */
-        fun funding(funding: NonPciCard.FundingAccount) = funding(JsonField.of(funding))
+        /** Funding account for a card */
+        fun funding(funding: NonPciCard.FundingAccount?) = funding(JsonField.ofNullable(funding))
+
+        /** Alias for calling [Builder.funding] with `funding.orElse(null)`. */
+        fun funding(funding: Optional<NonPciCard.FundingAccount>) = funding(funding.getOrNull())
 
         /**
          * Sets [Builder.funding] to an arbitrary JSON value.
@@ -1040,8 +1043,14 @@ private constructor(
          * tokenization. This artwork must be approved by Mastercard and configured by Lithic to
          * use.
          */
-        fun digitalCardArtToken(digitalCardArtToken: String) =
-            digitalCardArtToken(JsonField.of(digitalCardArtToken))
+        fun digitalCardArtToken(digitalCardArtToken: String?) =
+            digitalCardArtToken(JsonField.ofNullable(digitalCardArtToken))
+
+        /**
+         * Alias for calling [Builder.digitalCardArtToken] with `digitalCardArtToken.orElse(null)`.
+         */
+        fun digitalCardArtToken(digitalCardArtToken: Optional<String>) =
+            digitalCardArtToken(digitalCardArtToken.getOrNull())
 
         /**
          * Sets [Builder.digitalCardArtToken] to an arbitrary JSON value.
@@ -1159,7 +1168,10 @@ private constructor(
          * use. Specifies the configuration (i.e., physical card art) that the card should be
          * manufactured with.
          */
-        fun productId(productId: String) = productId(JsonField.of(productId))
+        fun productId(productId: String?) = productId(JsonField.ofNullable(productId))
+
+        /** Alias for calling [Builder.productId] with `productId.orElse(null)`. */
+        fun productId(productId: Optional<String>) = productId(productId.getOrNull())
 
         /**
          * Sets [Builder.productId] to an arbitrary JSON value.
@@ -1212,7 +1224,10 @@ private constructor(
          * has been returned. * `OTHER` - The reason for the status does not fall into any of the
          * above categories. A comment can be provided to specify the reason.
          */
-        fun substatus(substatus: NonPciCard.Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: NonPciCard.Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<NonPciCard.Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -1336,7 +1351,7 @@ private constructor(
         accountToken()
         cardProgramToken()
         created()
-        funding().validate()
+        funding().ifPresent { it.validate() }
         lastFour()
         pinStatus().validate()
         spendLimit()

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

@@ -170,12 +170,12 @@ private constructor(
     fun created(): OffsetDateTime = created.getRequired("created")
 
     /**
-     * Deprecated: Funding account for the card.
+     * Funding account for a card
      *
-     * @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 funding(): FundingAccount = funding.getRequired("funding")
+    fun funding(): Optional<FundingAccount> = funding.getOptional("funding")
 
     /**
      * Last four digits of the card number.
@@ -745,8 +745,11 @@ private constructor(
          */
         fun created(created: JsonField<OffsetDateTime>) = apply { this.created = created }
 
-        /** Deprecated: Funding account for the card. */
-        fun funding(funding: FundingAccount) = funding(JsonField.of(funding))
+        /** Funding account for a card */
+        fun funding(funding: FundingAccount?) = funding(JsonField.ofNullable(funding))
+
+        /** Alias for calling [Builder.funding] with `funding.orElse(null)`. */
+        fun funding(funding: Optional<FundingAccount>) = funding(funding.getOrNull())
 
         /**
          * Sets [Builder.funding] to an arbitrary JSON value.
@@ -957,8 +960,14 @@ private constructor(
          * tokenization. This artwork must be approved by Mastercard and configured by Lithic to
          * use.
          */
-        fun digitalCardArtToken(digitalCardArtToken: String) =
-            digitalCardArtToken(JsonField.of(digitalCardArtToken))
+        fun digitalCardArtToken(digitalCardArtToken: String?) =
+            digitalCardArtToken(JsonField.ofNullable(digitalCardArtToken))
+
+        /**
+         * Alias for calling [Builder.digitalCardArtToken] with `digitalCardArtToken.orElse(null)`.
+         */
+        fun digitalCardArtToken(digitalCardArtToken: Optional<String>) =
+            digitalCardArtToken(digitalCardArtToken.getOrNull())
 
         /**
          * Sets [Builder.digitalCardArtToken] to an arbitrary JSON value.
@@ -1076,7 +1085,10 @@ private constructor(
          * use. Specifies the configuration (i.e., physical card art) that the card should be
          * manufactured with.
          */
-        fun productId(productId: String) = productId(JsonField.of(productId))
+        fun productId(productId: String?) = productId(JsonField.ofNullable(productId))
+
+        /** Alias for calling [Builder.productId] with `productId.orElse(null)`. */
+        fun productId(productId: Optional<String>) = productId(productId.getOrNull())
 
         /**
          * Sets [Builder.productId] to an arbitrary JSON value.
@@ -1129,7 +1141,10 @@ private constructor(
          * has been returned. * `OTHER` - The reason for the status does not fall into any of the
          * above categories. A comment can be provided to specify the reason.
          */
-        fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -1223,7 +1238,7 @@ private constructor(
         accountToken()
         cardProgramToken()
         created()
-        funding().validate()
+        funding().ifPresent { it.validate() }
         lastFour()
         pinStatus().validate()
         spendLimit()
@@ -1288,7 +1303,7 @@ private constructor(
             (if (replacementFor.asKnown().isPresent) 1 else 0) +
             (substatus.asKnown().getOrNull()?.validity() ?: 0)
 
-    /** Deprecated: Funding account for the card. */
+    /** Funding account for a card */
     class FundingAccount
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
@@ -1574,7 +1589,10 @@ private constructor(
             }
 
             /** The nickname given to the `FundingAccount` or `null` if it has no nickname. */
-            fun nickname(nickname: String) = nickname(JsonField.of(nickname))
+            fun nickname(nickname: String?) = nickname(JsonField.ofNullable(nickname))
+
+            /** Alias for calling [Builder.nickname] with `nickname.orElse(null)`. */
+            fun nickname(nickname: Optional<String>) = nickname(nickname.getOrNull())
 
             /**
              * Sets [Builder.nickname] to an arbitrary JSON value.