orb-billing 5.6.0 → 5.8.0

package/resources/subscriptions.d.ts

@@ -927,6 +927,9 @@ export interface DiscountOverride {
     usage_discount?: number | null;
 }
 export interface NewSubscriptionBulkPrice {
+    /**
+     * Configuration for bulk pricing
+     */
     bulk_config: Shared.BulkConfig;
     /**
      * The cadence to bill for this price on.
@@ -936,6 +939,9 @@ export interface NewSubscriptionBulkPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'bulk';
     /**
      * The name of the price.
@@ -1006,9 +1012,10 @@ export interface NewSubscriptionBulkPrice {
     reference_id?: string | null;
 }
 export interface NewSubscriptionBulkWithProrationPrice {
-    bulk_with_proration_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * Configuration for bulk_with_proration pricing
+     */
+    bulk_with_proration_config: NewSubscriptionBulkWithProrationPrice.BulkWithProrationConfig;
     /**
      * The cadence to bill for this price on.
      */
@@ -1017,6 +1024,9 @@ export interface NewSubscriptionBulkWithProrationPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'bulk_with_proration';
     /**
      * The name of the price.
@@ -1086,18 +1096,48 @@ export interface NewSubscriptionBulkWithProrationPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionBulkWithProrationPrice {
+    /**
+     * Configuration for bulk_with_proration pricing
+     */
+    interface BulkWithProrationConfig {
+        /**
+         * Bulk tiers for rating based on total usage volume
+         */
+        tiers: Array<BulkWithProrationConfig.Tier>;
+    }
+    namespace BulkWithProrationConfig {
+        /**
+         * Configuration for a single bulk pricing tier with proration
+         */
+        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';
-    cumulative_grouped_bulk_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * 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;
+    /**
+     * The pricing model type
+     */
     model_type: 'cumulative_grouped_bulk';
     /**
      * The name of the price.
@@ -1167,18 +1207,56 @@ export interface NewSubscriptionCumulativeGroupedBulkPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionCumulativeGroupedBulkPrice {
+    /**
+     * Configuration for cumulative_grouped_bulk pricing
+     */
+    interface CumulativeGroupedBulkConfig {
+        /**
+         * Each tier lower bound must have the same group of values.
+         */
+        dimension_values: Array<CumulativeGroupedBulkConfig.DimensionValue>;
+        /**
+         * Grouping key name
+         */
+        group: string;
+    }
+    namespace CumulativeGroupedBulkConfig {
+        /**
+         * Configuration for a dimension value entry
+         */
+        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';
-    grouped_allocation_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * Configuration for grouped_allocation pricing
+     */
+    grouped_allocation_config: NewSubscriptionGroupedAllocationPrice.GroupedAllocationConfig;
     /**
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'grouped_allocation';
     /**
      * The name of the price.
@@ -1248,18 +1326,41 @@ export interface NewSubscriptionGroupedAllocationPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionGroupedAllocationPrice {
+    /**
+     * Configuration for grouped_allocation pricing
+     */
+    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';
-    grouped_tiered_package_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;
+    /**
+     * The pricing model type
+     */
     model_type: 'grouped_tiered_package';
     /**
      * The name of the price.
@@ -1329,18 +1430,57 @@ export interface NewSubscriptionGroupedTieredPackagePrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionGroupedTieredPackagePrice {
+    /**
+     * Configuration for grouped_tiered_package pricing
+     */
+    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>;
+    }
+    namespace GroupedTieredPackageConfig {
+        /**
+         * Configuration for a single tier
+         */
+        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_tiered_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;
+    /**
+     * The pricing model type
+     */
     model_type: 'grouped_tiered';
     /**
      * The name of the price.
@@ -1410,18 +1550,53 @@ export interface NewSubscriptionGroupedTieredPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionGroupedTieredPrice {
+    /**
+     * Configuration for grouped_tiered pricing
+     */
+    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>;
+    }
+    namespace GroupedTieredConfig {
+        /**
+         * Configuration for a single tier
+         */
+        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_with_metered_minimum_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;
+    /**
+     * The pricing model type
+     */
     model_type: 'grouped_with_metered_minimum';
     /**
      * The name of the price.
@@ -1491,18 +1666,83 @@ export interface NewSubscriptionGroupedWithMeteredMinimumPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionGroupedWithMeteredMinimumPrice {
+    /**
+     * Configuration for grouped_with_metered_minimum pricing
+     */
+    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>;
+    }
+    namespace GroupedWithMeteredMinimumConfig {
+        /**
+         * Configuration for a scaling factor
+         */
+        interface ScalingFactor {
+            /**
+             * Scaling factor
+             */
+            scaling_factor: string;
+            /**
+             * Scaling value
+             */
+            scaling_value: string;
+        }
+        /**
+         * Configuration for a unit amount
+         */
+        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_with_prorated_minimum_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;
+    /**
+     * The pricing model type
+     */
     model_type: 'grouped_with_prorated_minimum';
     /**
      * The name of the price.
@@ -1572,6 +1812,25 @@ export interface NewSubscriptionGroupedWithProratedMinimumPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionGroupedWithProratedMinimumPrice {
+    /**
+     * Configuration for grouped_with_prorated_minimum pricing
+     */
+    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.
@@ -1581,7 +1840,13 @@ export interface NewSubscriptionMatrixPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * Configuration for matrix pricing
+     */
     matrix_config: Shared.MatrixConfig;
+    /**
+     * The pricing model type
+     */
     model_type: 'matrix';
     /**
      * The name of the price.
@@ -1660,7 +1925,13 @@ export interface NewSubscriptionMatrixWithAllocationPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * 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.
@@ -1739,9 +2010,13 @@ export interface NewSubscriptionMatrixWithDisplayNamePrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
-    matrix_with_display_name_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * Configuration for matrix_with_display_name pricing
+     */
+    matrix_with_display_name_config: NewSubscriptionMatrixWithDisplayNamePrice.MatrixWithDisplayNameConfig;
+    /**
+     * The pricing model type
+     */
     model_type: 'matrix_with_display_name';
     /**
      * The name of the price.
@@ -1811,6 +2086,40 @@ export interface NewSubscriptionMatrixWithDisplayNamePrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionMatrixWithDisplayNamePrice {
+    /**
+     * Configuration for matrix_with_display_name pricing
+     */
+    interface MatrixWithDisplayNameConfig {
+        /**
+         * Used to determine the unit rate
+         */
+        dimension: string;
+        /**
+         * Apply per unit pricing to each dimension value
+         */
+        unit_amounts: Array<MatrixWithDisplayNameConfig.UnitAmount>;
+    }
+    namespace MatrixWithDisplayNameConfig {
+        /**
+         * Configuration for a unit amount item
+         */
+        interface UnitAmount {
+            /**
+             * The dimension value
+             */
+            dimension_value: string;
+            /**
+             * 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.
@@ -1820,9 +2129,13 @@ export interface NewSubscriptionMaxGroupTieredPackagePrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
-    max_group_tiered_package_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * 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.
@@ -1892,6 +2205,40 @@ export interface NewSubscriptionMaxGroupTieredPackagePrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionMaxGroupTieredPackagePrice {
+    /**
+     * Configuration for max_group_tiered_package pricing
+     */
+    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>;
+    }
+    namespace MaxGroupTieredPackageConfig {
+        /**
+         * Configuration for a single tier
+         */
+        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.
@@ -1901,7 +2248,13 @@ export interface NewSubscriptionMinimumCompositePrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * Configuration for minimum pricing
+     */
     minimum_config: NewSubscriptionMinimumCompositePrice.MinimumConfig;
+    /**
+     * The pricing model type
+     */
     model_type: 'minimum';
     /**
      * The name of the price.
@@ -1972,16 +2325,18 @@ export interface NewSubscriptionMinimumCompositePrice {
     reference_id?: string | null;
 }
 export declare namespace NewSubscriptionMinimumCompositePrice {
+    /**
+     * Configuration for minimum pricing
+     */
     interface MinimumConfig {
         /**
          * The minimum amount to apply
          */
         minimum_amount: string;
         /**
-         * By default, subtotals from minimum composite prices are prorated based on the
-         * service period. Set to false to disable proration.
+         * If true, subtotals from this price are prorated based on the service period
          */
-        prorated?: boolean | null;
+        prorated?: boolean;
     }
 }
 export interface NewSubscriptionPackagePrice {
@@ -1993,11 +2348,17 @@ export interface NewSubscriptionPackagePrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * 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
@@ -2072,14 +2433,18 @@ export interface NewSubscriptionPackageWithAllocationPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'package_with_allocation';
     /**
      * The name of the price.
      */
     name: string;
-    package_with_allocation_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * 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
      * usage-based.
@@ -2144,6 +2509,25 @@ export interface NewSubscriptionPackageWithAllocationPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionPackageWithAllocationPrice {
+    /**
+     * Configuration for package_with_allocation pricing
+     */
+    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.
@@ -2153,14 +2537,18 @@ export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'scalable_matrix_with_tiered_pricing';
     /**
      * The name of the price.
      */
     name: string;
-    scalable_matrix_with_tiered_pricing_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
      * usage-based.
@@ -2225,88 +2613,62 @@ export interface NewSubscriptionScalableMatrixWithTieredPricingPrice {
      */
     reference_id?: string | null;
 }
-export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
-    /**
-     * 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: 'scalable_matrix_with_unit_pricing';
+export declare namespace NewSubscriptionScalableMatrixWithTieredPricingPrice {
     /**
-     * The name of the price.
+     * Configuration for scalable_matrix_with_tiered_pricing pricing
      */
-    name: string;
-    scalable_matrix_with_unit_pricing_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;
+    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;
+    }
+    namespace ScalableMatrixWithTieredPricingConfig {
+        /**
+         * Configuration for a single matrix scaling factor
+         */
+        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
+         */
+        interface Tier {
+            /**
+             * Tier lower bound
+             */
+            tier_lower_bound: string;
+            /**
+             * Per unit amount
+             */
+            unit_amount: string;
+        }
+    }
 }
-export interface NewSubscriptionThresholdTotalAmountPrice {
+export interface NewSubscriptionScalableMatrixWithUnitPricingPrice {
     /**
      * The cadence to bill for this price on.
      */
@@ -2315,14 +2677,18 @@ export interface NewSubscriptionThresholdTotalAmountPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
-    model_type: 'threshold_total_amount';
+    /**
+     * The pricing model type
+     */
+    model_type: 'scalable_matrix_with_unit_pricing';
     /**
      * The name of the price.
      */
     name: string;
-    threshold_total_amount_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
      * usage-based.
@@ -2387,7 +2753,53 @@ export interface NewSubscriptionThresholdTotalAmountPrice {
      */
     reference_id?: string | null;
 }
-export interface NewSubscriptionTierWithProrationPrice {
+export declare namespace NewSubscriptionScalableMatrixWithUnitPricingPrice {
+    /**
+     * Configuration for scalable_matrix_with_unit_pricing pricing
+     */
+    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;
+    }
+    namespace ScalableMatrixWithUnitPricingConfig {
+        /**
+         * Configuration for a single matrix scaling factor
+         */
+        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.
      */
@@ -2396,14 +2808,18 @@ export interface NewSubscriptionTierWithProrationPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
-    model_type: 'tiered_with_proration';
+    /**
+     * The pricing model type
+     */
+    model_type: 'threshold_total_amount';
     /**
      * The name of the price.
      */
     name: string;
-    tiered_with_proration_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
      * usage-based.
@@ -2468,6 +2884,37 @@ export interface NewSubscriptionTierWithProrationPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionThresholdTotalAmountPrice {
+    /**
+     * Configuration for threshold_total_amount pricing
+     */
+    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;
+    }
+    namespace ThresholdTotalAmountConfig {
+        /**
+         * Configuration for a single threshold
+         */
+        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.
@@ -2477,14 +2924,18 @@ export interface NewSubscriptionTieredPackagePrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'tiered_package';
     /**
      * The name of the price.
      */
     name: string;
-    tiered_package_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
      * usage-based.
@@ -2549,6 +3000,39 @@ export interface NewSubscriptionTieredPackagePrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionTieredPackagePrice {
+    /**
+     * Configuration for tiered_package pricing
+     */
+    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. The tier bounds are defined based on
+         * the total quantity rather than the number of packages, so they must be multiples
+         * of the package size.
+         */
+        tiers: Array<TieredPackageConfig.Tier>;
+    }
+    namespace TieredPackageConfig {
+        /**
+         * Configuration for a single tier with business logic
+         */
+        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.
@@ -2558,14 +3042,18 @@ export interface NewSubscriptionTieredPackageWithMinimumPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'tiered_package_with_minimum';
     /**
      * The name of the price.
      */
     name: string;
-    tiered_package_with_minimum_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
      * usage-based.
@@ -2630,6 +3118,41 @@ export interface NewSubscriptionTieredPackageWithMinimumPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionTieredPackageWithMinimumPrice {
+    /**
+     * Configuration for tiered_package_with_minimum pricing
+     */
+    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>;
+    }
+    namespace TieredPackageWithMinimumConfig {
+        /**
+         * Configuration for a single tier
+         */
+        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.
@@ -2639,11 +3162,17 @@ export interface NewSubscriptionTieredPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'tiered';
     /**
      * The name of the price.
      */
     name: string;
+    /**
+     * Configuration for tiered pricing
+     */
     tiered_config: Shared.TieredConfig;
     /**
      * The id of the billable metric for the price. Only needed if the price is
@@ -2718,14 +3247,18 @@ export interface NewSubscriptionTieredWithMinimumPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'tiered_with_minimum';
     /**
      * The name of the price.
      */
     name: string;
-    tiered_with_minimum_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
      * usage-based.
@@ -2790,6 +3323,45 @@ export interface NewSubscriptionTieredWithMinimumPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionTieredWithMinimumPrice {
+    /**
+     * Configuration for tiered_with_minimum pricing
+     */
+    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;
+    }
+    namespace TieredWithMinimumConfig {
+        /**
+         * Configuration for a single tier
+         */
+        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.
@@ -2799,11 +3371,17 @@ export interface NewSubscriptionUnitPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'unit';
     /**
      * The name of the price.
      */
     name: string;
+    /**
+     * Configuration for unit pricing
+     */
     unit_config: Shared.UnitConfig;
     /**
      * The id of the billable metric for the price. Only needed if the price is
@@ -2878,14 +3456,18 @@ export interface NewSubscriptionUnitWithPercentPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'unit_with_percent';
     /**
      * The name of the price.
      */
     name: string;
-    unit_with_percent_config: {
-        [key: string]: unknown;
-    };
+    /**
+     * 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
      * usage-based.
@@ -2950,6 +3532,21 @@ export interface NewSubscriptionUnitWithPercentPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionUnitWithPercentPrice {
+    /**
+     * Configuration for unit_with_percent pricing
+     */
+    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.
@@ -2959,14 +3556,18 @@ export interface NewSubscriptionUnitWithProrationPrice {
      * The id of the item the price will be associated with.
      */
     item_id: string;
+    /**
+     * The pricing model type
+     */
     model_type: 'unit_with_proration';
     /**
      * The name of the price.
      */
     name: string;
-    unit_with_proration_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
      * usage-based.
@@ -3031,6 +3632,17 @@ export interface NewSubscriptionUnitWithProrationPrice {
      */
     reference_id?: string | null;
 }
+export declare namespace NewSubscriptionUnitWithProrationPrice {
+    /**
+     * Configuration for unit_with_proration pricing
+     */
+    interface UnitWithProrationConfig {
+        /**
+         * Rate per unit of usage
+         */
+        unit_amount: string;
+    }
+}
 /**
  * A [subscription](/core-concepts#subscription) represents the purchase of a plan
  * by a customer.
@@ -3465,9 +4077,9 @@ export declare namespace SubscriptionCreateParams {
          */
         plan_phase_order?: number | 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.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 | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
+        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.
          */
@@ -3480,23 +4092,27 @@ export declare namespace SubscriptionCreateParams {
         start_date?: string | null;
     }
     namespace AddPrice {
-        interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+        interface NewSubscriptionTieredWithProrationPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            grouped_with_min_max_thresholds_config: {
-                [key: string]: unknown;
-            };
             /**
              * The id of the item the price will be associated with.
              */
             item_id: string;
-            model_type: 'grouped_with_min_max_thresholds';
+            /**
+             * 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.
@@ -3561,13 +4177,148 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
-    }
-    interface RemoveAdjustment {
-        /**
-         * The id of the adjustment to remove on the subscription.
-         */
-        adjustment_id: string;
-    }
+        namespace NewSubscriptionTieredWithProrationPrice {
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            interface TieredWithProrationConfig {
+                /**
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
+                /**
+                 * Configuration for a single tiered with proration tier
+                 */
+                interface Tier {
+                    /**
+                     * Inclusive tier starting value
+                     */
+                    tier_lower_bound: string;
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
+        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;
+        }
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            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;
+            }
+        }
+    }
+    interface RemoveAdjustment {
+        /**
+         * The id of the adjustment to remove on the subscription.
+         */
+        adjustment_id: string;
+    }
     interface RemovePrice {
         /**
          * The external price id of the price to remove on the subscription.
@@ -3621,27 +4372,143 @@ export declare 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.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 | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
+        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 | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
         /**
          * The id of the price to add to the subscription.
          */
         price_id?: string | null;
     }
     namespace ReplacePrice {
+        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;
+        }
+        namespace NewSubscriptionTieredWithProrationPrice {
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            interface TieredWithProrationConfig {
+                /**
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
+                /**
+                 * Configuration for a single tiered with proration tier
+                 */
+                interface Tier {
+                    /**
+                     * Inclusive tier starting value
+                     */
+                    tier_lower_bound: string;
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            grouped_with_min_max_thresholds_config: {
-                [key: string]: unknown;
-            };
+            /**
+             * 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.
@@ -3711,6 +4578,29 @@ export declare namespace SubscriptionCreateParams {
              */
             reference_id?: string | null;
         }
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            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 {
@@ -3905,9 +4795,9 @@ export declare 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.NewFloatingBulkPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingGroupedTieredPrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | Shared.NewFloatingPackageWithAllocationPrice | Shared.NewFloatingTieredPackageWithMinimumPrice | Shared.NewFloatingUnitWithPercentPrice | Shared.NewFloatingTieredWithProrationPrice | Shared.NewFloatingUnitWithProrationPrice | Shared.NewFloatingGroupedAllocationPrice | Shared.NewFloatingGroupedWithProratedMinimumPrice | Shared.NewFloatingGroupedWithMeteredMinimumPrice | Shared.NewFloatingMatrixWithDisplayNamePrice | Shared.NewFloatingBulkWithProrationPrice | Shared.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Add.NewFloatingGroupedWithMinMaxThresholdsPrice | Shared.NewFloatingMinimumCompositePrice | null;
+        price?: Shared.NewFloatingUnitPrice | Shared.NewFloatingTieredPrice | Shared.NewFloatingBulkPrice | Shared.NewFloatingPackagePrice | Shared.NewFloatingMatrixPrice | Shared.NewFloatingThresholdTotalAmountPrice | Shared.NewFloatingTieredPackagePrice | Shared.NewFloatingTieredWithMinimumPrice | 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.NewFloatingGroupedTieredPackagePrice | Shared.NewFloatingMaxGroupTieredPackagePrice | Shared.NewFloatingScalableMatrixWithUnitPricingPrice | Shared.NewFloatingScalableMatrixWithTieredPricingPrice | Shared.NewFloatingCumulativeGroupedBulkPrice | Shared.NewFloatingMinimumCompositePrice | null;
         /**
          * The id of the price to add to the subscription.
          */
@@ -3965,13 +4855,17 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * An ISO 4217 currency string for which this price is billed in.
              */
             currency: string;
-            grouped_with_min_max_thresholds_config: {
-                [key: string]: unknown;
-            };
+            /**
+             * 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.
@@ -4031,6 +4925,29 @@ export declare namespace SubscriptionPriceIntervalsParams {
                 [key: string]: string | null;
             } | null;
         }
+        namespace NewFloatingGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            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;
+            }
+        }
     }
     interface AddAdjustment {
         /**
@@ -4344,9 +5261,9 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
          */
         plan_phase_order?: number | 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.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 | AddPrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
+        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.
          */
@@ -4359,18 +5276,134 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
         start_date?: string | null;
     }
     namespace AddPrice {
+        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;
+        }
+        namespace NewSubscriptionTieredWithProrationPrice {
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            interface TieredWithProrationConfig {
+                /**
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
+                /**
+                 * Configuration for a single tiered with proration tier
+                 */
+                interface Tier {
+                    /**
+                     * Inclusive tier starting value
+                     */
+                    tier_lower_bound: string;
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            grouped_with_min_max_thresholds_config: {
-                [key: string]: unknown;
-            };
+            /**
+             * 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.
@@ -4440,6 +5473,29 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            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;
+            }
+        }
     }
     interface RemoveAdjustment {
         /**
@@ -4500,27 +5556,143 @@ export declare 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.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 | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
+        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 | ReplacePrice.NewSubscriptionTieredWithProrationPrice | SubscriptionsAPI.NewSubscriptionUnitWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedAllocationPrice | SubscriptionsAPI.NewSubscriptionBulkWithProrationPrice | SubscriptionsAPI.NewSubscriptionGroupedWithProratedMinimumPrice | SubscriptionsAPI.NewSubscriptionGroupedWithMeteredMinimumPrice | ReplacePrice.NewSubscriptionGroupedWithMinMaxThresholdsPrice | SubscriptionsAPI.NewSubscriptionMatrixWithDisplayNamePrice | SubscriptionsAPI.NewSubscriptionGroupedTieredPackagePrice | SubscriptionsAPI.NewSubscriptionMaxGroupTieredPackagePrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithUnitPricingPrice | SubscriptionsAPI.NewSubscriptionScalableMatrixWithTieredPricingPrice | SubscriptionsAPI.NewSubscriptionCumulativeGroupedBulkPrice | SubscriptionsAPI.NewSubscriptionMinimumCompositePrice | null;
         /**
          * The id of the price to add to the subscription.
          */
         price_id?: string | null;
     }
     namespace ReplacePrice {
+        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;
+        }
+        namespace NewSubscriptionTieredWithProrationPrice {
+            /**
+             * Configuration for tiered_with_proration pricing
+             */
+            interface TieredWithProrationConfig {
+                /**
+                 * Tiers for rating based on total usage quantities into the specified tier with
+                 * proration
+                 */
+                tiers: Array<TieredWithProrationConfig.Tier>;
+            }
+            namespace TieredWithProrationConfig {
+                /**
+                 * Configuration for a single tiered with proration tier
+                 */
+                interface Tier {
+                    /**
+                     * Inclusive tier starting value
+                     */
+                    tier_lower_bound: string;
+                    /**
+                     * Amount per unit
+                     */
+                    unit_amount: string;
+                }
+            }
+        }
         interface NewSubscriptionGroupedWithMinMaxThresholdsPrice {
             /**
              * The cadence to bill for this price on.
              */
             cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
-            grouped_with_min_max_thresholds_config: {
-                [key: string]: unknown;
-            };
+            /**
+             * 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.
@@ -4590,6 +5762,29 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
              */
             reference_id?: string | null;
         }
+        namespace NewSubscriptionGroupedWithMinMaxThresholdsPrice {
+            /**
+             * Configuration for grouped_with_min_max_thresholds pricing
+             */
+            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 {
@@ -4649,6 +5844,6 @@ export interface SubscriptionUpdateTrialParams {
     shift?: boolean;
 }
 export declare namespace Subscriptions {
-    export { type DiscountOverride as DiscountOverride, type NewSubscriptionBulkPrice as NewSubscriptionBulkPrice, type NewSubscriptionBulkWithProrationPrice as NewSubscriptionBulkWithProrationPrice, type NewSubscriptionCumulativeGroupedBulkPrice as NewSubscriptionCumulativeGroupedBulkPrice, type NewSubscriptionGroupedAllocationPrice as NewSubscriptionGroupedAllocationPrice, type NewSubscriptionGroupedTieredPackagePrice as NewSubscriptionGroupedTieredPackagePrice, type NewSubscriptionGroupedTieredPrice as NewSubscriptionGroupedTieredPrice, type NewSubscriptionGroupedWithMeteredMinimumPrice as NewSubscriptionGroupedWithMeteredMinimumPrice, type NewSubscriptionGroupedWithProratedMinimumPrice as NewSubscriptionGroupedWithProratedMinimumPrice, type NewSubscriptionMatrixPrice as NewSubscriptionMatrixPrice, 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 NewSubscriptionTieredPackagePrice as NewSubscriptionTieredPackagePrice, type NewSubscriptionTieredPackageWithMinimumPrice as NewSubscriptionTieredPackageWithMinimumPrice, type NewSubscriptionTieredPrice as NewSubscriptionTieredPrice, type NewSubscriptionTieredWithMinimumPrice as NewSubscriptionTieredWithMinimumPrice, type NewSubscriptionUnitPrice as NewSubscriptionUnitPrice, type NewSubscriptionUnitWithPercentPrice as NewSubscriptionUnitWithPercentPrice, type NewSubscriptionUnitWithProrationPrice as NewSubscriptionUnitWithProrationPrice, type Subscription as Subscription, type SubscriptionUsage as SubscriptionUsage, type Subscriptions as Subscriptions, type SubscriptionFetchCostsResponse as SubscriptionFetchCostsResponse, type SubscriptionFetchScheduleResponse as SubscriptionFetchScheduleResponse, SubscriptionsPage as SubscriptionsPage, SubscriptionFetchScheduleResponsesPage as SubscriptionFetchScheduleResponsesPage, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionUpdateParams as SubscriptionUpdateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionCancelParams as SubscriptionCancelParams, type SubscriptionFetchCostsParams as SubscriptionFetchCostsParams, type SubscriptionFetchScheduleParams as SubscriptionFetchScheduleParams, type SubscriptionFetchUsageParams as SubscriptionFetchUsageParams, type SubscriptionPriceIntervalsParams as SubscriptionPriceIntervalsParams, type SubscriptionRedeemCouponParams as SubscriptionRedeemCouponParams, type SubscriptionSchedulePlanChangeParams as SubscriptionSchedulePlanChangeParams, type SubscriptionTriggerPhaseParams as SubscriptionTriggerPhaseParams, type SubscriptionUnscheduleFixedFeeQuantityUpdatesParams as SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, type SubscriptionUpdateFixedFeeQuantityParams as SubscriptionUpdateFixedFeeQuantityParams, type SubscriptionUpdateTrialParams as SubscriptionUpdateTrialParams, };
+    export { type DiscountOverride as DiscountOverride, type NewSubscriptionBulkPrice as NewSubscriptionBulkPrice, type NewSubscriptionBulkWithProrationPrice as NewSubscriptionBulkWithProrationPrice, type NewSubscriptionCumulativeGroupedBulkPrice as NewSubscriptionCumulativeGroupedBulkPrice, type NewSubscriptionGroupedAllocationPrice as NewSubscriptionGroupedAllocationPrice, type NewSubscriptionGroupedTieredPackagePrice as NewSubscriptionGroupedTieredPackagePrice, type NewSubscriptionGroupedTieredPrice as NewSubscriptionGroupedTieredPrice, type NewSubscriptionGroupedWithMeteredMinimumPrice as NewSubscriptionGroupedWithMeteredMinimumPrice, type NewSubscriptionGroupedWithProratedMinimumPrice as NewSubscriptionGroupedWithProratedMinimumPrice, type NewSubscriptionMatrixPrice as NewSubscriptionMatrixPrice, 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 NewSubscriptionTieredPackagePrice as NewSubscriptionTieredPackagePrice, type NewSubscriptionTieredPackageWithMinimumPrice as NewSubscriptionTieredPackageWithMinimumPrice, type NewSubscriptionTieredPrice as NewSubscriptionTieredPrice, type NewSubscriptionTieredWithMinimumPrice as NewSubscriptionTieredWithMinimumPrice, type NewSubscriptionUnitPrice as NewSubscriptionUnitPrice, type NewSubscriptionUnitWithPercentPrice as NewSubscriptionUnitWithPercentPrice, type NewSubscriptionUnitWithProrationPrice as NewSubscriptionUnitWithProrationPrice, type Subscription as Subscription, type SubscriptionUsage as SubscriptionUsage, type Subscriptions as Subscriptions, type SubscriptionFetchCostsResponse as SubscriptionFetchCostsResponse, type SubscriptionFetchScheduleResponse as SubscriptionFetchScheduleResponse, SubscriptionsPage as SubscriptionsPage, SubscriptionFetchScheduleResponsesPage as SubscriptionFetchScheduleResponsesPage, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionUpdateParams as SubscriptionUpdateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionCancelParams as SubscriptionCancelParams, type SubscriptionFetchCostsParams as SubscriptionFetchCostsParams, type SubscriptionFetchScheduleParams as SubscriptionFetchScheduleParams, type SubscriptionFetchUsageParams as SubscriptionFetchUsageParams, type SubscriptionPriceIntervalsParams as SubscriptionPriceIntervalsParams, type SubscriptionRedeemCouponParams as SubscriptionRedeemCouponParams, type SubscriptionSchedulePlanChangeParams as SubscriptionSchedulePlanChangeParams, type SubscriptionTriggerPhaseParams as SubscriptionTriggerPhaseParams, type SubscriptionUnscheduleFixedFeeQuantityUpdatesParams as SubscriptionUnscheduleFixedFeeQuantityUpdatesParams, type SubscriptionUpdateFixedFeeQuantityParams as SubscriptionUpdateFixedFeeQuantityParams, type SubscriptionUpdateTrialParams as SubscriptionUpdateTrialParams, };
 }
 //# sourceMappingURL=subscriptions.d.ts.map