diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 7a0ae8af..34f6b414 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.14.1"
+  ".": "4.15.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index f4571777..43e82626 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-d63c8075b48441663736b457f8ad859c58cc3e31dfbffb68db44c3f00562012c.yml
-openapi_spec_hash: c47dbff685a0a449bfc1ad729c13a72e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-2c9291de1fd876908ebe56144e90762ab6e390e3f25102da815ab3fca6335d38.yml
+openapi_spec_hash: eabe2d8e58ceed1d61d41fe7a44020ca
 config_hash: 1f73a949b649ecfe6ec68ba1bb459dc2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3157e497..18e19308 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.15.0 (2025-09-10)
+
+Full Changelog: [v4.14.1...v4.15.0](https://github.com/orbcorp/orb-python/compare/v4.14.1...v4.15.0)
+
+### Features
+
+* **api:** api update ([270f79a](https://github.com/orbcorp/orb-python/commit/270f79ae44146a76b1589eeecd0b0da6cc3e5117))
+
 ## 4.14.1 (2025-09-08)
 
 Full Changelog: [v4.14.0...v4.14.1](https://github.com/orbcorp/orb-python/compare/v4.14.0...v4.14.1)
diff --git a/pyproject.toml b/pyproject.toml
index 82f964ef..ee2ea148 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "orb-billing"
-version = "4.14.1"
+version = "4.15.0"
 description = "The official Python library for the orb API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/orb/_version.py b/src/orb/_version.py
index 5abbf098..b043e17c 100644
--- a/src/orb/_version.py
+++ b/src/orb/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "orb"
-__version__ = "4.14.1"  # x-release-please-version
+__version__ = "4.15.0"  # x-release-please-version
diff --git a/src/orb/types/new_subscription_tiered_package_price_param.py b/src/orb/types/new_subscription_tiered_package_price_param.py
index 8e83b798..f217a5e5 100644
--- a/src/orb/types/new_subscription_tiered_package_price_param.py
+++ b/src/orb/types/new_subscription_tiered_package_price_param.py
@@ -33,7 +33,9 @@ class TieredPackageConfig(TypedDict, total=False):
     tiers: Required[Iterable[TieredPackageConfigTier]]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/price_create_params.py b/src/orb/types/price_create_params.py
index 7b7d502f..fc68c12b 100644
--- a/src/orb/types/price_create_params.py
+++ b/src/orb/types/price_create_params.py
@@ -672,7 +672,9 @@ class NewFloatingTieredPackagePriceTieredPackageConfig(TypedDict, total=False):
     tiers: Required[Iterable[NewFloatingTieredPackagePriceTieredPackageConfigTier]]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/shared/new_floating_tiered_package_price.py b/src/orb/types/shared/new_floating_tiered_package_price.py
index 2786b84c..1a216ccb 100644
--- a/src/orb/types/shared/new_floating_tiered_package_price.py
+++ b/src/orb/types/shared/new_floating_tiered_package_price.py
@@ -30,7 +30,9 @@ class TieredPackageConfig(BaseModel):
     tiers: List[TieredPackageConfigTier]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/shared/new_plan_tiered_package_price.py b/src/orb/types/shared/new_plan_tiered_package_price.py
index cc652ad3..4bfebae2 100644
--- a/src/orb/types/shared/new_plan_tiered_package_price.py
+++ b/src/orb/types/shared/new_plan_tiered_package_price.py
@@ -30,7 +30,9 @@ class TieredPackageConfig(BaseModel):
     tiers: List[TieredPackageConfigTier]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/shared/price.py b/src/orb/types/shared/price.py
index d8fe20a9..73a0b4a0 100644
--- a/src/orb/types/shared/price.py
+++ b/src/orb/types/shared/price.py
@@ -598,7 +598,9 @@ class TieredPackagePriceTieredPackageConfig(BaseModel):
     tiers: List[TieredPackagePriceTieredPackageConfigTier]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/shared_params/new_floating_tiered_package_price.py b/src/orb/types/shared_params/new_floating_tiered_package_price.py
index ab0f71da..9ee2dc6e 100644
--- a/src/orb/types/shared_params/new_floating_tiered_package_price.py
+++ b/src/orb/types/shared_params/new_floating_tiered_package_price.py
@@ -28,7 +28,9 @@ class TieredPackageConfig(TypedDict, total=False):
     tiers: Required[Iterable[TieredPackageConfigTier]]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """
 
 
diff --git a/src/orb/types/shared_params/new_plan_tiered_package_price.py b/src/orb/types/shared_params/new_plan_tiered_package_price.py
index 714812d0..72696ec5 100644
--- a/src/orb/types/shared_params/new_plan_tiered_package_price.py
+++ b/src/orb/types/shared_params/new_plan_tiered_package_price.py
@@ -28,7 +28,9 @@ class TieredPackageConfig(TypedDict, total=False):
     tiers: Required[Iterable[TieredPackageConfigTier]]
     """Apply tiered pricing after rounding up the quantity to the package size.
 
-    Tiers are defined using exclusive lower bounds.
+    Tiers are defined using exclusive lower bounds. The tier bounds are defined
+    based on the total quantity rather than the number of packages, so they must be
+    multiples of the package size.
     """