orb-billing 6.9.0 → 6.11.0

package/resources/subscriptions.d.mts

@@ -774,6 +774,17 @@ export declare class Subscriptions extends APIResource {
      * Note that one of `plan_id` or `external_plan_id` is required in the request body
      * for this operation.
      *
+     * ## Interaction with scheduled cancellations
+     *
+     * Scheduling a plan change also unschedules a pending cancellation, as long as the
+     * cancellation date is on or after the plan change date: Orb honors the plan
+     * change over the scheduled cancellation, and the subscription continues on the
+     * new plan. Scheduling a plan change after the subscription's end date returns a
+     * validation error instead.
+     *
+     * Any plan changes already scheduled at or after the new plan change's date are
+     * unscheduled and replaced by it.
+     *
      * ## Customize your customer's subscriptions
      *
      * Prices and adjustments in a plan can be added, removed, or replaced on the
@@ -951,11 +962,19 @@ export declare class Subscriptions extends APIResource {
      * cancellation. This operation will turn on auto-renew, ensuring that the
      * subscription does not end at the currently scheduled cancellation time.
      *
-     * Note: uncancellation is a lossy operation. Price intervals that were cut short
-     * by the cancellation are extended to infinity (original end dates are lost), and
-     * future intervals or phases scheduled after the cancellation time are permanently
-     * deleted. For complex subscriptions with phases or scheduled plan changes,
-     * consider creating a new plan change instead of uncancelling.
+     * A cancellation that has already taken effect cannot be unscheduled. This
+     * includes backdated cancellations: once the subscription's end date is in the
+     * past, this endpoint returns a validation error.
+     *
+     * Note: uncancellation is a lossy operation. Price and adjustment intervals that
+     * were cut short by the cancellation are extended to infinity (original end dates
+     * are lost), and future intervals or phases scheduled after the cancellation time
+     * are permanently deleted. For complex subscriptions with phases or scheduled plan
+     * changes, consider creating a new plan change instead of uncancelling.
+     *
+     * If the scheduled cancellation already produced invoices or credit notes (for
+     * example, a proration refund credit note for an in-advance fee), uncancelling
+     * voids and reissues them as needed to match the subscription's new state.
      *
      * @example
      * ```ts
@@ -985,7 +1004,21 @@ export declare class Subscriptions extends APIResource {
     unscheduleFixedFeeQuantityUpdates(subscriptionID: string, body: SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, options?: RequestOptions): APIPromise<SubscriptionChangesAPI.MutatedSubscription>;
     /**
      * This endpoint can be used to unschedule any pending plan changes on an existing
-     * subscription. When called, all upcoming plan changes will be unscheduled.
+     * subscription. When called, all upcoming plan changes will be unscheduled; it is
+     * not possible to unschedule a single plan change if multiple are scheduled.
+     *
+     * Note: unscheduling a plan change is a lossy operation, with the same semantics
+     * as
+     * [unscheduling a cancellation](/api-reference/subscription/unschedule-subscription-cancellation).
+     * Prices and adjustments on the current plan that were scheduled to end at the
+     * plan change time are extended to infinity (original end dates are lost), and
+     * anything scheduled to start after the plan change time is permanently deleted.
+     * Coupons redeemed as part of an unscheduled plan change are released and can be
+     * redeemed again.
+     *
+     * A scheduled cancellation is not affected by this operation: if the subscription
+     * has both a pending plan change and a scheduled cancellation, unscheduling the
+     * plan change leaves the cancellation in place.
      *
      * @example
      * ```ts
@@ -4389,7 +4422,7 @@ export declare namespace SubscriptionCreateParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | AddPrice.NewSubscriptionGroupedTieredMatrixPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -4534,6 +4567,131 @@ export declare namespace SubscriptionCreateParams {
                 }
             }
         }
