diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 705b0cb27..045a06e9d 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.339.0"
+  ".": "0.340.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index d034046d8..7badc572d 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-c51555226fd66ed304eb1e9c759a6485c071eb2cb9ca9ee86f5b5cd88552ee4a.yml
-openapi_spec_hash: c5b09ec531c068cb675f8cd3729733c6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-911c3719c8d84e1119e71e0cf93ae1f2c52f42529e56671731f07273feb5ac88.yml
+openapi_spec_hash: 462c4c10440c2f87e0624d8c25a89b75
 config_hash: a143293c5450ae8f52acad08f3102575
diff --git a/CHANGELOG.md b/CHANGELOG.md
index dbab610de..8b3afd1cd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.340.0 (2025-09-26)
+
+Full Changelog: [v0.339.0...v0.340.0](https://github.com/Increase/increase-java/compare/v0.339.0...v0.340.0)
+
+### Features
+
+* **api:** api update ([bd6cd53](https://github.com/Increase/increase-java/commit/bd6cd538a7cdd21bd8446096a02f54a1db552034))
+
 ## 0.339.0 (2025-09-26)
 
 Full Changelog: [v0.338.0...v0.339.0](https://github.com/Increase/increase-java/compare/v0.338.0...v0.339.0)
diff --git a/README.md b/README.md
index 295ffe620..95fcac810 100644
--- 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.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.339.0)
-[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.339.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.339.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.340.0)
+[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.340.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.340.0)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ The Increase Java SDK is similar to the Increase Kotlin SDK but with minor diffe
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.339.0).
+The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.340.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/d
 ### Gradle
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.339.0")
+implementation("com.increase.api:increase-java:0.340.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.increase.api:increase-java:0.339.0")
 <dependency>
   <groupId>com.increase.api</groupId>
   <artifactId>increase-java</artifactId>
-  <version>0.339.0</version>
+  <version>0.340.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 25d8eb94a..6c0252329 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.increase.api"
-    version = "0.339.0" // x-release-please-version
+    version = "0.340.0" // x-release-please-version
 }
 
 subprojects {
diff --git a/increase-java-core/src/main/kotlin/com/increase/api/models/physicalcards/PhysicalCard.kt b/increase-java-core/src/main/kotlin/com/increase/api/models/physicalcards/PhysicalCard.kt
index df9256255..43a64cade 100644
--- a/increase-java-core/src/main/kotlin/com/increase/api/models/physicalcards/PhysicalCard.kt
+++ b/increase-java-core/src/main/kotlin/com/increase/api/models/physicalcards/PhysicalCard.kt
@@ -2051,13 +2051,12 @@ private constructor(
             ) : this(number, returnNumber, returnReason, shippedAt, updates, mutableMapOf())
 
             /**
-             * The tracking number.
+             * The tracking number. Not available for USPS shipments.
              *
-             * @throws IncreaseInvalidDataException 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 IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
+             *   if the server responded with an unexpected value).
              */
-            fun number(): String = number.getRequired("number")
+            fun number(): Optional<String> = number.getOptional("number")
 
             /**
              * For returned shipments, the tracking number of the return shipment.
@@ -2189,8 +2188,11 @@ private constructor(
                     additionalProperties = tracking.additionalProperties.toMutableMap()
                 }
 
-                /** The tracking number. */
-                fun number(number: String) = number(JsonField.of(number))
+                /** The tracking number. Not available for USPS shipments. */
+                fun number(number: String?) = number(JsonField.ofNullable(number))
+
+                /** Alias for calling [Builder.number] with `number.orElse(null)`. */
+                fun number(number: Optional<String>) = number(number.getOrNull())
 
                 /**
                  * Sets [Builder.number] to an arbitrary JSON value.