orb-billing 4.72.3 → 4.74.0

package/resources/plans/plans.d.ts

@@ -15,7 +15,7 @@ export declare class Plans extends APIResource {
      * This endpoint can be used to update the `external_plan_id`, and `metadata` of an
      * existing plan.
      *
-     * Other fields on a customer are currently immutable.
+     * Other fields on a plan are currently immutable.
      */
     update(planId: string, body: PlanUpdateParams, options?: Core.RequestOptions): Core.APIPromise<Plan>;
     /**
@@ -81,6 +81,9 @@ export interface Plan {
      */
     default_invoice_memo: string | null;
     description: string;
+    /**
+     * @deprecated
+     */
     discount: Shared.Discount | null;
     /**
      * An optional user-defined ID for this plan resource, used throughout the system
@@ -93,7 +96,13 @@ export interface Plan {
      * unless `currency` is a custom pricing unit.
      */
     invoicing_currency: string;
+    /**
+     * @deprecated
+     */
     maximum: Plan.Maximum | null;
+    /**
+     * @deprecated
+     */
     maximum_amount: string | null;
     /**
      * User specified key-value pairs for the resource. If not present, this defaults
@@ -102,7 +111,13 @@ export interface Plan {
      * `null`.
      */
     metadata: Record<string, string>;
+    /**
+     * @deprecated
+     */
     minimum: Plan.Minimum | null;
+    /**
+     * @deprecated
+     */
     minimum_amount: string | null;
     name: string;
     /**
@@ -129,9 +144,13 @@ export declare namespace Plan {
         id: string;
         adjustment_type: 'usage_discount';
         /**
-         * The price IDs that this adjustment applies to.
+         * @deprecated The price IDs that this adjustment applies to.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<PlanPhaseUsageDiscountAdjustment.Filter>;
         /**
          * True for adjustments that apply to an entire invocice, false for adjustments
          * that apply to only one price.
@@ -151,6 +170,22 @@ export declare namespace Plan {
          */
         usage_discount: number;
     }