+        interface NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            grouped_tiered_matrix_config: NewSubscriptionGroupedTieredMatrixPrice.GroupedTieredMatrixConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'grouped_tiered_matrix';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            interface GroupedTieredMatrixConfig {
+                /**
+                 * Per unit rate for usage whose dimension value has no configured tiers
+                 */
+                default_unit_amount: string;
+                /**
+                 * The billable metric property used to group usage before tiering
+                 */
+                dimension: string;
+                /**
+                 * Graduated tiers keyed by dimension value; usage for a value is tiered only
+                 * against its own rows
+                 */
+                tiers: Array<GroupedTieredMatrixConfig.Tier>;
+            }
+            namespace GroupedTieredMatrixConfig {
+                /**
+                 * Configuration for a single tier scoped to a dimension value
+                 */
+                interface Tier {
+                    /**
+                     * The dimension value this tier applies to
+                     */
+                    dimension_value: string;
+                    tier_lower_bound: string;
+                    /**
+                     * Per unit amount
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
              * The cadence to bill for this price on.
@@ -5632,7 +5790,7 @@ export declare namespace SubscriptionCreateParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | ReplacePrice.NewSubscriptionGroupedTieredMatrixPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -5771,6 +5929,131 @@ export declare namespace SubscriptionCreateParams {
                 }
             }
         }
+        interface NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            grouped_tiered_matrix_config: NewSubscriptionGroupedTieredMatrixPrice.GroupedTieredMatrixConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'grouped_tiered_matrix';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            interface GroupedTieredMatrixConfig {
+                /**
+                 * Per unit rate for usage whose dimension value has no configured tiers
+                 */
+                default_unit_amount: string;
+                /**
+                 * The billable metric property used to group usage before tiering
+                 */
+                dimension: string;
+                /**
+                 * Graduated tiers keyed by dimension value; usage for a value is tiered only
+                 * against its own rows
+                 */
+                tiers: Array<GroupedTieredMatrixConfig.Tier>;
+            }
+            namespace GroupedTieredMatrixConfig {
+                /**
+                 * Configuration for a single tier scoped to a dimension value
+                 */
+                interface Tier {
+                    /**
+                     * The dimension value this tier applies to
+                     */
+                    dimension_value: string;
+                    tier_lower_bound: string;
+                    /**
+                     * Per unit amount
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
              * The cadence to bill for this price on.
@@ -6958,7 +7241,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
         /**
          * New floating price request body params.
          */
-        price?: Shared.NewFloatingUnitPrice | Shared.NewFloatingTieredPrice | Shared.NewFloatingBulkPrice | Add.NewFloatingBulkWithFiltersPrice | Shared.NewFloatingPackagePrice | Shared.NewFloatingMatrixPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | Shared.NewFloatingGroupedTieredPrice | Shared.NewFloatingTieredPackageWithMinimumPrice | Shared.NewFloatingPackageWithAllocationPrice | Shared.NewFloatingUnitWithPercentPrice | Shared.NewFloatingMatrixWithAllocationPrice | Add.NewFloatingMatrixWithThresholdDiscountsPrice | Shared.NewFloatingTieredWithProrationPrice | Shared.NewFloatingUnitWithProrationPrice | Shared.NewFloatingGroupedAllocationPrice | Shared.NewFloatingBulkWithProrationPrice | Shared.NewFloatingGroupedWithProratedMinimumPrice | Shared.NewFloatingGroupedWithMeteredMinimumPrice | Add.NewFloatingGroupedWithMinMaxThresholdsPrice | Shared.NewFloatingMatrixWithDisplayNamePrice | Shared.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Add.NewFloatingCumulativeGroupedAllocationPrice | Add.NewFloatingDailyCreditAllowancePrice | Add.NewFloatingMeteredAllowancePrice | Shared.NewFloatingMinimumCompositePrice | Add.NewFloatingPercentCompositePrice | Add.NewFloatingEventOutputPrice | null;
+        price?: Shared.NewFloatingUnitPrice | Shared.NewFloatingTieredPrice | Shared.NewFloatingBulkPrice | Add.NewFloatingBulkWithFiltersPrice | Shared.NewFloatingPackagePrice | Shared.NewFloatingMatrixPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | Shared.NewFloatingGroupedTieredPrice | Add.NewFloatingGroupedTieredMatrixPrice | Shared.NewFloatingTieredPackageWithMinimumPrice | Shared.NewFloatingPackageWithAllocationPrice | Shared.NewFloatingUnitWithPercentPrice | Shared.NewFloatingMatrixWithAllocationPrice | Add.NewFloatingMatrixWithThresholdDiscountsPrice | Shared.NewFloatingTieredWithProrationPrice | Shared.NewFloatingUnitWithProrationPrice | Shared.NewFloatingGroupedAllocationPrice | Shared.NewFloatingBulkWithProrationPrice | Shared.NewFloatingGroupedWithProratedMinimumPrice | Shared.NewFloatingGroupedWithMeteredMinimumPrice | Add.NewFloatingGroupedWithMinMaxThresholdsPrice | Shared.NewFloatingMatrixWithDisplayNamePrice | Shared.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Add.NewFloatingCumulativeGroupedAllocationPrice | Add.NewFloatingDailyCreditAllowancePrice | Add.NewFloatingMeteredAllowancePrice | Shared.NewFloatingMinimumCompositePrice | Add.NewFloatingPercentCompositePrice | Add.NewFloatingEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -7133,7 +7416,7 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 }
             }
         }
