diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index ea3479b..3f47f4b 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.47.2"
+  ".": "1.48.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index f7ecd1a..3622109 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-7936e3f73bbe1d59d27fd7a8a226985927b38fdec1c936c77577381699fb6140.yml
-openapi_spec_hash: 1d3f9ed5fbdb0e40d56d6acd9d1736e2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-03af7f658aed245cf7e230055de59fe92a78880f3719bf254ed9352bf89bad5e.yml
+openapi_spec_hash: c4703d217c25e8c02c248caed9e2d3be
 config_hash: 895e36fb2d717958770fd4cf883f4b74
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c8fa644..91863a3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.48.0 (2025-12-06)
+
+Full Changelog: [v1.47.2...v1.48.0](https://github.com/orbcorp/orb-go/compare/v1.47.2...v1.48.0)
+
+### Features
+
+* **api:** api update ([f2ecc03](https://github.com/orbcorp/orb-go/commit/f2ecc038b030e3143b3d7bd3a8cbd9bc53c09ca0))
+
 ## 1.47.2 (2025-12-05)
 
 Full Changelog: [v1.47.1...v1.47.2](https://github.com/orbcorp/orb-go/compare/v1.47.1...v1.47.2)
diff --git a/README.md b/README.md
index 266bb6c..b137de0 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/orbcorp/orb-go@v1.47.2'
+go get -u 'github.com/orbcorp/orb-go@v1.48.0'
 ```
 
 <!-- x-release-please-end -->
diff --git a/internal/version.go b/internal/version.go
index 2e20c5f..852670e 100644
--- a/internal/version.go
+++ b/internal/version.go
@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "1.47.2" // x-release-please-version
+const PackageVersion = "1.48.0" // x-release-please-version
diff --git a/subscriptionchange.go b/subscriptionchange.go
index de8d11e..f82fd7d 100644
--- a/subscriptionchange.go
+++ b/subscriptionchange.go
@@ -357,28 +357,44 @@ func (r MutatedSubscriptionStatus) IsKnown() bool {
 // `subscription.changed_resources`).
 type SubscriptionChangeGetResponse struct {
 	ID string `json:"id,required"`
+	// The type of change (e.g., 'schedule_plan_change', 'create_subscription').
+	ChangeType string `json:"change_type,required"`
 	// Subscription change will be cancelled at this time and can no longer be applied.
 	ExpirationTime time.Time                           `json:"expiration_time,required" format:"date-time"`
 	Status         SubscriptionChangeGetResponseStatus `json:"status,required"`
 	Subscription   MutatedSubscription                 `json:"subscription,required,nullable"`
 	// When this change was applied.
 	AppliedAt time.Time `json:"applied_at,nullable" format:"date-time"`
+	// Billing cycle alignment for plan changes.
+	BillingCycleAlignment string `json:"billing_cycle_alignment,nullable"`
 	// When this change was cancelled.
-	CancelledAt time.Time                         `json:"cancelled_at,nullable" format:"date-time"`
-	JSON        subscriptionChangeGetResponseJSON `json:"-"`
+	CancelledAt time.Time `json:"cancelled_at,nullable" format:"date-time"`
+	// How the change is scheduled (e.g., 'immediate', 'end_of_subscription_term',
+	// 'requested_date').
+	ChangeOption string `json:"change_option,nullable"`
+	// When this change will take effect.
+	EffectiveDate time.Time `json:"effective_date,nullable" format:"date-time"`
+	// The target plan ID for plan changes.
+	PlanID string                            `json:"plan_id,nullable"`
+	JSON   subscriptionChangeGetResponseJSON `json:"-"`
 }
 
 // subscriptionChangeGetResponseJSON contains the JSON metadata for the struct
 // [SubscriptionChangeGetResponse]
 type subscriptionChangeGetResponseJSON struct {
-	ID             apijson.Field
-	ExpirationTime apijson.Field
-	Status         apijson.Field
-	Subscription   apijson.Field
-	AppliedAt      apijson.Field
-	CancelledAt    apijson.Field
-	raw            string
-	ExtraFields    map[string]apijson.Field
+	ID                    apijson.Field
+	ChangeType            apijson.Field
+	ExpirationTime        apijson.Field
+	Status                apijson.Field
+	Subscription          apijson.Field
+	AppliedAt             apijson.Field
+	BillingCycleAlignment apijson.Field
+	CancelledAt           apijson.Field
+	ChangeOption          apijson.Field
+	EffectiveDate         apijson.Field
+	PlanID                apijson.Field
+	raw                   string
+	ExtraFields           map[string]apijson.Field
 }
 
 func (r *SubscriptionChangeGetResponse) UnmarshalJSON(data []byte) (err error) {
@@ -411,28 +427,44 @@ func (r SubscriptionChangeGetResponseStatus) IsKnown() bool {
 // `subscription.changed_resources`).
 type SubscriptionChangeApplyResponse struct {
 	ID string `json:"id,required"`
+	// The type of change (e.g., 'schedule_plan_change', 'create_subscription').
+	ChangeType string `json:"change_type,required"`
 	// Subscription change will be cancelled at this time and can no longer be applied.
 	ExpirationTime time.Time                             `json:"expiration_time,required" format:"date-time"`
 	Status         SubscriptionChangeApplyResponseStatus `json:"status,required"`
 	Subscription   MutatedSubscription                   `json:"subscription,required,nullable"`
 	// When this change was applied.
 	AppliedAt time.Time `json:"applied_at,nullable" format:"date-time"`
+	// Billing cycle alignment for plan changes.
+	BillingCycleAlignment string `json:"billing_cycle_alignment,nullable"`
 	// When this change was cancelled.
-	CancelledAt time.Time                           `json:"cancelled_at,nullable" format:"date-time"`
-	JSON        subscriptionChangeApplyResponseJSON `json:"-"`
+	CancelledAt time.Time `json:"cancelled_at,nullable" format:"date-time"`
+	// How the change is scheduled (e.g., 'immediate', 'end_of_subscription_term',
+	// 'requested_date').
+	ChangeOption string `json:"change_option,nullable"`
+	// When this change will take effect.
+	EffectiveDate time.Time `json:"effective_date,nullable" format:"date-time"`
+	// The target plan ID for plan changes.
+	PlanID string                              `json:"plan_id,nullable"`
+	JSON   subscriptionChangeApplyResponseJSON `json:"-"`
 }
 
 // subscriptionChangeApplyResponseJSON contains the JSON metadata for the struct
 // [SubscriptionChangeApplyResponse]
 type subscriptionChangeApplyResponseJSON struct {
-	ID             apijson.Field
-	ExpirationTime apijson.Field
-	Status         apijson.Field
-	Subscription   apijson.Field
-	AppliedAt      apijson.Field
-	CancelledAt    apijson.Field
-	raw            string
-	ExtraFields    map[string]apijson.Field
+	ID                    apijson.Field
+	ChangeType            apijson.Field
+	ExpirationTime        apijson.Field
+	Status                apijson.Field
+	Subscription          apijson.Field
+	AppliedAt             apijson.Field
+	BillingCycleAlignment apijson.Field
+	CancelledAt           apijson.Field
+	ChangeOption          apijson.Field
+	EffectiveDate         apijson.Field
+	PlanID                apijson.Field
+	raw                   string
+	ExtraFields           map[string]apijson.Field
 }
 
 func (r *SubscriptionChangeApplyResponse) UnmarshalJSON(data []byte) (err error) {
@@ -465,28 +497,44 @@ func (r SubscriptionChangeApplyResponseStatus) IsKnown() bool {
 // `subscription.changed_resources`).
 type SubscriptionChangeCancelResponse struct {
 	ID string `json:"id,required"`
+	// The type of change (e.g., 'schedule_plan_change', 'create_subscription').
+	ChangeType string `json:"change_type,required"`
 	// Subscription change will be cancelled at this time and can no longer be applied.
 	ExpirationTime time.Time                              `json:"expiration_time,required" format:"date-time"`
 	Status         SubscriptionChangeCancelResponseStatus `json:"status,required"`
 	Subscription   MutatedSubscription                    `json:"subscription,required,nullable"`
 	// When this change was applied.
 	AppliedAt time.Time `json:"applied_at,nullable" format:"date-time"`
+	// Billing cycle alignment for plan changes.
+	BillingCycleAlignment string `json:"billing_cycle_alignment,nullable"`
 	// When this change was cancelled.
-	CancelledAt time.Time                            `json:"cancelled_at,nullable" format:"date-time"`
-	JSON        subscriptionChangeCancelResponseJSON `json:"-"`
+	CancelledAt time.Time `json:"cancelled_at,nullable" format:"date-time"`
+	// How the change is scheduled (e.g., 'immediate', 'end_of_subscription_term',
+	// 'requested_date').
+	ChangeOption string `json:"change_option,nullable"`
+	// When this change will take effect.
+	EffectiveDate time.Time `json:"effective_date,nullable" format:"date-time"`
+	// The target plan ID for plan changes.
+	PlanID string                               `json:"plan_id,nullable"`
+	JSON   subscriptionChangeCancelResponseJSON `json:"-"`
 }
 
 // subscriptionChangeCancelResponseJSON contains the JSON metadata for the struct
 // [SubscriptionChangeCancelResponse]
 type subscriptionChangeCancelResponseJSON struct {
-	ID             apijson.Field
-	ExpirationTime apijson.Field
-	Status         apijson.Field
-	Subscription   apijson.Field
-	AppliedAt      apijson.Field
-	CancelledAt    apijson.Field
-	raw            string
-	ExtraFields    map[string]apijson.Field
+	ID                    apijson.Field
+	ChangeType            apijson.Field
+	ExpirationTime        apijson.Field
+	Status                apijson.Field
+	Subscription          apijson.Field
+	AppliedAt             apijson.Field
+	BillingCycleAlignment apijson.Field
+	CancelledAt           apijson.Field
+	ChangeOption          apijson.Field
+	EffectiveDate         apijson.Field
+	PlanID                apijson.Field
+	raw                   string
+	ExtraFields           map[string]apijson.Field
 }
 
 func (r *SubscriptionChangeCancelResponse) UnmarshalJSON(data []byte) (err error) {