+    namespace PlanPhaseUsageDiscountAdjustment {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface PlanPhaseAmountDiscountAdjustment {
         id: string;
         adjustment_type: 'amount_discount';
@@ -160,9 +195,13 @@ export declare namespace Plan {
          */
         amount_discount: string;
         /**
-         * The price IDs that this adjustment applies to.
+         * @deprecated The price IDs that this adjustment applies to.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<PlanPhaseAmountDiscountAdjustment.Filter>;
         /**
          * True for adjustments that apply to an entire invocice, false for adjustments
          * that apply to only one price.
@@ -177,13 +216,33 @@ export declare namespace Plan {
          */
         reason: string | null;
     }
+    namespace PlanPhaseAmountDiscountAdjustment {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface PlanPhasePercentageDiscountAdjustment {
         id: string;
         adjustment_type: 'percentage_discount';
         /**
-         * The price IDs that this adjustment applies to.
+         * @deprecated The price IDs that this adjustment applies to.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<PlanPhasePercentageDiscountAdjustment.Filter>;
         /**
          * True for adjustments that apply to an entire invocice, false for adjustments
          * that apply to only one price.
@@ -203,13 +262,33 @@ export declare namespace Plan {
          */
         reason: string | null;
     }
+    namespace PlanPhasePercentageDiscountAdjustment {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface PlanPhaseMinimumAdjustment {
         id: string;
         adjustment_type: 'minimum';
         /**
-         * The price IDs that this adjustment applies to.
+         * @deprecated The price IDs that this adjustment applies to.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<PlanPhaseMinimumAdjustment.Filter>;
         /**
          * True for adjustments that apply to an entire invocice, false for adjustments
          * that apply to only one price.
@@ -233,13 +312,33 @@ export declare namespace Plan {
          */
         reason: string | null;
     }
+    namespace PlanPhaseMinimumAdjustment {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface PlanPhaseMaximumAdjustment {
         id: string;
         adjustment_type: 'maximum';
         /**
-         * The price IDs that this adjustment applies to.
+         * @deprecated The price IDs that this adjustment applies to.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<PlanPhaseMaximumAdjustment.Filter>;
         /**
          * True for adjustments that apply to an entire invocice, false for adjustments
          * that apply to only one price.
@@ -259,6 +358,22 @@ export declare namespace Plan {
          */
         reason: string | null;
     }
+    namespace PlanPhaseMaximumAdjustment {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface BasePlan {
         id: string | null;
         /**
@@ -269,28 +384,74 @@ export declare namespace Plan {
         external_plan_id: string | null;
         name: string | null;
     }
+    /**
+     * @deprecated
+     */
     interface Maximum {
         /**
-         * List of price_ids that this maximum amount applies to. For plan/plan phase
-         * maximums, this can be a subset of prices.
+         * @deprecated List of price_ids that this maximum amount applies to. For plan/plan
+         * phase maximums, this can be a subset of prices.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this maximum to.
+         */
+        filters: Array<Maximum.Filter>;
         /**
          * Maximum amount applied
          */
         maximum_amount: string;
     }
+    namespace Maximum {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
+    /**
+     * @deprecated
+     */
     interface Minimum {
         /**
-         * List of price_ids that this minimum amount applies to. For plan/plan phase
-         * minimums, this can be a subset of prices.
+         * @deprecated List of price_ids that this minimum amount applies to. For plan/plan
+         * phase minimums, this can be a subset of prices.
          */
         applies_to_price_ids: Array<string>;
+        /**
+         * The filters that determine which prices to apply this minimum to.
+         */
+        filters: Array<Minimum.Filter>;
         /**
          * Minimum amount applied
          */
         minimum_amount: string;
     }
+    namespace Minimum {
+        interface Filter {
+            /**
+             * The property of the price to filter on.
+             */
+            field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+            /**
+             * Should prices that match the filter be included or excluded.
+             */
+            operator: 'includes' | 'excludes';
+            /**
+             * The IDs or values that match this filter.
+             */
+            values: Array<string>;
+        }
+    }
     interface PlanPhase {
         id: string;
         description: string | null;
@@ -314,26 +475,66 @@ export declare namespace Plan {
     namespace PlanPhase {
         interface Maximum {
             /**
-             * List of price_ids that this maximum amount applies to. For plan/plan phase
-             * maximums, this can be a subset of prices.
+             * @deprecated List of price_ids that this maximum amount applies to. For plan/plan
+             * phase maximums, this can be a subset of prices.
              */
             applies_to_price_ids: Array<string>;
+            /**
+             * The filters that determine which prices to apply this maximum to.
+             */
+            filters: Array<Maximum.Filter>;
             /**
              * Maximum amount applied
              */
             maximum_amount: string;
         }
+        namespace Maximum {
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
         interface Minimum {
             /**
-             * List of price_ids that this minimum amount applies to. For plan/plan phase
-             * minimums, this can be a subset of prices.
+             * @deprecated List of price_ids that this minimum amount applies to. For plan/plan
+             * phase minimums, this can be a subset of prices.
              */
             applies_to_price_ids: Array<string>;
+            /**
+             * The filters that determine which prices to apply this minimum to.
+             */
+            filters: Array<Minimum.Filter>;
             /**
              * Minimum amount applied
              */
             minimum_amount: string;
         }
+        namespace Minimum {
+            interface Filter {
+                /**
+                 * The property of the price to filter on.
+                 */
+                field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+                /**
+                 * Should prices that match the filter be included or excluded.
+                 */
+                operator: 'includes' | 'excludes';
+                /**
+                 * The IDs or values that match this filter.
+                 */
+                values: Array<string>;
+            }
+        }
     }
     interface Product {
         id: string;
@@ -356,7 +557,7 @@ export interface PlanCreateParams {
      * Prices for this plan. If the plan has phases, this includes prices across all
      * phases of the plan.
      */
-    prices: Array<PlanCreateParams.NewPlanUnitPrice | PlanCreateParams.NewPlanPackagePrice | PlanCreateParams.NewPlanMatrixPrice | PlanCreateParams.NewPlanTieredPrice | PlanCreateParams.NewPlanTieredBpsPrice | PlanCreateParams.NewPlanBpsPrice | PlanCreateParams.NewPlanBulkBpsPrice | PlanCreateParams.NewPlanBulkPrice | PlanCreateParams.NewPlanThresholdTotalAmountPrice | PlanCreateParams.NewPlanTieredPackagePrice | PlanCreateParams.NewPlanTieredWithMinimumPrice | PlanCreateParams.NewPlanUnitWithPercentPrice | PlanCreateParams.NewPlanPackageWithAllocationPrice | PlanCreateParams.NewPlanTierWithProrationPrice | PlanCreateParams.NewPlanUnitWithProrationPrice | PlanCreateParams.NewPlanGroupedAllocationPrice | PlanCreateParams.NewPlanGroupedWithProratedMinimumPrice | PlanCreateParams.NewPlanGroupedWithMeteredMinimumPrice | PlanCreateParams.NewPlanMatrixWithDisplayNamePrice | PlanCreateParams.NewPlanBulkWithProrationPrice | PlanCreateParams.NewPlanGroupedTieredPackagePrice | PlanCreateParams.NewPlanMaxGroupTieredPackagePrice | PlanCreateParams.NewPlanScalableMatrixWithUnitPricingPrice | PlanCreateParams.NewPlanScalableMatrixWithTieredPricingPrice | PlanCreateParams.NewPlanCumulativeGroupedBulkPrice>;
+    prices: Array<PlanCreateParams.NewPlanUnitPrice | PlanCreateParams.NewPlanPackagePrice | PlanCreateParams.NewPlanMatrixPrice | PlanCreateParams.NewPlanTieredPrice | PlanCreateParams.NewPlanTieredBpsPrice | PlanCreateParams.NewPlanBpsPrice | PlanCreateParams.NewPlanBulkBpsPrice | PlanCreateParams.NewPlanBulkPrice | PlanCreateParams.NewPlanThresholdTotalAmountPrice | PlanCreateParams.NewPlanTieredPackagePrice | PlanCreateParams.NewPlanTieredWithMinimumPrice | PlanCreateParams.NewPlanUnitWithPercentPrice | PlanCreateParams.NewPlanPackageWithAllocationPrice | PlanCreateParams.NewPlanTierWithProrationPrice | PlanCreateParams.NewPlanUnitWithProrationPrice | PlanCreateParams.NewPlanGroupedAllocationPrice | PlanCreateParams.NewPlanGroupedWithProratedMinimumPrice | PlanCreateParams.NewPlanGroupedWithMeteredMinimumPrice | PlanCreateParams.NewPlanMatrixWithDisplayNamePrice | PlanCreateParams.NewPlanBulkWithProrationPrice | PlanCreateParams.NewPlanGroupedTieredPackagePrice | PlanCreateParams.NewPlanMaxGroupTieredPackagePrice | PlanCreateParams.NewPlanScalableMatrixWithUnitPricingPrice | PlanCreateParams.NewPlanScalableMatrixWithTieredPricingPrice | PlanCreateParams.NewPlanCumulativeGroupedBulkPrice | PlanCreateParams.NewPlanTieredPackageWithMinimumPrice | PlanCreateParams.NewPlanMatrixWithAllocationPrice | PlanCreateParams.NewPlanGroupedTieredPrice>;
     /**
      * Free-form text which is available on the invoice PDF and the Orb invoice portal.
      */
@@ -420,6 +621,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanUnitPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -466,6 +671,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -520,6 +743,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanPackagePrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -571,6 +798,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -625,6 +870,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanMatrixPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -693,6 +942,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -747,6 +1014,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanTieredPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -809,6 +1080,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -863,6 +1152,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanTieredBpsPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -930,6 +1223,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -984,6 +1295,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanBpsPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1034,6 +1349,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1088,6 +1421,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanBulkBpsPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1151,6 +1488,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1205,6 +1560,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanBulkPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1263,6 +1622,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1317,6 +1694,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanThresholdTotalAmountPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1357,6 +1738,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1411,6 +1810,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanTieredPackagePrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1451,6 +1854,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1505,6 +1926,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanTieredWithMinimumPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1545,6 +1970,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1599,6 +2042,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanUnitWithPercentPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1639,6 +2086,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1693,6 +2158,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanPackageWithAllocationPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1733,6 +2202,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1787,6 +2274,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanTierWithProrationPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1828,18 +2319,36 @@ export declare namespace PlanCreateParams {
             duration_unit: 'day' | 'month';
         }
         /**
-         * Within each billing cycle, specifies the cadence at which invoices are produced.
-         * If unspecified, a single invoice is produced per billing cycle.
+         * For dimensional price: specifies a price group and dimension values
          */
-        interface InvoicingCycleConfiguration {
+        interface DimensionalPriceConfiguration {
             /**
-             * The duration of the billing period.
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
              */
-            duration: number;
+            dimension_values: Array<string>;
             /**
-             * The unit of billing period duration.
+             * The id of the dimensional price group to include this price in
              */
-            duration_unit: 'day' | 'month';
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
+        /**
+         * Within each billing cycle, specifies the cadence at which invoices are produced.
+         * If unspecified, a single invoice is produced per billing cycle.
+         */
+        interface InvoicingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
         }
     }
     interface NewPlanUnitWithProrationPrice {
@@ -1881,6 +2390,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanUnitWithProrationPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -1921,6 +2434,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -1975,6 +2506,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanGroupedAllocationPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2015,6 +2550,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2069,6 +2622,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanGroupedWithProratedMinimumPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2109,6 +2666,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2163,6 +2738,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanGroupedWithMeteredMinimumPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2203,6 +2782,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2257,6 +2854,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanMatrixWithDisplayNamePrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2297,6 +2898,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2351,6 +2970,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanBulkWithProrationPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2391,6 +3014,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2445,6 +3086,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanGroupedTieredPackagePrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2485,6 +3130,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2539,6 +3202,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanMaxGroupTieredPackagePrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2579,6 +3246,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2633,6 +3318,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanScalableMatrixWithUnitPricingPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2673,6 +3362,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2727,6 +3434,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanScalableMatrixWithTieredPricingPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2767,6 +3478,24 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.
@@ -2821,6 +3550,10 @@ export declare namespace PlanCreateParams {
          * price is billed.
          */
         currency?: string | null;
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        dimensional_price_configuration?: NewPlanCumulativeGroupedBulkPrice.DimensionalPriceConfiguration | null;
         /**
          * An alias for the price.
          */
@@ -2861,6 +3594,404 @@ export declare namespace PlanCreateParams {
              */
             duration_unit: 'day' | 'month';
         }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
+        /**
+         * Within each billing cycle, specifies the cadence at which invoices are produced.
+         * If unspecified, a single invoice is produced per billing cycle.
+         */
+        interface InvoicingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+    }
+    interface NewPlanTieredPackageWithMinimumPrice {
+        /**
+         * The cadence to bill for this price on.
+         */
+        cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+        /**
+         * The id of the item the price will be associated with.
+         */
+        item_id: string;
+        model_type: 'tiered_package_with_minimum';
+        /**
+         * The name of the price.
+         */
+        name: string;
+        tiered_package_with_minimum_config: Record<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?: NewPlanTieredPackageWithMinimumPrice.BillingCycleConfiguration | null;
+        /**
+         * The per unit conversion rate of the price currency to the invoicing currency.
+         */
+        conversion_rate?: number | 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?: NewPlanTieredPackageWithMinimumPrice.DimensionalPriceConfiguration | 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?: NewPlanTieredPackageWithMinimumPrice.InvoicingCycleConfiguration | 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?: Record<string, string | null> | null;
+    }
+    namespace NewPlanTieredPackageWithMinimumPrice {
+        /**
+         * For custom cadence: specifies the duration of the billing period in days or
+         * months.
+         */
+        interface BillingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
+        /**
+         * Within each billing cycle, specifies the cadence at which invoices are produced.
+         * If unspecified, a single invoice is produced per billing cycle.
+         */
+        interface InvoicingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+    }
+    interface NewPlanMatrixWithAllocationPrice {
+        /**
+         * 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;
+        matrix_with_allocation_config: NewPlanMatrixWithAllocationPrice.MatrixWithAllocationConfig;
+        model_type: 'matrix_with_allocation';
+        /**
+         * 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?: NewPlanMatrixWithAllocationPrice.BillingCycleConfiguration | null;
+        /**
+         * The per unit conversion rate of the price currency to the invoicing currency.
+         */
+        conversion_rate?: number | 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?: NewPlanMatrixWithAllocationPrice.DimensionalPriceConfiguration | 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?: NewPlanMatrixWithAllocationPrice.InvoicingCycleConfiguration | 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?: Record<string, string | null> | null;
+    }
+    namespace NewPlanMatrixWithAllocationPrice {
+        interface MatrixWithAllocationConfig {
+            /**
+             * Allocation to be used to calculate the price
+             */
+            allocation: number;
+            /**
+             * Default per unit rate for any usage not bucketed into a specified matrix_value
+             */
+            default_unit_amount: string;
+            /**
+             * One or two event property values to evaluate matrix groups by
+             */
+            dimensions: Array<string | null>;
+            /**
+             * Matrix values for specified matrix grouping keys
+             */
+            matrix_values: Array<MatrixWithAllocationConfig.MatrixValue>;
+        }
+        namespace MatrixWithAllocationConfig {
+            interface MatrixValue {
+                /**
+                 * One or two matrix keys to filter usage to this Matrix value by. For example,
+                 * ["region", "tier"] could be used to filter cloud usage by a cloud region and an
+                 * instance tier.
+                 */
+                dimension_values: Array<string | null>;
+                /**
+                 * Unit price for the specified dimension_values
+                 */
+                unit_amount: string;
+            }
+        }
+        /**
+         * For custom cadence: specifies the duration of the billing period in days or
+         * months.
+         */
+        interface BillingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
+        /**
+         * Within each billing cycle, specifies the cadence at which invoices are produced.
+         * If unspecified, a single invoice is produced per billing cycle.
+         */
+        interface InvoicingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+    }
+    interface NewPlanGroupedTieredPrice {
+        /**
+         * The cadence to bill for this price on.
+         */
+        cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+        grouped_tiered_config: Record<string, unknown>;
+        /**
+         * The id of the item the price will be associated with.
+         */
+        item_id: string;
+        model_type: 'grouped_tiered';
+        /**
+         * 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?: NewPlanGroupedTieredPrice.BillingCycleConfiguration | null;
+        /**
+         * The per unit conversion rate of the price currency to the invoicing currency.
+         */
+        conversion_rate?: number | 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?: NewPlanGroupedTieredPrice.DimensionalPriceConfiguration | 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?: NewPlanGroupedTieredPrice.InvoicingCycleConfiguration | 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?: Record<string, string | null> | null;
+    }
+    namespace NewPlanGroupedTieredPrice {
+        /**
+         * For custom cadence: specifies the duration of the billing period in days or
+         * months.
+         */
+        interface BillingCycleConfiguration {
+            /**
+             * The duration of the billing period.
+             */
+            duration: number;
+            /**
+             * The unit of billing period duration.
+             */
+            duration_unit: 'day' | 'month';
+        }
+        /**
+         * For dimensional price: specifies a price group and dimension values
+         */
+        interface DimensionalPriceConfiguration {
+            /**
+             * The list of dimension values matching (in order) the dimensions of the price
+             * group
+             */
+            dimension_values: Array<string>;
+            /**
+             * The id of the dimensional price group to include this price in
+             */
+            dimensional_price_group_id?: string | null;
+            /**
+             * The external id of the dimensional price group to include this price in
+             */
+            external_dimensional_price_group_id?: string | null;
+        }
         /**
          * Within each billing cycle, specifies the cadence at which invoices are produced.
          * If unspecified, a single invoice is produced per billing cycle.