-        interface NewFloatingMatrixWithThresholdDiscountsPrice {
+        interface NewFloatingGroupedTieredMatrixPrice {
             /**
              * The cadence to bill for this price on.
              */
@@ -7143,17 +7426,17 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             currency: string;
             /**
-             * The id of the item the price will be associated with.
+             * Configuration for grouped_tiered_matrix pricing
              */
-            item_id: string;
+            grouped_tiered_matrix_config: NewFloatingGroupedTieredMatrixPrice.GroupedTieredMatrixConfig;
             /**
-             * Configuration for matrix_with_threshold_discounts pricing
+             * The id of the item the price will be associated with.
              */
-            matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+            item_id: string;
             /**
              * The pricing model type
              */
-            model_type: 'matrix_with_threshold_discounts';
+            model_type: 'grouped_tiered_matrix';
             /**
              * The name of the price.
              */
@@ -7216,47 +7499,166 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 [key: string]: string | null;
             } | null;
         }
-        namespace NewFloatingMatrixWithThresholdDiscountsPrice {
+        namespace NewFloatingGroupedTieredMatrixPrice {
             /**
-             * Configuration for matrix_with_threshold_discounts pricing
+             * Configuration for grouped_tiered_matrix pricing
              */
-            interface MatrixWithThresholdDiscountsConfig {
+            interface GroupedTieredMatrixConfig {
                 /**
-                 * Unit price used for usage that does not match any defined matrix cell.
+                 * Per unit rate for usage whose dimension value has no configured tiers
                  */
                 default_unit_amount: string;
                 /**
-                 * First matrix dimension key.
+                 * The billable metric property used to group usage before tiering
                  */
-                first_dimension: string;
+                dimension: string;
                 /**
-                 * Per-cell unit prices.
+                 * Graduated tiers keyed by dimension value; usage for a value is tiered only
+                 * against its own rows
                  */
-                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+                tiers: Array<GroupedTieredMatrixConfig.Tier>;
+            }
+            namespace GroupedTieredMatrixConfig {
                 /**
-                 * Optional second matrix dimension key.
+                 * Configuration for a single tier scoped to a dimension value
                  */
-                second_dimension?: string | null;
-                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
-            }
-            namespace MatrixWithThresholdDiscountsConfig {
-                interface MatrixValue {
-                    first_dimension_value: string;
-                    unit_amount: string;
-                    second_dimension_value?: string | null;
-                }
-                interface ThresholdDiscountGroup {
+                interface Tier {
                     /**
-                     * Discount rate applied to spend above the threshold.
+                     * The dimension value this tier applies to
                      */
-                    above_threshold_discount_percentage: string;
+                    dimension_value: string;
+                    tier_lower_bound: string;
                     /**
-                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
-                     * baseline discount.
+                     * Per unit amount
                      */
-                    below_threshold_discount_percentage: string;
-                    /**
-                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                    unit_amount: string;
+                }
+            }
+        }
+        interface NewFloatingMatrixWithThresholdDiscountsPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * An ISO 4217 currency string for which this price is billed in.
+             */
+            currency: string;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            matrix_with_threshold_discounts_config: NewFloatingMatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+            /**
+             * The pricing model type
+             */
+            model_type: 'matrix_with_threshold_discounts';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+        }
+        namespace NewFloatingMatrixWithThresholdDiscountsPrice {
+            /**
+             * Configuration for matrix_with_threshold_discounts pricing
+             */
+            interface MatrixWithThresholdDiscountsConfig {
+                /**
+                 * Unit price used for usage that does not match any defined matrix cell.
+                 */
+                default_unit_amount: string;
+                /**
+                 * First matrix dimension key.
+                 */
+                first_dimension: string;
+                /**
+                 * Per-cell unit prices.
+                 */
+                matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+                /**
+                 * Optional second matrix dimension key.
+                 */
+                second_dimension?: string | null;
+                threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+            }
+            namespace MatrixWithThresholdDiscountsConfig {
+                interface MatrixValue {
+                    first_dimension_value: string;
+                    unit_amount: string;
+                    second_dimension_value?: string | null;
+                }
+                interface ThresholdDiscountGroup {
+                    /**
+                     * Discount rate applied to spend above the threshold.
+                     */
+                    above_threshold_discount_percentage: string;
+                    /**
+                     * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                     * baseline discount.
+                     */
+                    below_threshold_discount_percentage: string;
+                    /**
+                     * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
                      * coordinate is `first,second` when the matrix has two dimensions, or just `first`
                      * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
                      */
@@ -8411,7 +8813,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | AddPrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | AddPrice.NewSubscriptionGroupedTieredMatrixPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | AddPrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | AddPrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | AddPrice.NewSubscriptionCumulativeGroupedAllocationPrice | AddPrice.NewSubscriptionDailyCreditAllowancePrice | AddPrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | AddPrice.NewSubscriptionPercentCompositePrice | AddPrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -8556,6 +8958,131 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
                 }
             }
         }
+        interface NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            grouped_tiered_matrix_config: NewSubscriptionGroupedTieredMatrixPrice.GroupedTieredMatrixConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'grouped_tiered_matrix';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            interface GroupedTieredMatrixConfig {
+                /**
+                 * Per unit rate for usage whose dimension value has no configured tiers
+                 */
+                default_unit_amount: string;
+                /**
+                 * The billable metric property used to group usage before tiering
+                 */
+                dimension: string;
+                /**
+                 * Graduated tiers keyed by dimension value; usage for a value is tiered only
+                 * against its own rows
+                 */
+                tiers: Array<GroupedTieredMatrixConfig.Tier>;
+            }
+            namespace GroupedTieredMatrixConfig {
+                /**
+                 * Configuration for a single tier scoped to a dimension value
+                 */
+                interface Tier {
+                    /**
+                     * The dimension value this tier applies to
+                     */
+                    dimension_value: string;
+                    tier_lower_bound: string;
+                    /**
+                     * Per unit amount
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
              * The cadence to bill for this price on.
@@ -9654,7 +10181,7 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         /**
          * New subscription price request body params.
          */
-        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
+        price?: SubscriptionsAPI.NewSubscriptionUnitPrice | SubscriptionsAPI.NewSubscriptionTieredPrice | SubscriptionsAPI.NewSubscriptionBulkPrice | ReplacePrice.NewSubscriptionBulkWithFiltersPrice | SubscriptionsAPI.NewSubscriptionPackagePrice | SubscriptionsAPI.NewSubscriptionMatrixPrice | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice | SubscriptionsAPI.NewSubscriptionTieredPackagePrice | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice | ReplacePrice.NewSubscriptionGroupedTieredMatrixPrice | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice | ReplacePrice.NewSubscriptionMatrixWithThresholdDiscountsPrice | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | ReplacePrice.NewSubscriptionCumulativeGroupedAllocationPrice | ReplacePrice.NewSubscriptionDailyCreditAllowancePrice | ReplacePrice.NewSubscriptionMeteredAllowancePrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | ReplacePrice.NewSubscriptionPercentCompositePrice | ReplacePrice.NewSubscriptionEventOutputPrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -9793,6 +10320,131 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
                 }
             }
         }
+        interface NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * The cadence to bill for this price on.
+             */
+            cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            grouped_tiered_matrix_config: NewSubscriptionGroupedTieredMatrixPrice.GroupedTieredMatrixConfig;
+            /**
+             * The id of the item the price will be associated with.
+             */
+            item_id: string;
+            /**
+             * The pricing model type
+             */
+            model_type: 'grouped_tiered_matrix';
+            /**
+             * The name of the price.
+             */
+            name: string;
+            /**
+             * The id of the billable metric for the price. Only needed if the price is
+             * usage-based.
+             */
+            billable_metric_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, the price will be billed in-advance if
+             * this is true, and in-arrears if this is false.
+             */
+            billed_in_advance?: boolean | null;
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The per unit conversion rate of the price currency to the invoicing currency.
+             */
+            conversion_rate?: number | null;
+            /**
+             * The configuration for the rate of the price currency to the invoicing currency.
+             */
+            conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+            /**
+             * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+             * price is billed.
+             */
+            currency?: string | null;
+            /**
+             * For dimensional price: specifies a price group and dimension values
+             */
+            dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+            /**
+             * An alias for the price.
+             */
+            external_price_id?: string | null;
+            /**
+             * If the Price represents a fixed cost, this represents the quantity of units
+             * applied.
+             */
+            fixed_price_quantity?: number | null;
+            /**
+             * The property used to group this price on an invoice
+             */
+            invoice_grouping_key?: string | null;
+            /**
+             * Within each billing cycle, specifies the cadence at which invoices are produced.
+             * If unspecified, a single invoice is produced per billing cycle.
+             */
+            invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+            /**
+             * The ID of the license type to associate with this price.
+             */
+            license_type_id?: string | null;
+            /**
+             * User-specified key/value pairs for the resource. Individual keys can be removed
+             * by setting the value to `null`, and the entire metadata mapping can be cleared
+             * by setting `metadata` to `null`.
+             */
+            metadata?: {
+                [key: string]: string | null;
+            } | null;
+            /**
+             * A transient ID that can be used to reference this price when adding adjustments
+             * in the same API call.
+             */
+            reference_id?: string | null;
+        }
+        namespace NewSubscriptionGroupedTieredMatrixPrice {
+            /**
+             * Configuration for grouped_tiered_matrix pricing
+             */
+            interface GroupedTieredMatrixConfig {
+                /**
+                 * Per unit rate for usage whose dimension value has no configured tiers
+                 */
+                default_unit_amount: string;
+                /**
+                 * The billable metric property used to group usage before tiering
+                 */
+                dimension: string;
+                /**
+                 * Graduated tiers keyed by dimension value; usage for a value is tiered only
+                 * against its own rows
+                 */
+                tiers: Array<GroupedTieredMatrixConfig.Tier>;
+            }
+            namespace GroupedTieredMatrixConfig {
+                /**
+                 * Configuration for a single tier scoped to a dimension value
+                 */
+                interface Tier {
+                    /**
+                     * The dimension value this tier applies to
+                     */
+                    dimension_value: string;
+                    tier_lower_bound: string;
+                    /**
+                     * Per unit amount
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionMatrixWithThresholdDiscountsPrice {
             /**
              * The cadence to bill for this price on.