diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index ce7418761..da9608d70 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.319.0"
+  ".": "0.320.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index 8b661a7b8..dc28c5ae5 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 217
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-438f2a4d4f35670ae5692a6a9a36711af7944ac975bf309a6d50c02a28b13a70.yml
-openapi_spec_hash: e4930cc26be238707449872070607e64
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-5d85239e5d724254ab22d922c6cad05e1c361c791ef4a578e1165158bd967753.yml
+openapi_spec_hash: b2c90485c02d643ad09954f4d88dbc25
 config_hash: e1885b38eded054b77308a024c5d80cc
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9bc1906bd..7127dc7a1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.320.0 (2025-09-08)
+
+Full Changelog: [v0.319.0...v0.320.0](https://github.com/Increase/increase-java/compare/v0.319.0...v0.320.0)
+
+### Features
+
+* **api:** api update ([a4c16b7](https://github.com/Increase/increase-java/commit/a4c16b71b2a8088fbb0797e655027e1f6499153a))
+
 ## 0.319.0 (2025-09-08)
 
 Full Changelog: [v0.318.0...v0.319.0](https://github.com/Increase/increase-java/compare/v0.318.0...v0.319.0)
diff --git a/README.md b/README.md
index 0254c1747..35213648a 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.319.0)
-[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.319.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.319.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.320.0)
+[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.320.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.320.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.319.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.320.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.319.0")
+implementation("com.increase.api:increase-java:0.320.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.increase.api:increase-java:0.319.0")
 <dependency>
   <groupId>com.increase.api</groupId>
   <artifactId>increase-java</artifactId>
-  <version>0.319.0</version>
+  <version>0.320.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 5761b3680..26153526c 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.increase.api"
-    version = "0.319.0" // x-release-please-version
+    version = "0.320.0" // x-release-please-version
 }
 
 subprojects {
diff --git a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
index 51919dc59..d87bc1d81 100644
--- a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
+++ b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
@@ -224,8 +224,8 @@ private constructor(
         supplementalDocuments.getRequired("supplemental_documents")
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      *
      * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -708,8 +708,8 @@ private constructor(
         }
 
         /**
-         * A reference to data stored in a third-party verification service. Your integration may or
-         * may not use this field.
+         * If you are using a third-party service for identity verification, you can use this field
+         * to associate this Entity with the identifier that represents them in that service.
          */
         fun thirdPartyVerification(thirdPartyVerification: ThirdPartyVerification?) =
             thirdPartyVerification(JsonField.ofNullable(thirdPartyVerification))
@@ -6775,13 +6775,13 @@ private constructor(
 
             companion object {
 
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 @JvmField val LOW = of("low")
 
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 @JvmField val MEDIUM = of("medium")
 
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 @JvmField val HIGH = of("high")
 
                 @JvmStatic fun of(value: String) = Rating(JsonField.of(value))
@@ -6789,11 +6789,11 @@ private constructor(
 
             /** An enum containing [Rating]'s known values. */
             enum class Known {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
             }
 
@@ -6807,11 +6807,11 @@ private constructor(
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
                 /**
                  * An enum member indicating that [Rating] was instantiated with an unknown value.
@@ -7231,8 +7231,8 @@ private constructor(
     }
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      */
     class ThirdPartyVerification
     private constructor(
diff --git a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityCreateParams.kt b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityCreateParams.kt
index cdd9ae0de..f3e896036 100644
--- a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityCreateParams.kt
+++ b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityCreateParams.kt
@@ -103,8 +103,8 @@ private constructor(
     fun supplementalDocuments(): Optional<List<SupplementalDocument>> = body.supplementalDocuments()
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      *
      * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -379,8 +379,8 @@ private constructor(
         }
 
         /**
-         * A reference to data stored in a third-party verification service. Your integration may or
-         * may not use this field.
+         * If you are using a third-party service for identity verification, you can use this field
+         * to associate this Entity with the identifier that represents them in that service.
          */
         fun thirdPartyVerification(thirdPartyVerification: ThirdPartyVerification) = apply {
             body.thirdPartyVerification(thirdPartyVerification)
@@ -682,8 +682,8 @@ private constructor(
             supplementalDocuments.getOptional("supplemental_documents")
 
         /**
-         * A reference to data stored in a third-party verification service. Your integration may or
-         * may not use this field.
+         * If you are using a third-party service for identity verification, you can use this field
+         * to associate this Entity with the identifier that represents them in that service.
          *
          * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -986,8 +986,9 @@ private constructor(
             }
 
             /**
-             * A reference to data stored in a third-party verification service. Your integration
-             * may or may not use this field.
+             * If you are using a third-party service for identity verification, you can use this
+             * field to associate this Entity with the identifier that represents them in that
+             * service.
              */
             fun thirdPartyVerification(thirdPartyVerification: ThirdPartyVerification) =
                 thirdPartyVerification(JsonField.of(thirdPartyVerification))
@@ -10721,13 +10722,13 @@ private constructor(
 
             companion object {
 
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 @JvmField val LOW = of("low")
 
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 @JvmField val MEDIUM = of("medium")
 
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 @JvmField val HIGH = of("high")
 
                 @JvmStatic fun of(value: String) = Rating(JsonField.of(value))
@@ -10735,11 +10736,11 @@ private constructor(
 
             /** An enum containing [Rating]'s known values. */
             enum class Known {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
             }
 
@@ -10753,11 +10754,11 @@ private constructor(
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
                 /**
                  * An enum member indicating that [Rating] was instantiated with an unknown value.
@@ -11029,8 +11030,8 @@ private constructor(
     }
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      */
     class ThirdPartyVerification
     private constructor(
diff --git a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityUpdateParams.kt b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityUpdateParams.kt
index dc435efce..d377c6cf0 100644
--- a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityUpdateParams.kt
+++ b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/EntityUpdateParams.kt
@@ -71,8 +71,8 @@ private constructor(
     fun riskRating(): Optional<RiskRating> = body.riskRating()
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      *
      * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -258,8 +258,8 @@ private constructor(
         fun riskRating(riskRating: JsonField<RiskRating>) = apply { body.riskRating(riskRating) }
 
         /**
-         * A reference to data stored in a third-party verification service. Your integration may or
-         * may not use this field.
+         * If you are using a third-party service for identity verification, you can use this field
+         * to associate this Entity with the identifier that represents them in that service.
          */
         fun thirdPartyVerification(thirdPartyVerification: ThirdPartyVerification) = apply {
             body.thirdPartyVerification(thirdPartyVerification)
@@ -511,8 +511,8 @@ private constructor(
         fun riskRating(): Optional<RiskRating> = riskRating.getOptional("risk_rating")
 
         /**
-         * A reference to data stored in a third-party verification service. Your integration may or
-         * may not use this field.
+         * If you are using a third-party service for identity verification, you can use this field
+         * to associate this Entity with the identifier that represents them in that service.
          *
          * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -695,8 +695,9 @@ private constructor(
             }
 
             /**
-             * A reference to data stored in a third-party verification service. Your integration
-             * may or may not use this field.
+             * If you are using a third-party service for identity verification, you can use this
+             * field to associate this Entity with the identifier that represents them in that
+             * service.
              */
             fun thirdPartyVerification(thirdPartyVerification: ThirdPartyVerification) =
                 thirdPartyVerification(JsonField.of(thirdPartyVerification))
@@ -2616,13 +2617,13 @@ private constructor(
 
             companion object {
 
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 @JvmField val LOW = of("low")
 
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 @JvmField val MEDIUM = of("medium")
 
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 @JvmField val HIGH = of("high")
 
                 @JvmStatic fun of(value: String) = Rating(JsonField.of(value))
@@ -2630,11 +2631,11 @@ private constructor(
 
             /** An enum containing [Rating]'s known values. */
             enum class Known {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
             }
 
@@ -2648,11 +2649,11 @@ private constructor(
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                /** Low */
+                /** Minimal risk of involvement in financial crime. */
                 LOW,
-                /** Medium */
+                /** Moderate risk of involvement in financial crime. */
                 MEDIUM,
-                /** High */
+                /** Elevated risk of involvement in financial crime. */
                 HIGH,
                 /**
                  * An enum member indicating that [Rating] was instantiated with an unknown value.
@@ -2766,8 +2767,8 @@ private constructor(
     }
 
     /**
-     * A reference to data stored in a third-party verification service. Your integration may or may
-     * not use this field.
+     * If you are using a third-party service for identity verification, you can use this field to
+     * associate this Entity with the identifier that represents them in that service.
      */
     class ThirdPartyVerification
     private constructor(