orb-billing 5.5.1 → 5.7.0

package/src/resources/subscriptions.ts

@@ -766,7 +766,7 @@ export class Subscriptions extends APIResource {
    * This endpoint can be used to change an existing subscription's plan. It returns
    * the serialized updated subscription object.
    *
-   * The body parameter `change_option` determines when the plan change occurrs. Orb
+   * The body parameter `change_option` determines when the plan change occurs. Orb
    * supports three options:
    *
    * - `end_of_subscription_term`: changes the plan at the end of the existing plan's
@@ -1092,8 +1092,11 @@ export interface DiscountOverride {
   usage_discount?: number | null;
 }
 
-export interface NewSubscriptionBPSPrice {
-  bps_config: Shared.BPSConfig;
+export interface NewSubscriptionBulkPrice {
+  /**
+   * Configuration for bulk pricing
+   */
+  bulk_config: Shared.BulkConfig;
 
   /**
    * The cadence to bill for this price on.
@@ -1105,7 +1108,10 @@ export interface NewSubscriptionBPSPrice {
    */
   item_id: string;
 
-  model_type: 'bps';
+  /**
+   * The pricing model type
+   */
+  model_type: 'bulk';
 
   /**
    * The name of the price.
@@ -1187,8 +1193,11 @@ export interface NewSubscriptionBPSPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionBulkBPSPrice {
-  bulk_bps_config: Shared.BulkBPSConfig;
+export interface NewSubscriptionBulkWithProrationPrice {
+  /**
+   * Configuration for bulk_with_proration pricing
+   */
+  bulk_with_proration_config: NewSubscriptionBulkWithProrationPrice.BulkWithProrationConfig;
 
   /**
    * The cadence to bill for this price on.
@@ -1200,7 +1209,10 @@ export interface NewSubscriptionBulkBPSPrice {
    */
   item_id: string;
 
-  model_type: 'bulk_bps';
+  /**
+   * The pricing model type
+   */
+  model_type: 'bulk_with_proration';
 
   /**
    * The name of the price.
@@ -1282,20 +1294,55 @@ export interface NewSubscriptionBulkBPSPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionBulkPrice {
-  bulk_config: Shared.BulkConfig;
+export namespace NewSubscriptionBulkWithProrationPrice {
+  /**
+   * Configuration for bulk_with_proration pricing
+   */
+  export interface BulkWithProrationConfig {
+    /**
+     * Bulk tiers for rating based on total usage volume
+     */
+    tiers: Array<BulkWithProrationConfig.Tier>;
+  }
+
+  export namespace BulkWithProrationConfig {
+    /**
+     * Configuration for a single bulk pricing tier with proration
+     */
+    export interface Tier {
+      /**
+       * Cost per unit
+       */
+      unit_amount: string;
+
+      /**
+       * The lower bound for this tier
+       */
+      tier_lower_bound?: string | null;
+    }
+  }
+}
 
+export interface NewSubscriptionCumulativeGroupedBulkPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
+  /**
+   * Configuration for cumulative_grouped_bulk pricing
+   */
+  cumulative_grouped_bulk_config: NewSubscriptionCumulativeGroupedBulkPrice.CumulativeGroupedBulkConfig;
+
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'bulk';
+  /**
+   * The pricing model type
+   */
+  model_type: 'cumulative_grouped_bulk';
 
   /**
    * The name of the price.
@@ -1377,20 +1424,65 @@ export interface NewSubscriptionBulkPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionBulkWithProrationPrice {
-  bulk_with_proration_config: { [key: string]: unknown };
+export namespace NewSubscriptionCumulativeGroupedBulkPrice {
+  /**
+   * Configuration for cumulative_grouped_bulk pricing
+   */
+  export interface CumulativeGroupedBulkConfig {
+    /**
+     * Each tier lower bound must have the same group of values.
+     */
+    dimension_values: Array<CumulativeGroupedBulkConfig.DimensionValue>;
+
+    /**
+     * Grouping key name
+     */
+    group: string;
+  }
 
+  export namespace CumulativeGroupedBulkConfig {
+    /**
+     * Configuration for a dimension value entry
+     */
+    export interface DimensionValue {
+      /**
+       * Grouping key value
+       */
+      grouping_key: string;
+
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+
+      /**
+       * Unit amount for this combination
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionGroupedAllocationPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
+  /**
+   * Configuration for grouped_allocation pricing
+   */
+  grouped_allocation_config: NewSubscriptionGroupedAllocationPrice.GroupedAllocationConfig;
+
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'bulk_with_proration';
+  /**
+   * The pricing model type
+   */
+  model_type: 'grouped_allocation';
 
   /**
    * The name of the price.
@@ -1472,20 +1564,48 @@ export interface NewSubscriptionBulkWithProrationPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionCumulativeGroupedBulkPrice {
+export namespace NewSubscriptionGroupedAllocationPrice {
+  /**
+   * Configuration for grouped_allocation pricing
+   */
+  export interface GroupedAllocationConfig {
+    /**
+     * Usage allocation per group
+     */
+    allocation: string;
+
+    /**
+     * How to determine the groups that should each be allocated some quantity
+     */
+    grouping_key: string;
+
+    /**
+     * Unit rate for post-allocation
+     */
+    overage_unit_rate: string;
+  }
+}
+
+export interface NewSubscriptionGroupedTieredPackagePrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  cumulative_grouped_bulk_config: { [key: string]: unknown };
+  /**
+   * Configuration for grouped_tiered_package pricing
+   */
+  grouped_tiered_package_config: NewSubscriptionGroupedTieredPackagePrice.GroupedTieredPackageConfig;
 
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'cumulative_grouped_bulk';
+  /**
+   * The pricing model type
+   */
+  model_type: 'grouped_tiered_package';
 
   /**
    * The name of the price.
@@ -1567,20 +1687,66 @@ export interface NewSubscriptionCumulativeGroupedBulkPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionGroupedAllocationPrice {
+export namespace NewSubscriptionGroupedTieredPackagePrice {
+  /**
+   * Configuration for grouped_tiered_package pricing
+   */
+  export interface GroupedTieredPackageConfig {
+    /**
+     * The event property used to group before tiering
+     */
+    grouping_key: string;
+
+    /**
+     * Package size
+     */
+    package_size: string;
+
+    /**
+     * Apply tiered pricing after rounding up the quantity to the package size. Tiers
+     * are defined using exclusive lower bounds.
+     */
+    tiers: Array<GroupedTieredPackageConfig.Tier>;
+  }
+
+  export namespace GroupedTieredPackageConfig {
+    /**
+     * Configuration for a single tier
+     */
+    export interface Tier {
+      /**
+       * Price per package
+       */
+      per_unit: string;
+
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+    }
+  }
+}
+
+export interface NewSubscriptionGroupedTieredPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  grouped_allocation_config: { [key: string]: unknown };
+  /**
+   * Configuration for grouped_tiered pricing
+   */
+  grouped_tiered_config: NewSubscriptionGroupedTieredPrice.GroupedTieredConfig;
 
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'grouped_allocation';
+  /**
+   * The pricing model type
+   */
+  model_type: 'grouped_tiered';
 
   /**
    * The name of the price.
@@ -1662,20 +1828,61 @@ export interface NewSubscriptionGroupedAllocationPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionGroupedTieredPackagePrice {
+export namespace NewSubscriptionGroupedTieredPrice {
+  /**
+   * Configuration for grouped_tiered pricing
+   */
+  export interface GroupedTieredConfig {
+    /**
+     * The billable metric property used to group before tiering
+     */
+    grouping_key: string;
+
+    /**
+     * Apply tiered pricing to each segment generated after grouping with the provided
+     * key
+     */
+    tiers: Array<GroupedTieredConfig.Tier>;
+  }
+
+  export namespace GroupedTieredConfig {
+    /**
+     * Configuration for a single tier
+     */
+    export interface Tier {
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionGroupedWithMeteredMinimumPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  grouped_tiered_package_config: { [key: string]: unknown };
+  /**
+   * Configuration for grouped_with_metered_minimum pricing
+   */
+  grouped_with_metered_minimum_config: NewSubscriptionGroupedWithMeteredMinimumPrice.GroupedWithMeteredMinimumConfig;
 
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'grouped_tiered_package';
+  /**
+   * The pricing model type
+   */
+  model_type: 'grouped_with_metered_minimum';
 
   /**
    * The name of the price.
@@ -1757,20 +1964,97 @@ export interface NewSubscriptionGroupedTieredPackagePrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionGroupedTieredPrice {
+export namespace NewSubscriptionGroupedWithMeteredMinimumPrice {
+  /**
+   * Configuration for grouped_with_metered_minimum pricing
+   */
+  export interface GroupedWithMeteredMinimumConfig {
+    /**
+     * Used to partition the usage into groups. The minimum amount is applied to each
+     * group.
+     */
+    grouping_key: string;
+
+    /**
+     * The minimum amount to charge per group per unit
+     */
+    minimum_unit_amount: string;
+
+    /**
+     * Used to determine the unit rate
+     */
+    pricing_key: string;
+
+    /**
+     * Scale the unit rates by the scaling factor.
+     */
+    scaling_factors: Array<GroupedWithMeteredMinimumConfig.ScalingFactor>;
+
+    /**
+     * Used to determine the unit rate scaling factor
+     */
+    scaling_key: string;
+
+    /**
+     * Apply per unit pricing to each pricing value. The minimum amount is applied any
+     * unmatched usage.
+     */
+    unit_amounts: Array<GroupedWithMeteredMinimumConfig.UnitAmount>;
+  }
+
+  export namespace GroupedWithMeteredMinimumConfig {
+    /**
+     * Configuration for a scaling factor
+     */
+    export interface ScalingFactor {
+      /**
+       * Scaling factor
+       */
+      scaling_factor: string;
+
+      /**
+       * Scaling value
+       */
+      scaling_value: string;
+    }
+
+    /**
+     * Configuration for a unit amount
+     */
+    export interface UnitAmount {
+      /**
+       * Pricing value
+       */
+      pricing_value: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionGroupedWithProratedMinimumPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  grouped_tiered_config: { [key: string]: unknown };
+  /**
+   * Configuration for grouped_with_prorated_minimum pricing
+   */
+  grouped_with_prorated_minimum_config: NewSubscriptionGroupedWithProratedMinimumPrice.GroupedWithProratedMinimumConfig;
 
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'grouped_tiered';
+  /**
+   * The pricing model type
+   */
+  model_type: 'grouped_with_prorated_minimum';
 
   /**
    * The name of the price.
@@ -1852,20 +2136,48 @@ export interface NewSubscriptionGroupedTieredPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionGroupedWithMeteredMinimumPrice {
+export namespace NewSubscriptionGroupedWithProratedMinimumPrice {
+  /**
+   * Configuration for grouped_with_prorated_minimum pricing
+   */
+  export interface GroupedWithProratedMinimumConfig {
+    /**
+     * How to determine the groups that should each have a minimum
+     */
+    grouping_key: string;
+
+    /**
+     * The minimum amount to charge per group
+     */
+    minimum: string;
+
+    /**
+     * The amount to charge per unit
+     */
+    unit_rate: string;
+  }
+}
+
+export interface NewSubscriptionMatrixPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  grouped_with_metered_minimum_config: { [key: string]: unknown };
-
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'grouped_with_metered_minimum';
+  /**
+   * Configuration for matrix pricing
+   */
+  matrix_config: Shared.MatrixConfig;
+
+  /**
+   * The pricing model type
+   */
+  model_type: 'matrix';
 
   /**
    * The name of the price.
@@ -1947,20 +2259,26 @@ export interface NewSubscriptionGroupedWithMeteredMinimumPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionGroupedWithProratedMinimumPrice {
+export interface NewSubscriptionMatrixWithAllocationPrice {
   /**
    * The cadence to bill for this price on.
    */
   cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
 
-  grouped_with_prorated_minimum_config: { [key: string]: unknown };
-
   /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'grouped_with_prorated_minimum';
+  /**
+   * Configuration for matrix_with_allocation pricing
+   */
+  matrix_with_allocation_config: Shared.MatrixWithAllocationConfig;
+
+  /**
+   * The pricing model type
+   */
+  model_type: 'matrix_with_allocation';
 
   /**
    * The name of the price.
@@ -2042,7 +2360,7 @@ export interface NewSubscriptionGroupedWithProratedMinimumPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionMatrixPrice {
+export interface NewSubscriptionMatrixWithDisplayNamePrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2053,9 +2371,15 @@ export interface NewSubscriptionMatrixPrice {
    */
   item_id: string;
 
-  matrix_config: Shared.MatrixConfig;
+  /**
+   * Configuration for matrix_with_display_name pricing
+   */
+  matrix_with_display_name_config: NewSubscriptionMatrixWithDisplayNamePrice.MatrixWithDisplayNameConfig;
 
-  model_type: 'matrix';
+  /**
+   * The pricing model type
+   */
+  model_type: 'matrix_with_display_name';
 
   /**
    * The name of the price.
@@ -2137,20 +2461,65 @@ export interface NewSubscriptionMatrixPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionMatrixWithAllocationPrice {
+export namespace NewSubscriptionMatrixWithDisplayNamePrice {
   /**
-   * The cadence to bill for this price on.
+   * Configuration for matrix_with_display_name pricing
    */
-  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+  export interface MatrixWithDisplayNameConfig {
+    /**
+     * Used to determine the unit rate
+     */
+    dimension: string;
 
-  /**
-   * The id of the item the price will be associated with.
-   */
-  item_id: string;
+    /**
+     * Apply per unit pricing to each dimension value
+     */
+    unit_amounts: Array<MatrixWithDisplayNameConfig.UnitAmount>;
+  }
 
-  matrix_with_allocation_config: Shared.MatrixWithAllocationConfig;
+  export namespace MatrixWithDisplayNameConfig {
+    /**
+     * Configuration for a unit amount item
+     */
+    export interface UnitAmount {
+      /**
+       * The dimension value
+       */
+      dimension_value: string;
 
-  model_type: 'matrix_with_allocation';
+      /**
+       * Display name for this dimension value
+       */
+      display_name: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionMaxGroupTieredPackagePrice {
+  /**
+   * The cadence to bill for this price on.
+   */
+  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+  /**
+   * The id of the item the price will be associated with.
+   */
+  item_id: string;
+
+  /**
+   * Configuration for max_group_tiered_package pricing
+   */
+  max_group_tiered_package_config: NewSubscriptionMaxGroupTieredPackagePrice.MaxGroupTieredPackageConfig;
+
+  /**
+   * The pricing model type
+   */
+  model_type: 'max_group_tiered_package';
 
   /**
    * The name of the price.
@@ -2232,7 +2601,46 @@ export interface NewSubscriptionMatrixWithAllocationPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionMatrixWithDisplayNamePrice {
+export namespace NewSubscriptionMaxGroupTieredPackagePrice {
+  /**
+   * Configuration for max_group_tiered_package pricing
+   */
+  export interface MaxGroupTieredPackageConfig {
+    /**
+     * The event property used to group before tiering the group with the highest value
+     */
+    grouping_key: string;
+
+    /**
+     * Package size
+     */
+    package_size: string;
+
+    /**
+     * Apply tiered pricing to the largest group after grouping with the provided key.
+     */
+    tiers: Array<MaxGroupTieredPackageConfig.Tier>;
+  }
+
+  export namespace MaxGroupTieredPackageConfig {
+    /**
+     * Configuration for a single tier
+     */
+    export interface Tier {
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionMinimumCompositePrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2243,9 +2651,15 @@ export interface NewSubscriptionMatrixWithDisplayNamePrice {
    */
   item_id: string;
 
-  matrix_with_display_name_config: { [key: string]: unknown };
+  /**
+   * Configuration for minimum pricing
+   */
+  minimum_config: NewSubscriptionMinimumCompositePrice.MinimumConfig;
 
-  model_type: 'matrix_with_display_name';
+  /**
+   * The pricing model type
+   */
+  model_type: 'minimum';
 
   /**
    * The name of the price.
@@ -2327,7 +2741,24 @@ export interface NewSubscriptionMatrixWithDisplayNamePrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionMaxGroupTieredPackagePrice {
+export namespace NewSubscriptionMinimumCompositePrice {
+  /**
+   * Configuration for minimum pricing
+   */
+  export interface MinimumConfig {
+    /**
+     * The minimum amount to apply
+     */
+    minimum_amount: string;
+
+    /**
+     * If true, subtotals from this price are prorated based on the service period
+     */
+    prorated?: boolean;
+  }
+}
+
+export interface NewSubscriptionPackagePrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2338,15 +2769,21 @@ export interface NewSubscriptionMaxGroupTieredPackagePrice {
    */
   item_id: string;
 
-  max_group_tiered_package_config: { [key: string]: unknown };
-
-  model_type: 'max_group_tiered_package';
+  /**
+   * The pricing model type
+   */
+  model_type: 'package';
 
   /**
    * The name of the price.
    */
   name: string;
 
+  /**
+   * Configuration for package pricing
+   */
+  package_config: Shared.PackageConfig;
+
   /**
    * The id of the billable metric for the price. Only needed if the price is
    * usage-based.
@@ -2422,7 +2859,7 @@ export interface NewSubscriptionMaxGroupTieredPackagePrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionPackagePrice {
+export interface NewSubscriptionPackageWithAllocationPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2433,14 +2870,20 @@ export interface NewSubscriptionPackagePrice {
    */
   item_id: string;
 
-  model_type: 'package';
+  /**
+   * The pricing model type
+   */
+  model_type: 'package_with_allocation';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  package_config: Shared.PackageConfig;
+  /**
+   * Configuration for package_with_allocation pricing
+   */
+  package_with_allocation_config: NewSubscriptionPackageWithAllocationPrice.PackageWithAllocationConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2517,7 +2960,29 @@ export interface NewSubscriptionPackagePrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionPackageWithAllocationPrice {
+export namespace NewSubscriptionPackageWithAllocationPrice {
+  /**
+   * Configuration for package_with_allocation pricing
+   */
+  export interface PackageWithAllocationConfig {
+    /**
+     * Usage allocation
+     */
+    allocation: string;
+
+    /**
+     * Price per package
+     */
+    package_amount: string;
+
+    /**
+     * Package size
+     */
+    package_size: string;
+  }
+}
+
+export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2528,14 +2993,20 @@ export interface NewSubscriptionPackageWithAllocationPrice {
    */
   item_id: string;
 
-  model_type: 'package_with_allocation';
+  /**
+   * The pricing model type
+   */
+  model_type: 'scalable_matrix_with_tiered_pricing';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  package_with_allocation_config: { [key: string]: unknown };
+  /**
+   * Configuration for scalable_matrix_with_tiered_pricing pricing
+   */
+  scalable_matrix_with_tiered_pricing_config: NewSubscriptionScalableMatrixWithTieredPricingPrice.ScalableMatrixWithTieredPricingConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2612,7 +3083,71 @@ export interface NewSubscriptionPackageWithAllocationPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
+export namespace NewSubscriptionScalableMatrixWithTieredPricingPrice {
+  /**
+   * Configuration for scalable_matrix_with_tiered_pricing pricing
+   */
+  export interface ScalableMatrixWithTieredPricingConfig {
+    /**
+     * Used for the scalable matrix first dimension
+     */
+    first_dimension: string;
+
+    /**
+     * Apply a scaling factor to each dimension
+     */
+    matrix_scaling_factors: Array<ScalableMatrixWithTieredPricingConfig.MatrixScalingFactor>;
+
+    /**
+     * Tier pricing structure
+     */
+    tiers: Array<ScalableMatrixWithTieredPricingConfig.Tier>;
+
+    /**
+     * Used for the scalable matrix second dimension (optional)
+     */
+    second_dimension?: string | null;
+  }
+
+  export namespace ScalableMatrixWithTieredPricingConfig {
+    /**
+     * Configuration for a single matrix scaling factor
+     */
+    export interface MatrixScalingFactor {
+      /**
+       * First dimension value
+       */
+      first_dimension_value: string;
+
+      /**
+       * Scaling factor
+       */
+      scaling_factor: string;
+
+      /**
+       * Second dimension value (optional)
+       */
+      second_dimension_value?: string | null;
+    }
+
+    /**
+     * Configuration for a single tier entry with business logic
+     */
+    export interface Tier {
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2623,14 +3158,20 @@ export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
    */
   item_id: string;
 
-  model_type: 'scalable_matrix_with_tiered_pricing';
+  /**
+   * The pricing model type
+   */
+  model_type: 'scalable_matrix_with_unit_pricing';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  scalable_matrix_with_tiered_pricing_config: { [key: string]: unknown };
+  /**
+   * Configuration for scalable_matrix_with_unit_pricing pricing
+   */
+  scalable_matrix_with_unit_pricing_config: NewSubscriptionScalableMatrixWithUnitPricingPrice.ScalableMatrixWithUnitPricingConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2707,7 +3248,61 @@ export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
+export namespace NewSubscriptionScalableMatrixWithUnitPricingPrice {
+  /**
+   * Configuration for scalable_matrix_with_unit_pricing pricing
+   */
+  export interface ScalableMatrixWithUnitPricingConfig {
+    /**
+     * Used to determine the unit rate
+     */
+    first_dimension: string;
+
+    /**
+     * Apply a scaling factor to each dimension
+     */
+    matrix_scaling_factors: Array<ScalableMatrixWithUnitPricingConfig.MatrixScalingFactor>;
+
+    /**
+     * The final unit price to rate against the output of the matrix
+     */
+    unit_price: string;
+
+    /**
+     * If true, the unit price will be prorated to the billing period
+     */
+    prorate?: boolean | null;
+
+    /**
+     * Used to determine the unit rate (optional)
+     */
+    second_dimension?: string | null;
+  }
+
+  export namespace ScalableMatrixWithUnitPricingConfig {
+    /**
+     * Configuration for a single matrix scaling factor
+     */
+    export interface MatrixScalingFactor {
+      /**
+       * First dimension value
+       */
+      first_dimension_value: string;
+
+      /**
+       * Scaling factor
+       */
+      scaling_factor: string;
+
+      /**
+       * Second dimension value (optional)
+       */
+      second_dimension_value?: string | null;
+    }
+  }
+}
+
+export interface NewSubscriptionThresholdTotalAmountPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2718,14 +3313,20 @@ export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
    */
   item_id: string;
 
-  model_type: 'scalable_matrix_with_unit_pricing';
+  /**
+   * The pricing model type
+   */
+  model_type: 'threshold_total_amount';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  scalable_matrix_with_unit_pricing_config: { [key: string]: unknown };
+  /**
+   * Configuration for threshold_total_amount pricing
+   */
+  threshold_total_amount_config: NewSubscriptionThresholdTotalAmountPrice.ThresholdTotalAmountConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2802,7 +3403,42 @@ export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionThresholdTotalAmountPrice {
+export namespace NewSubscriptionThresholdTotalAmountPrice {
+  /**
+   * Configuration for threshold_total_amount pricing
+   */
+  export interface ThresholdTotalAmountConfig {
+    /**
+     * When the quantity consumed passes a provided threshold, the configured total
+     * will be charged
+     */
+    consumption_table: Array<ThresholdTotalAmountConfig.ConsumptionTable>;
+
+    /**
+     * If true, the unit price will be prorated to the billing period
+     */
+    prorate?: boolean | null;
+  }
+
+  export namespace ThresholdTotalAmountConfig {
+    /**
+     * Configuration for a single threshold
+     */
+    export interface ConsumptionTable {
+      /**
+       * Quantity threshold
+       */
+      threshold: string;
+
+      /**
+       * Total amount for this threshold
+       */
+      total_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionTieredPackagePrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2813,14 +3449,20 @@ export interface NewSubscriptionThresholdTotalAmountPrice {
    */
   item_id: string;
 
-  model_type: 'threshold_total_amount';
+  /**
+   * The pricing model type
+   */
+  model_type: 'tiered_package';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  threshold_total_amount_config: { [key: string]: unknown };
+  /**
+   * Configuration for tiered_package pricing
+   */
+  tiered_package_config: NewSubscriptionTieredPackagePrice.TieredPackageConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2897,7 +3539,42 @@ export interface NewSubscriptionThresholdTotalAmountPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTierWithProrationPrice {
+export namespace NewSubscriptionTieredPackagePrice {
+  /**
+   * Configuration for tiered_package pricing
+   */
+  export interface TieredPackageConfig {
+    /**
+     * Package size
+     */
+    package_size: string;
+
+    /**
+     * Apply tiered pricing after rounding up the quantity to the package size. Tiers
+     * are defined using exclusive lower bounds.
+     */
+    tiers: Array<TieredPackageConfig.Tier>;
+  }
+
+  export namespace TieredPackageConfig {
+    /**
+     * Configuration for a single tier with business logic
+     */
+    export interface Tier {
+      /**
+       * Price per package
+       */
+      per_unit: string;
+
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+    }
+  }
+}
+
+export interface NewSubscriptionTieredPackageWithMinimumPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -2908,14 +3585,20 @@ export interface NewSubscriptionTierWithProrationPrice {
    */
   item_id: string;
 
-  model_type: 'tiered_with_proration';
+  /**
+   * The pricing model type
+   */
+  model_type: 'tiered_package_with_minimum';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_with_proration_config: { [key: string]: unknown };
+  /**
+   * Configuration for tiered_package_with_minimum pricing
+   */
+  tiered_package_with_minimum_config: NewSubscriptionTieredPackageWithMinimumPrice.TieredPackageWithMinimumConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -2992,25 +3675,71 @@ export interface NewSubscriptionTierWithProrationPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTieredBPSPrice {
+export namespace NewSubscriptionTieredPackageWithMinimumPrice {
   /**
-   * The cadence to bill for this price on.
+   * Configuration for tiered_package_with_minimum pricing
    */
-  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+  export interface TieredPackageWithMinimumConfig {
+    /**
+     * Package size
+     */
+    package_size: number;
 
-  /**
+    /**
+     * Apply tiered pricing after rounding up the quantity to the package size. Tiers
+     * are defined using exclusive lower bounds.
+     */
+    tiers: Array<TieredPackageWithMinimumConfig.Tier>;
+  }
+
+  export namespace TieredPackageWithMinimumConfig {
+    /**
+     * Configuration for a single tier
+     */
+    export interface Tier {
+      /**
+       * Minimum amount
+       */
+      minimum_amount: string;
+
+      /**
+       * Price per package
+       */
+      per_unit: string;
+
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+    }
+  }
+}
+
+export interface NewSubscriptionTieredPrice {
+  /**
+   * The cadence to bill for this price on.
+   */
+  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+  /**
    * The id of the item the price will be associated with.
    */
   item_id: string;
 
-  model_type: 'tiered_bps';
+  /**
+   * The pricing model type
+   */
+  model_type: 'tiered';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_bps_config: Shared.TieredBPSConfig;
+  /**
+   * Configuration for tiered pricing
+   */
+  tiered_config: Shared.TieredConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -3087,7 +3816,7 @@ export interface NewSubscriptionTieredBPSPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTieredPackagePrice {
+export interface NewSubscriptionTieredWithMinimumPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -3098,14 +3827,20 @@ export interface NewSubscriptionTieredPackagePrice {
    */
   item_id: string;
 
-  model_type: 'tiered_package';
+  /**
+   * The pricing model type
+   */
+  model_type: 'tiered_with_minimum';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_package_config: { [key: string]: unknown };
+  /**
+   * Configuration for tiered_with_minimum pricing
+   */
+  tiered_with_minimum_config: NewSubscriptionTieredWithMinimumPrice.TieredWithMinimumConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -3182,7 +3917,52 @@ export interface NewSubscriptionTieredPackagePrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTieredPackageWithMinimumPrice {
+export namespace NewSubscriptionTieredWithMinimumPrice {
+  /**
+   * Configuration for tiered_with_minimum pricing
+   */
+  export interface TieredWithMinimumConfig {
+    /**
+     * Tiered pricing with a minimum amount dependent on the volume tier. Tiers are
+     * defined using exclusive lower bounds.
+     */
+    tiers: Array<TieredWithMinimumConfig.Tier>;
+
+    /**
+     * If true, tiers with an accrued amount of 0 will not be included in the rating.
+     */
+    hide_zero_amount_tiers?: boolean;
+
+    /**
+     * If true, the unit price will be prorated to the billing period
+     */
+    prorate?: boolean;
+  }
+
+  export namespace TieredWithMinimumConfig {
+    /**
+     * Configuration for a single tier
+     */
+    export interface Tier {
+      /**
+       * Minimum amount
+       */
+      minimum_amount: string;
+
+      /**
+       * Tier lower bound
+       */
+      tier_lower_bound: string;
+
+      /**
+       * Per unit amount
+       */
+      unit_amount: string;
+    }
+  }
+}
+
+export interface NewSubscriptionUnitPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -3193,14 +3973,20 @@ export interface NewSubscriptionTieredPackageWithMinimumPrice {
    */
   item_id: string;
 
-  model_type: 'tiered_package_with_minimum';
+  /**
+   * The pricing model type
+   */
+  model_type: 'unit';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_package_with_minimum_config: { [key: string]: unknown };
+  /**
+   * Configuration for unit pricing
+   */
+  unit_config: Shared.UnitConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -3277,7 +4063,7 @@ export interface NewSubscriptionTieredPackageWithMinimumPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTieredPrice {
+export interface NewSubscriptionUnitWithPercentPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -3288,14 +4074,20 @@ export interface NewSubscriptionTieredPrice {
    */
   item_id: string;
 
-  model_type: 'tiered';
+  /**
+   * The pricing model type
+   */
+  model_type: 'unit_with_percent';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_config: Shared.TieredConfig;
+  /**
+   * Configuration for unit_with_percent pricing
+   */
+  unit_with_percent_config: NewSubscriptionUnitWithPercentPrice.UnitWithPercentConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -3372,7 +4164,24 @@ export interface NewSubscriptionTieredPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionTieredWithMinimumPrice {
+export namespace NewSubscriptionUnitWithPercentPrice {
+  /**
+   * Configuration for unit_with_percent pricing
+   */
+  export interface UnitWithPercentConfig {
+    /**
+     * What percent, out of 100, of the calculated total to charge
+     */
+    percent: string;
+
+    /**
+     * Rate per unit of usage
+     */
+    unit_amount: string;
+  }
+}
+
+export interface NewSubscriptionUnitWithProrationPrice {
   /**
    * The cadence to bill for this price on.
    */
@@ -3383,14 +4192,20 @@ export interface NewSubscriptionTieredWithMinimumPrice {
    */
   item_id: string;
 
-  model_type: 'tiered_with_minimum';
+  /**
+   * The pricing model type
+   */
+  model_type: 'unit_with_proration';
 
   /**
    * The name of the price.
    */
   name: string;
 
-  tiered_with_minimum_config: { [key: string]: unknown };
+  /**
+   * Configuration for unit_with_proration pricing
+   */
+  unit_with_proration_config: NewSubscriptionUnitWithProrationPrice.UnitWithProrationConfig;
 
   /**
    * The id of the billable metric for the price. Only needed if the price is
@@ -3467,442 +4282,169 @@ export interface NewSubscriptionTieredWithMinimumPrice {
   reference_id?: string | null;
 }
 
-export interface NewSubscriptionUnitPrice {
+export namespace NewSubscriptionUnitWithProrationPrice {
   /**
-   * The cadence to bill for this price on.
+   * Configuration for unit_with_proration pricing
    */
-  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+  export interface UnitWithProrationConfig {
+    /**
+     * Rate per unit of usage
+     */
+    unit_amount: string;
+  }
+}
+
+/**
+ * A [subscription](/core-concepts#subscription) represents the purchase of a plan
+ * by a customer.
+ *
+ * By default, subscriptions begin on the day that they're created and renew
+ * automatically for each billing cycle at the cadence that's configured in the
+ * plan definition.
+ *
+ * Subscriptions also default to **beginning of month alignment**, which means the
+ * first invoice issued for the subscription will have pro-rated charges between
+ * the `start_date` and the first of the following month. Subsequent billing
+ * periods will always start and end on a month boundary (e.g. subsequent month
+ * starts for monthly billing).
+ *
+ * Depending on the plan configuration, any _flat_ recurring fees will be billed
+ * either at the beginning (in-advance) or end (in-arrears) of each billing cycle.
+ * Plans default to **in-advance billing**. Usage-based fees are billed in arrears
+ * as usage is accumulated. In the normal course of events, you can expect an
+ * invoice to contain usage-based charges for the previous period, and a recurring
+ * fee for the following period.
+ */
+export interface Subscription {
+  id: string;
 
   /**
-   * The id of the item the price will be associated with.
+   * The current plan phase that is active, only if the subscription's plan has
+   * phases.
    */
-  item_id: string;
+  active_plan_phase_order: number | null;
 
-  model_type: 'unit';
+  /**
+   * The adjustment intervals for this subscription sorted by the start_date of the
+   * adjustment interval.
+   */
+  adjustment_intervals: Array<Shared.AdjustmentInterval>;
 
   /**
-   * The name of the price.
+   * Determines whether issued invoices for this subscription will automatically be
+   * charged with the saved payment method on the due date. This property defaults to
+   * the plan's behavior. If null, defaults to the customer's setting.
    */
-  name: string;
+  auto_collection: boolean | null;
 
-  unit_config: Shared.UnitConfig;
+  billing_cycle_anchor_configuration: Shared.BillingCycleAnchorConfiguration;
 
   /**
-   * The id of the billable metric for the price. Only needed if the price is
-   * usage-based.
+   * The day of the month on which the billing cycle is anchored. If the maximum
+   * number of days in a month is greater than this value, the last day of the month
+   * is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
+   * period begins on the 30th.
    */
-  billable_metric_id?: string | null;
+  billing_cycle_day: number;
+
+  created_at: string;
 
   /**
-   * 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.
+   * The end of the current billing period. This is an exclusive timestamp, such that
+   * the instant returned is not part of the billing period. Set to null for
+   * subscriptions that are not currently active.
    */
-  billed_in_advance?: boolean | null;
+  current_billing_period_end_date: string | null;
 
   /**
-   * For custom cadence: specifies the duration of the billing period in days or
-   * months.
+   * The start date of the current billing period. This is an inclusive timestamp;
+   * the instant returned is exactly the beginning of the billing period. Set to null
+   * if the subscription is not currently active.
    */
-  billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+  current_billing_period_start_date: string | null;
 
   /**
-   * The per unit conversion rate of the price currency to the invoicing currency.
+   * A customer is a buyer of your products, and the other party to the billing
+   * relationship.
+   *
+   * In Orb, customers are assigned system generated identifiers automatically, but
+   * it's often desirable to have these match existing identifiers in your system. To
+   * avoid having to denormalize Orb ID information, you can pass in an
+   * `external_customer_id` with your own identifier. See
+   * [Customer ID Aliases](/events-and-metrics/customer-aliases) for further
+   * information about how these aliases work in Orb.
+   *
+   * In addition to having an identifier in your system, a customer may exist in a
+   * payment provider solution like Stripe. Use the `payment_provider_id` and the
+   * `payment_provider` enum field to express this mapping.
+   *
+   * A customer also has a timezone (from the standard
+   * [IANA timezone database](https://www.iana.org/time-zones)), which defaults to
+   * your account's timezone. See [Timezone localization](/essentials/timezones) for
+   * information on what this timezone parameter influences within Orb.
    */
-  conversion_rate?: number | null;
+  customer: CustomersAPI.Customer;
 
   /**
-   * The configuration for the rate of the price currency to the invoicing currency.
+   * Determines the default memo on this subscriptions' invoices. Note that if this
+   * is not provided, it is determined by the plan configuration.
    */
-  conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+  default_invoice_memo: string | null;
 
   /**
-   * An ISO 4217 currency string, or custom pricing unit identifier, in which this
-   * price is billed.
+   * @deprecated The discount intervals for this subscription sorted by the
+   * start_date. This field is deprecated in favor of `adjustment_intervals`.
    */
-  currency?: string | null;
+  discount_intervals: Array<
+    Shared.AmountDiscountInterval | Shared.PercentageDiscountInterval | Shared.UsageDiscountInterval
+  >;
 
   /**
-   * For dimensional price: specifies a price group and dimension values
+   * The date Orb stops billing for this subscription.
    */
-  dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+  end_date: string | null;
+
+  fixed_fee_quantity_schedule: Array<Shared.FixedFeeQuantityScheduleEntry>;
+
+  invoicing_threshold: string | null;
 
   /**
-   * An alias for the price.
+   * @deprecated The maximum intervals for this subscription sorted by the
+   * start_date. This field is deprecated in favor of `adjustment_intervals`.
    */
-  external_price_id?: string | null;
+  maximum_intervals: Array<Shared.MaximumInterval>;
 
   /**
-   * If the Price represents a fixed cost, this represents the quantity of units
-   * applied.
+   * User specified key-value pairs for the resource. If not present, this defaults
+   * to an empty dictionary. Individual keys can be removed by setting the value to
+   * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+   * `null`.
    */
-  fixed_price_quantity?: number | null;
+  metadata: { [key: string]: string };
 
   /**
-   * The property used to group this price on an invoice
+   * @deprecated The minimum intervals for this subscription sorted by the
+   * start_date. This field is deprecated in favor of `adjustment_intervals`.
    */
-  invoice_grouping_key?: string | null;
+  minimum_intervals: Array<Shared.MinimumInterval>;
 
   /**
-   * Within each billing cycle, specifies the cadence at which invoices are produced.
-   * If unspecified, a single invoice is produced per billing cycle.
+   * The name of the subscription.
    */
-  invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+  name: string;
 
   /**
-   * 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`.
+   * Determines the difference between the invoice issue date for subscription
+   * invoices as the date that they are due. A value of `0` here represents that the
+   * invoice is due on issue, whereas a value of `30` represents that the customer
+   * has a month to pay the invoice.
    */
-  metadata?: { [key: string]: string | null } | null;
+  net_terms: number;
 
   /**
-   * A transient ID that can be used to reference this price when adding adjustments
-   * in the same API call.
+   * A pending subscription change if one exists on this subscription.
    */
-  reference_id?: string | null;
-}
-
-export interface NewSubscriptionUnitWithPercentPrice {
-  /**
-   * The cadence to bill for this price on.
-   */
-  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-
-  /**
-   * The id of the item the price will be associated with.
-   */
-  item_id: string;
-
-  model_type: 'unit_with_percent';
-
-  /**
-   * The name of the price.
-   */
-  name: string;
-
-  unit_with_percent_config: { [key: string]: unknown };
-
-  /**
-   * 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;
-
-  /**
-   * 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;
-}
-
-export interface NewSubscriptionUnitWithProrationPrice {
-  /**
-   * The cadence to bill for this price on.
-   */
-  cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-
-  /**
-   * The id of the item the price will be associated with.
-   */
-  item_id: string;
-
-  model_type: 'unit_with_proration';
-
-  /**
-   * The name of the price.
-   */
-  name: string;
-
-  unit_with_proration_config: { [key: string]: unknown };
-
-  /**
-   * 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;
-
-  /**
-   * 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;
-}
-
-/**
- * A [subscription](/core-concepts#subscription) represents the purchase of a plan
- * by a customer.
- *
- * By default, subscriptions begin on the day that they're created and renew
- * automatically for each billing cycle at the cadence that's configured in the
- * plan definition.
- *
- * Subscriptions also default to **beginning of month alignment**, which means the
- * first invoice issued for the subscription will have pro-rated charges between
- * the `start_date` and the first of the following month. Subsequent billing
- * periods will always start and end on a month boundary (e.g. subsequent month
- * starts for monthly billing).
- *
- * Depending on the plan configuration, any _flat_ recurring fees will be billed
- * either at the beginning (in-advance) or end (in-arrears) of each billing cycle.
- * Plans default to **in-advance billing**. Usage-based fees are billed in arrears
- * as usage is accumulated. In the normal course of events, you can expect an
- * invoice to contain usage-based charges for the previous period, and a recurring
- * fee for the following period.
- */
-export interface Subscription {
-  id: string;
-
-  /**
-   * The current plan phase that is active, only if the subscription's plan has
-   * phases.
-   */
-  active_plan_phase_order: number | null;
-
-  /**
-   * The adjustment intervals for this subscription sorted by the start_date of the
-   * adjustment interval.
-   */
-  adjustment_intervals: Array<Shared.AdjustmentInterval>;
-
-  /**
-   * Determines whether issued invoices for this subscription will automatically be
-   * charged with the saved payment method on the due date. This property defaults to
-   * the plan's behavior. If null, defaults to the customer's setting.
-   */
-  auto_collection: boolean | null;
-
-  billing_cycle_anchor_configuration: Shared.BillingCycleAnchorConfiguration;
-
-  /**
-   * The day of the month on which the billing cycle is anchored. If the maximum
-   * number of days in a month is greater than this value, the last day of the month
-   * is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
-   * period begins on the 30th.
-   */
-  billing_cycle_day: number;
-
-  created_at: string;
-
-  /**
-   * The end of the current billing period. This is an exclusive timestamp, such that
-   * the instant returned is not part of the billing period. Set to null for
-   * subscriptions that are not currently active.
-   */
-  current_billing_period_end_date: string | null;
-
-  /**
-   * The start date of the current billing period. This is an inclusive timestamp;
-   * the instant returned is exactly the beginning of the billing period. Set to null
-   * if the subscription is not currently active.
-   */
-  current_billing_period_start_date: string | null;
-
-  /**
-   * A customer is a buyer of your products, and the other party to the billing
-   * relationship.
-   *
-   * In Orb, customers are assigned system generated identifiers automatically, but
-   * it's often desirable to have these match existing identifiers in your system. To
-   * avoid having to denormalize Orb ID information, you can pass in an
-   * `external_customer_id` with your own identifier. See
-   * [Customer ID Aliases](/events-and-metrics/customer-aliases) for further
-   * information about how these aliases work in Orb.
-   *
-   * In addition to having an identifier in your system, a customer may exist in a
-   * payment provider solution like Stripe. Use the `payment_provider_id` and the
-   * `payment_provider` enum field to express this mapping.
-   *
-   * A customer also has a timezone (from the standard
-   * [IANA timezone database](https://www.iana.org/time-zones)), which defaults to
-   * your account's timezone. See [Timezone localization](/essentials/timezones) for
-   * information on what this timezone parameter influences within Orb.
-   */
-  customer: CustomersAPI.Customer;
-
-  /**
-   * Determines the default memo on this subscriptions' invoices. Note that if this
-   * is not provided, it is determined by the plan configuration.
-   */
-  default_invoice_memo: string | null;
-
-  /**
-   * @deprecated The discount intervals for this subscription sorted by the
-   * start_date. This field is deprecated in favor of `adjustment_intervals`.
-   */
-  discount_intervals: Array<
-    Shared.AmountDiscountInterval | Shared.PercentageDiscountInterval | Shared.UsageDiscountInterval
-  >;
-
-  /**
-   * The date Orb stops billing for this subscription.
-   */
-  end_date: string | null;
-
-  fixed_fee_quantity_schedule: Array<Shared.FixedFeeQuantityScheduleEntry>;
-
-  invoicing_threshold: string | null;
-
-  /**
-   * @deprecated The maximum intervals for this subscription sorted by the
-   * start_date. This field is deprecated in favor of `adjustment_intervals`.
-   */
-  maximum_intervals: Array<Shared.MaximumInterval>;
-
-  /**
-   * User specified key-value pairs for the resource. If not present, this defaults
-   * to an empty dictionary. 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 };
-
-  /**
-   * @deprecated The minimum intervals for this subscription sorted by the
-   * start_date. This field is deprecated in favor of `adjustment_intervals`.
-   */
-  minimum_intervals: Array<Shared.MinimumInterval>;
-
-  /**
-   * The name of the subscription.
-   */
-  name: string;
-
-  /**
-   * Determines the difference between the invoice issue date for subscription
-   * invoices as the date that they are due. A value of `0` here represents that the
-   * invoice is due on issue, whereas a value of `30` represents that the customer
-   * has a month to pay the invoice.
-   */
-  net_terms: number;
-
-  /**
-   * A pending subscription change if one exists on this subscription.
-   */
-  pending_subscription_change: Shared.SubscriptionChangeMinified | null;
+  pending_subscription_change: Shared.SubscriptionChangeMinified | null;
 
   /**
    * The [Plan](/core-concepts#plan-and-price) resource represents a plan that can be
@@ -4253,92 +4795,352 @@ export namespace SubscriptionCreateParams {
     start_date?: string | null;
   }
 
-  export interface AddPrice {
-    /**
-     * The definition of a new allocation price to create and add to the subscription.
-     */
-    allocation_price?: Shared.NewAllocationPrice | null;
+  export interface AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: Shared.NewAllocationPrice | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
+     * discounts for this price.
+     */
+    discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
+
+    /**
+     * The end date of the price interval. This is the date that the price will stop
+     * billing on the subscription. If null, billing will end when the phase or
+     * subscription ends.
+     */
+    end_date?: string | null;
+
+    /**
+     * The external price id of the price to add to the subscription.
+     */
+    external_price_id?: string | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
+     * amount for this price.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
+     * amount for this price.
+     */
+    minimum_amount?: string | null;
+
+    /**
+     * The phase to add this price to.
+     */
+    plan_phase_order?: number | null;
+
+    /**
+     * New subscription price request body params.
+     */
+    price?:
+      | SubscriptionsAPI.NewSubscriptionUnitPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPrice
+      | SubscriptionsAPI.NewSubscriptionBulkPrice
+      | SubscriptionsAPI.NewSubscriptionPackagePrice
+      | SubscriptionsAPI.NewSubscriptionMatrixPrice
+      | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
+      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
+      | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
+      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
+      | 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
+      | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice
+      | null;
+
+    /**
+     * The id of the price to add to the subscription.
+     */
+    price_id?: string | null;
+
+    /**
+     * The start date of the price interval. This is the date that the price will start
+     * billing on the subscription. If null, billing will start when the phase or
+     * subscription starts.
+     */
+    start_date?: string | null;
+  }
+
+  export namespace AddPrice {
+    export interface NewSubscriptionTieredWithProrationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_with_proration';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionTieredWithProrationPrice {
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      export interface TieredWithProrationConfig {
+        /**
+         * Tiers for rating based on total usage quantities into the specified tier with
+         * proration
+         */
+        tiers: Array<TieredWithProrationConfig.Tier>;
+      }
+
+      export namespace TieredWithProrationConfig {
+        /**
+         * Configuration for a single tiered with proration tier
+         */
+        export interface Tier {
+          /**
+           * Inclusive tier starting value
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Amount per unit
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
+    export interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'grouped_with_min_max_thresholds';
+
+      /**
+       * 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;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
-     * discounts for this price.
-     */
-    discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
 
-    /**
-     * The end date of the price interval. This is the date that the price will stop
-     * billing on the subscription. If null, billing will end when the phase or
-     * subscription ends.
-     */
-    end_date?: string | null;
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
 
-    /**
-     * The external price id of the price to add to the subscription.
-     */
-    external_price_id?: string | null;
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
-     * amount for this price.
-     */
-    maximum_amount?: string | null;
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
-     * amount for this price.
-     */
-    minimum_amount?: string | null;
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
 
-    /**
-     * The phase to add this price to.
-     */
-    plan_phase_order?: number | null;
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
 
-    /**
-     * The definition of a new price to create and add to the subscription.
-     */
-    price?:
-      | SubscriptionsAPI.NewSubscriptionUnitPrice
-      | SubscriptionsAPI.NewSubscriptionPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPrice
-      | SubscriptionsAPI.NewSubscriptionTieredBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkPrice
-      | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
-      | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTierWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
-      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
-      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
-      | null;
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
 
-    /**
-     * The id of the price to add to the subscription.
-     */
-    price_id?: 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 start date of the price interval. This is the date that the price will start
-     * billing on the subscription. If null, billing will start when the phase or
-     * subscription starts.
-     */
-    start_date?: 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;
+    }
+
+    export namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      export interface GroupedWithMinMaxThresholdsConfig {
+        /**
+         * The event property used to group before applying thresholds
+         */
+        grouping_key: string;
+
+        /**
+         * The maximum amount to charge each group
+         */
+        maximum_charge: string;
+
+        /**
+         * The minimum amount to charge each group, regardless of usage
+         */
+        minimum_charge: string;
+
+        /**
+         * The base price charged per group
+         */
+        per_unit_rate: string;
+      }
+    }
   }
 
   export interface RemoveAdjustment {
@@ -4417,37 +5219,36 @@ export namespace SubscriptionCreateParams {
     minimum_amount?: string | null;
 
     /**
-     * The definition of a new price to create and add to the subscription.
+     * New subscription price request body params.
      */
     price?:
       | SubscriptionsAPI.NewSubscriptionUnitPrice
-      | SubscriptionsAPI.NewSubscriptionPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixPrice
       | SubscriptionsAPI.NewSubscriptionTieredPrice
-      | SubscriptionsAPI.NewSubscriptionTieredBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkBPSPrice
       | SubscriptionsAPI.NewSubscriptionBulkPrice
+      | SubscriptionsAPI.NewSubscriptionPackagePrice
+      | SubscriptionsAPI.NewSubscriptionMatrixPrice
       | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
       | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
       | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
       | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTierWithProrationPrice
+      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
+      | ReplacePrice.NewSubscriptionTieredWithProrationPrice
       | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice
       | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
       | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
-      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
-      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
       | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice
+      | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice
       | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice
       | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
+      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
+      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
+      | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice
       | null;
 
     /**
@@ -4455,6 +5256,267 @@ export namespace SubscriptionCreateParams {
      */
     price_id?: string | null;
   }
+
+  export namespace ReplacePrice {
+    export interface NewSubscriptionTieredWithProrationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_with_proration';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionTieredWithProrationPrice {
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      export interface TieredWithProrationConfig {
+        /**
+         * Tiers for rating based on total usage quantities into the specified tier with
+         * proration
+         */
+        tiers: Array<TieredWithProrationConfig.Tier>;
+      }
+
+      export namespace TieredWithProrationConfig {
+        /**
+         * Configuration for a single tiered with proration tier
+         */
+        export interface Tier {
+          /**
+           * Inclusive tier starting value
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Amount per unit
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
+    export interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'grouped_with_min_max_thresholds';
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      export interface GroupedWithMinMaxThresholdsConfig {
+        /**
+         * The event property used to group before applying thresholds
+         */
+        grouping_key: string;
+
+        /**
+         * The maximum amount to charge each group
+         */
+        maximum_charge: string;
+
+        /**
+         * The minimum amount to charge each group, regardless of usage
+         */
+        minimum_charge: string;
+
+        /**
+         * The base price charged per group
+         */
+        per_unit_rate: string;
+      }
+    }
+  }
 }
 
 export interface SubscriptionUpdateParams {
@@ -4698,37 +5760,36 @@ export namespace SubscriptionPriceIntervalsParams {
     minimum_amount?: number | null;
 
     /**
-     * The definition of a new price to create and add to the subscription.
+     * New floating price request body params.
      */
     price?:
       | Shared.NewFloatingUnitPrice
-      | Shared.NewFloatingPackagePrice
-      | Shared.NewFloatingMatrixPrice
-      | Shared.NewFloatingMatrixWithAllocationPrice
       | Shared.NewFloatingTieredPrice
-      | Shared.NewFloatingTieredBPSPrice
-      | Shared.NewFloatingBPSPrice
-      | Shared.NewFloatingBulkBPSPrice
       | Shared.NewFloatingBulkPrice
+      | Shared.NewFloatingPackagePrice
+      | Shared.NewFloatingMatrixPrice
       | Shared.NewFloatingThresholdTotalAmountPrice
       | Shared.NewFloatingTieredPackagePrice
-      | Shared.NewFloatingGroupedTieredPrice
-      | Shared.NewFloatingMaxGroupTieredPackagePrice
       | Shared.NewFloatingTieredWithMinimumPrice
-      | Shared.NewFloatingPackageWithAllocationPrice
+      | Shared.NewFloatingGroupedTieredPrice
       | Shared.NewFloatingTieredPackageWithMinimumPrice
+      | Shared.NewFloatingPackageWithAllocationPrice
       | Shared.NewFloatingUnitWithPercentPrice
+      | Shared.NewFloatingMatrixWithAllocationPrice
       | Shared.NewFloatingTieredWithProrationPrice
       | Shared.NewFloatingUnitWithProrationPrice
       | Shared.NewFloatingGroupedAllocationPrice
+      | Shared.NewFloatingBulkWithProrationPrice
       | Shared.NewFloatingGroupedWithProratedMinimumPrice
       | Shared.NewFloatingGroupedWithMeteredMinimumPrice
+      | Add.NewFloatingGroupedWithMinMaxThresholdsPrice
       | Shared.NewFloatingMatrixWithDisplayNamePrice
-      | Shared.NewFloatingBulkWithProrationPrice
       | Shared.NewFloatingGroupedTieredPackagePrice
+      | Shared.NewFloatingMaxGroupTieredPackagePrice
       | Shared.NewFloatingScalableMatrixWithUnitPricingPrice
       | Shared.NewFloatingScalableMatrixWithTieredPricingPrice
       | Shared.NewFloatingCumulativeGroupedBulkPrice
+      | Shared.NewFloatingMinimumCompositePrice
       | null;
 
     /**
@@ -4788,26 +5849,155 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       quantity: number;
     }
+
+    export interface NewFloatingGroupedWithMinMaxThresholdsPrice {
+      /**
+       * 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;
+
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      grouped_with_min_max_thresholds_config: NewFloatingGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'grouped_with_min_max_thresholds';
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      export interface GroupedWithMinMaxThresholdsConfig {
+        /**
+         * The event property used to group before applying thresholds
+         */
+        grouping_key: string;
+
+        /**
+         * The maximum amount to charge each group
+         */
+        maximum_charge: string;
+
+        /**
+         * The minimum amount to charge each group, regardless of usage
+         */
+        minimum_charge: string;
+
+        /**
+         * The base price charged per group
+         */
+        per_unit_rate: string;
+      }
+    }
   }
 
   export interface AddAdjustment {
+    /**
+     * The start date of the adjustment interval. This is the date that the adjustment
+     * will start affecting prices on the subscription. The adjustment will apply to
+     * invoice dates that overlap with this `start_date`. This `start_date` is treated
+     * as inclusive for in-advance prices, and exclusive for in-arrears prices.
+     */
+    start_date: (string & {}) | Shared.BillingCycleRelativeDate;
+
     /**
      * The definition of a new adjustment to create and add to the subscription.
      */
-    adjustment:
+    adjustment?:
       | Shared.NewPercentageDiscount
       | Shared.NewUsageDiscount
       | Shared.NewAmountDiscount
       | Shared.NewMinimum
-      | Shared.NewMaximum;
+      | Shared.NewMaximum
+      | null;
 
     /**
-     * The start date of the adjustment interval. This is the date that the adjustment
-     * will start affecting prices on the subscription. The adjustment will apply to
-     * invoice dates that overlap with this `start_date`. This `start_date` is treated
-     * as inclusive for in-advance prices, and exclusive for in-arrears prices.
+     * The ID of the adjustment to add to the subscription. Adjustment IDs can be
+     * re-used from existing subscriptions or plans, but adjustments associated with
+     * coupon redemptions cannot be re-used.
      */
-    start_date: (string & {}) | Shared.BillingCycleRelativeDate;
+    adjustment_id?: string | null;
 
     /**
      * The end date of the adjustment interval. This is the date that the adjustment
@@ -5108,105 +6298,365 @@ export namespace SubscriptionSchedulePlanChangeParams {
      */
     end_date?: string | null;
 
-    /**
-     * The phase to add this adjustment to.
-     */
-    plan_phase_order?: number | null;
+    /**
+     * The phase to add this adjustment to.
+     */
+    plan_phase_order?: number | null;
+
+    /**
+     * The start date of the adjustment interval. This is the date that the adjustment
+     * will start affecting prices on the subscription. If null, the adjustment will
+     * start when the phase or subscription starts.
+     */
+    start_date?: string | null;
+  }
+
+  export interface AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: Shared.NewAllocationPrice | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
+     * discounts for this price.
+     */
+    discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
+
+    /**
+     * The end date of the price interval. This is the date that the price will stop
+     * billing on the subscription. If null, billing will end when the phase or
+     * subscription ends.
+     */
+    end_date?: string | null;
+
+    /**
+     * The external price id of the price to add to the subscription.
+     */
+    external_price_id?: string | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
+     * amount for this price.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
+     * amount for this price.
+     */
+    minimum_amount?: string | null;
+
+    /**
+     * The phase to add this price to.
+     */
+    plan_phase_order?: number | null;
+
+    /**
+     * New subscription price request body params.
+     */
+    price?:
+      | SubscriptionsAPI.NewSubscriptionUnitPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPrice
+      | SubscriptionsAPI.NewSubscriptionBulkPrice
+      | SubscriptionsAPI.NewSubscriptionPackagePrice
+      | SubscriptionsAPI.NewSubscriptionMatrixPrice
+      | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
+      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
+      | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
+      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
+      | 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
+      | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice
+      | null;
+
+    /**
+     * The id of the price to add to the subscription.
+     */
+    price_id?: string | null;
+
+    /**
+     * The start date of the price interval. This is the date that the price will start
+     * billing on the subscription. If null, billing will start when the phase or
+     * subscription starts.
+     */
+    start_date?: string | null;
+  }
+
+  export namespace AddPrice {
+    export interface NewSubscriptionTieredWithProrationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_with_proration';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionTieredWithProrationPrice {
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      export interface TieredWithProrationConfig {
+        /**
+         * Tiers for rating based on total usage quantities into the specified tier with
+         * proration
+         */
+        tiers: Array<TieredWithProrationConfig.Tier>;
+      }
+
+      export namespace TieredWithProrationConfig {
+        /**
+         * Configuration for a single tiered with proration tier
+         */
+        export interface Tier {
+          /**
+           * Inclusive tier starting value
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Amount per unit
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
+    export interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'grouped_with_min_max_thresholds';
+
+      /**
+       * 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 start date of the adjustment interval. This is the date that the adjustment
-     * will start affecting prices on the subscription. If null, the adjustment will
-     * start when the phase or subscription starts.
-     */
-    start_date?: string | null;
-  }
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
 
-  export interface AddPrice {
-    /**
-     * The definition of a new allocation price to create and add to the subscription.
-     */
-    allocation_price?: Shared.NewAllocationPrice | null;
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
-     * discounts for this price.
-     */
-    discounts?: Array<SubscriptionsAPI.DiscountOverride> | null;
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
 
-    /**
-     * The end date of the price interval. This is the date that the price will stop
-     * billing on the subscription. If null, billing will end when the phase or
-     * subscription ends.
-     */
-    end_date?: string | null;
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
 
-    /**
-     * The external price id of the price to add to the subscription.
-     */
-    external_price_id?: string | null;
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's maximum
-     * amount for this price.
-     */
-    maximum_amount?: string | null;
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
 
-    /**
-     * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's minimum
-     * amount for this price.
-     */
-    minimum_amount?: string | null;
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
 
-    /**
-     * The phase to add this price to.
-     */
-    plan_phase_order?: number | 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 definition of a new price to create and add to the subscription.
-     */
-    price?:
-      | SubscriptionsAPI.NewSubscriptionUnitPrice
-      | SubscriptionsAPI.NewSubscriptionPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPrice
-      | SubscriptionsAPI.NewSubscriptionTieredBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkPrice
-      | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
-      | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTierWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
-      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
-      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
-      | 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;
 
-    /**
-     * The id of the price to add to the subscription.
-     */
-    price_id?: string | null;
+      /**
+       * A transient ID that can be used to reference this price when adding adjustments
+       * in the same API call.
+       */
+      reference_id?: string | null;
+    }
 
-    /**
-     * The start date of the price interval. This is the date that the price will start
-     * billing on the subscription. If null, billing will start when the phase or
-     * subscription starts.
-     */
-    start_date?: string | null;
+    export namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      export interface GroupedWithMinMaxThresholdsConfig {
+        /**
+         * The event property used to group before applying thresholds
+         */
+        grouping_key: string;
+
+        /**
+         * The maximum amount to charge each group
+         */
+        maximum_charge: string;
+
+        /**
+         * The minimum amount to charge each group, regardless of usage
+         */
+        minimum_charge: string;
+
+        /**
+         * The base price charged per group
+         */
+        per_unit_rate: string;
+      }
+    }
   }
 
   export interface RemoveAdjustment {
@@ -5285,37 +6735,36 @@ export namespace SubscriptionSchedulePlanChangeParams {
     minimum_amount?: string | null;
 
     /**
-     * The definition of a new price to create and add to the subscription.
+     * New subscription price request body params.
      */
     price?:
       | SubscriptionsAPI.NewSubscriptionUnitPrice
-      | SubscriptionsAPI.NewSubscriptionPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixPrice
       | SubscriptionsAPI.NewSubscriptionTieredPrice
-      | SubscriptionsAPI.NewSubscriptionTieredBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBPSPrice
-      | SubscriptionsAPI.NewSubscriptionBulkBPSPrice
       | SubscriptionsAPI.NewSubscriptionBulkPrice
+      | SubscriptionsAPI.NewSubscriptionPackagePrice
+      | SubscriptionsAPI.NewSubscriptionMatrixPrice
       | SubscriptionsAPI.NewSubscriptionThresholdTotalAmountPrice
       | SubscriptionsAPI.NewSubscriptionTieredPackagePrice
       | SubscriptionsAPI.NewSubscriptionTieredWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
       | SubscriptionsAPI.NewSubscriptionPackageWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTierWithProrationPrice
+      | SubscriptionsAPI.NewSubscriptionUnitWithPercentPrice
+      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
+      | ReplacePrice.NewSubscriptionTieredWithProrationPrice
       | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice
       | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
       | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
-      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
-      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
-      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice
       | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice
+      | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice
       | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice
       | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice
-      | SubscriptionsAPI.NewSubscriptionMatrixWithAllocationPrice
-      | SubscriptionsAPI.NewSubscriptionTieredPackageWithMinimumPrice
-      | SubscriptionsAPI.NewSubscriptionGroupedTieredPrice
+      | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice
+      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice
+      | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice
+      | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice
+      | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice
       | null;
 
     /**
@@ -5323,6 +6772,267 @@ export namespace SubscriptionSchedulePlanChangeParams {
      */
     price_id?: string | null;
   }
+
+  export namespace ReplacePrice {
+    export interface NewSubscriptionTieredWithProrationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_with_proration';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      tiered_with_proration_config: NewSubscriptionTieredWithProrationPrice.TieredWithProrationConfig;
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionTieredWithProrationPrice {
+      /**
+       * Configuration for tiered_with_proration pricing
+       */
+      export interface TieredWithProrationConfig {
+        /**
+         * Tiers for rating based on total usage quantities into the specified tier with
+         * proration
+         */
+        tiers: Array<TieredWithProrationConfig.Tier>;
+      }
+
+      export namespace TieredWithProrationConfig {
+        /**
+         * Configuration for a single tiered with proration tier
+         */
+        export interface Tier {
+          /**
+           * Inclusive tier starting value
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Amount per unit
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
+    export interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      grouped_with_min_max_thresholds_config: NewSubscriptionGroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'grouped_with_min_max_thresholds';
+
+      /**
+       * 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;
+
+      /**
+       * 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;
+    }
+
+    export namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+      /**
+       * Configuration for grouped_with_min_max_thresholds pricing
+       */
+      export interface GroupedWithMinMaxThresholdsConfig {
+        /**
+         * The event property used to group before applying thresholds
+         */
+        grouping_key: string;
+
+        /**
+         * The maximum amount to charge each group
+         */
+        maximum_charge: string;
+
+        /**
+         * The minimum amount to charge each group, regardless of usage
+         */
+        minimum_charge: string;
+
+        /**
+         * The base price charged per group
+         */
+        per_unit_rate: string;
+      }
+    }
+  }
 }
 
 export interface SubscriptionTriggerPhaseParams {
@@ -5397,8 +7107,6 @@ Subscriptions.SubscriptionFetchScheduleResponsesPage = SubscriptionFetchSchedule
 export declare namespace Subscriptions {
   export {
     type DiscountOverride as DiscountOverride,
-    type NewSubscriptionBPSPrice as NewSubscriptionBPSPrice,
-    type NewSubscriptionBulkBPSPrice as NewSubscriptionBulkBPSPrice,
     type NewSubscriptionBulkPrice as NewSubscriptionBulkPrice,
     type NewSubscriptionBulkWithProrationPrice as NewSubscriptionBulkWithProrationPrice,
     type NewSubscriptionCumulativeGroupedBulkPrice as NewSubscriptionCumulativeGroupedBulkPrice,
@@ -5411,13 +7119,12 @@ export declare namespace Subscriptions {
     type NewSubscriptionMatrixWithAllocationPrice as NewSubscriptionMatrixWithAllocationPrice,
     type NewSubscriptionMatrixWithDisplayNamePrice as NewSubscriptionMatrixWithDisplayNamePrice,
     type NewSubscriptionMaxGroupTieredPackagePrice as NewSubscriptionMaxGroupTieredPackagePrice,
+    type NewSubscriptionMinimumCompositePrice as NewSubscriptionMinimumCompositePrice,
     type NewSubscriptionPackagePrice as NewSubscriptionPackagePrice,
     type NewSubscriptionPackageWithAllocationPrice as NewSubscriptionPackageWithAllocationPrice,
     type NewSubscriptionScalableMatrixWithTieredPricingPrice as NewSubscriptionScalableMatrixWithTieredPricingPrice,
     type NewSubscriptionScalableMatrixWithUnitPricingPrice as NewSubscriptionScalableMatrixWithUnitPricingPrice,
     type NewSubscriptionThresholdTotalAmountPrice as NewSubscriptionThresholdTotalAmountPrice,
-    type NewSubscriptionTierWithProrationPrice as NewSubscriptionTierWithProrationPrice,
-    type NewSubscriptionTieredBPSPrice as NewSubscriptionTieredBPSPrice,
     type NewSubscriptionTieredPackagePrice as NewSubscriptionTieredPackagePrice,
     type NewSubscriptionTieredPackageWithMinimumPrice as NewSubscriptionTieredPackageWithMinimumPrice,
     type NewSubscriptionTieredPrice as NewSubscriptionTieredPrice,