diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index df0c791..8e3d955 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.30.1"
+  ".": "0.31.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7f388d2..6ce07ee 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.31.0](https://github.com/meteroid-oss/meteroid-java/compare/v0.30.1...v0.31.0) (2026-10-28)
+
+
+### ⚠ BREAKING CHANGES
+
+* **api:** update SDKs to meteroid 0.1.0 ([#15](https://github.com/meteroid-oss/meteroid-java/issues/15))
+* **api:** `GET /api/v1/coupons`: added `#/components/schemas/CreditDiscount` to the `data/items/discount` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/coupons/{coupon_id}`: added `#/components/schemas/CreditDiscount` to the `discount` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/plans`: added `#/components/schemas/CreditPlanFee` to the `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/plans/{plan_id}`: added `#/components/schemas/CreditPlanFee` to the `price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/products`: added `#/components/schemas/CreditFeeStructure` to the `data/items/fee_structure` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/products/{product_id}`: added `#/components/schemas/CreditFeeStructure` to the `fee_structure` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditDiscount` to the `applied_coupons/items/coupon/discount` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditFee` to the `add_ons/items/fee` response property `oneOf` list for the response status `200`
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditFee` to the `components/items/fee` response property `oneOf` list for the response status `200`
+* **api:** `PATCH /api/v1/coupons/{coupon_id}`: added the new required request property `discount/oneOf[#/components/schemas/CouponDiscount]/oneOf[#/components/schemas/FixedDiscount]/type`
+* **api:** 90 more breaking changes
+
+### Features
+
+* **api:** `GET /api/v1/coupons/{coupon_id}`: added `#/components/schemas/CreditDiscount` to the `discount` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/coupons`: added `#/components/schemas/CreditDiscount` to the `data/items/discount` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/plans/{plan_id}`: added `#/components/schemas/CreditPlanFee` to the `price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/plans`: added `#/components/schemas/CreditPlanFee` to the `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/products/{product_id}`: added `#/components/schemas/CreditFeeStructure` to the `fee_structure` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/products`: added `#/components/schemas/CreditFeeStructure` to the `data/items/fee_structure` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditDiscount` to the `applied_coupons/items/coupon/discount` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditFee` to the `add_ons/items/fee` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `GET /api/v1/subscriptions/{subscription_id}`: added `#/components/schemas/CreditFee` to the `components/items/fee` response property `oneOf` list for the response status `200` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** `PATCH /api/v1/coupons/{coupon_id}`: added the new required request property `discount/oneOf[#/components/schemas/CouponDiscount]/oneOf[#/components/schemas/FixedDiscount]/type` ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** 90 more breaking changes ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** update SDKs to meteroid 0.1.0 ([#15](https://github.com/meteroid-oss/meteroid-java/issues/15)) ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+* **api:** update the API definitions ([85c2348](https://github.com/meteroid-oss/meteroid-java/commit/85c23480c8ea2b9cacc74d0ab91ad5046035945a))
+
 ## [0.30.1](https://github.com/meteroid-oss/meteroid-java/compare/v0.30.0...v0.30.1) (2026-10-16)
 
 
diff --git a/README.md b/README.md
index 86256ec..b9b3bf4 100644
--- a/README.md
+++ b/README.md
@@ -6,14 +6,14 @@ The official Java SDK for [Meteroid](https://meteroid.com), the open-source bill
 
 <!-- x-release-please-start-version -->
 ```kotlin
-implementation("com.meteroid:meteroid:0.30.1")
+implementation("com.meteroid:meteroid:0.31.0")
 ```
 
 ```xml
 <dependency>
   <groupId>com.meteroid</groupId>
   <artifactId>meteroid</artifactId>
-  <version>0.30.1</version>
+  <version>0.31.0</version>
 </dependency>
 ```
 <!-- x-release-please-end -->
diff --git a/gradle.properties b/gradle.properties
index 5abf075..13d5431 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -1,7 +1,7 @@
 GROUP=com.meteroid
 POM_ARTIFACT_ID=meteroid
 # x-release-please-start-version
-VERSION_NAME=0.30.1
+VERSION_NAME=0.31.0
 # x-release-please-end
 POM_NAME=Meteroid
 POM_DESCRIPTION=Official Java SDK for Meteroid, the open-source billing platform: subscriptions, invoicing, usage-based billing and webhooks.
diff --git a/src/main/java/com/meteroid/Version.java b/src/main/java/com/meteroid/Version.java
index 7315ea4..70a2ac2 100644
--- a/src/main/java/com/meteroid/Version.java
+++ b/src/main/java/com/meteroid/Version.java
@@ -5,5 +5,5 @@ public final class Version {
     private Version() {}
 
     /** The version, sent in the {@code User-Agent} header. */
-    public static final String VERSION = "0.30.1"; // x-release-please-version
+    public static final String VERSION = "0.31.0"; // x-release-please-version
 }