orb-billing 4.72.3 → 4.73.0

package/src/resources/plans/plans.ts

@@ -23,7 +23,7 @@ export 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> {
     return this._client.put(`/plans/${planId}`, { body, ...options });
@@ -119,6 +119,9 @@ export interface Plan {
 
   description: string;
 
+  /**
+   * @deprecated
+   */
   discount: Shared.Discount | null;
 
   /**
@@ -134,8 +137,14 @@ export interface Plan {
    */
   invoicing_currency: string;
 
+  /**
+   * @deprecated
+   */
   maximum: Plan.Maximum | null;
 
+  /**
+   * @deprecated
+   */
   maximum_amount: string | null;
 
   /**
@@ -146,8 +155,14 @@ export interface Plan {
    */
   metadata: Record<string, string>;
 
+  /**
+   * @deprecated
+   */
   minimum: Plan.Minimum | null;
 
+  /**
+   * @deprecated
+   */
   minimum_amount: string | null;
 
   name: string;
@@ -185,10 +200,15 @@ export namespace Plan {
     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.
@@ -212,6 +232,25 @@ export namespace Plan {
     usage_discount: number;
   }
 
+  export namespace PlanPhaseUsageDiscountAdjustment {
+    export 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>;
+    }
+  }
+
   export interface PlanPhaseAmountDiscountAdjustment {
     id: string;
 
@@ -224,10 +263,15 @@ export 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.
@@ -245,16 +289,40 @@ export namespace Plan {
     reason: string | null;
   }
 
+  export namespace PlanPhaseAmountDiscountAdjustment {
+    export 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>;
+    }
+  }
+
   export 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.
@@ -278,16 +346,40 @@ export namespace Plan {
     reason: string | null;
   }
 
+  export namespace PlanPhasePercentageDiscountAdjustment {
+    export 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>;
+    }
+  }
+
   export 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.
@@ -316,16 +408,40 @@ export namespace Plan {
     reason: string | null;
   }
 
+  export namespace PlanPhaseMinimumAdjustment {
+    export 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>;
+    }
+  }
+
   export 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.
@@ -349,6 +465,25 @@ export namespace Plan {
     reason: string | null;
   }
 
+  export namespace PlanPhaseMaximumAdjustment {
+    export 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>;
+    }
+  }
+
   export interface BasePlan {
     id: string | null;
 
@@ -362,32 +497,86 @@ export namespace Plan {
     name: string | null;
   }
 
+  /**
+   * @deprecated
+   */
   export 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;
   }
 
+  export namespace Maximum {
+    export 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
+   */
   export 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;
   }
 
+  export namespace Minimum {
+    export 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>;
+    }
+  }
+
   export interface PlanPhase {
     id: string;
 
@@ -422,29 +611,77 @@ export namespace Plan {
   export namespace PlanPhase {
     export 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;
     }
 
+    export namespace Maximum {
+      export 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>;
+      }
+    }
+
     export 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;
     }
+
+    export namespace Minimum {
+      export 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>;
+      }
+    }
   }
 
   export interface Product {
@@ -501,6 +738,9 @@ export interface PlanCreateParams {
     | PlanCreateParams.NewPlanScalableMatrixWithUnitPricingPrice
     | PlanCreateParams.NewPlanScalableMatrixWithTieredPricingPrice
     | PlanCreateParams.NewPlanCumulativeGroupedBulkPrice
+    | PlanCreateParams.NewPlanTieredPackageWithMinimumPrice
+    | PlanCreateParams.NewPlanMatrixWithAllocationPrice
+    | PlanCreateParams.NewPlanGroupedTieredPrice
   >;
 
   /**
@@ -581,6 +821,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanUnitPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -635,6 +880,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -701,6 +967,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanPackagePrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -761,6 +1032,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -827,6 +1119,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanMatrixPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -907,6 +1204,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -973,6 +1291,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanTieredPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1046,6 +1369,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1112,6 +1456,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanTieredBpsPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1191,6 +1540,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1257,6 +1627,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanBpsPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1316,6 +1691,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1382,6 +1778,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanBulkBpsPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1456,6 +1857,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1522,6 +1944,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanBulkPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1591,20 +2018,41 @@ export namespace PlanCreateParams {
     }
 
     /**
-     * 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
      */
-    export interface InvoicingCycleConfiguration {
+    export 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.
+     */
+    export interface InvoicingCycleConfiguration {
+      /**
+       * The duration of the billing period.
+       */
+      duration: number;
+
+      /**
+       * The unit of billing period duration.
+       */
+      duration_unit: 'day' | 'month';
+    }
   }
 
   export interface NewPlanThresholdTotalAmountPrice {
@@ -1656,6 +2104,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanThresholdTotalAmountPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1703,6 +2156,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1769,6 +2243,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanTieredPackagePrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1816,6 +2295,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1882,6 +2382,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanTieredWithMinimumPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -1929,6 +2434,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -1995,6 +2521,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanUnitWithPercentPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2042,6 +2573,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2108,6 +2660,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanPackageWithAllocationPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2155,6 +2712,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2221,6 +2799,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanTierWithProrationPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2268,6 +2851,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2334,6 +2938,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanUnitWithProrationPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2381,6 +2990,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2447,6 +3077,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanGroupedAllocationPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2494,6 +3129,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2560,6 +3216,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanGroupedWithProratedMinimumPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2607,6 +3268,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2673,6 +3355,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanGroupedWithMeteredMinimumPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2720,6 +3407,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2786,6 +3494,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanMatrixWithDisplayNamePrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2833,6 +3546,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -2899,6 +3633,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanBulkWithProrationPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -2946,6 +3685,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -3012,6 +3772,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanGroupedTieredPackagePrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -3059,6 +3824,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -3125,6 +3911,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanMaxGroupTieredPackagePrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -3172,6 +3963,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -3238,6 +4050,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanScalableMatrixWithUnitPricingPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -3285,6 +4102,27 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
@@ -3351,6 +4189,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanScalableMatrixWithTieredPricingPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -3399,20 +4242,41 @@ export namespace PlanCreateParams {
     }
 
     /**
-     * 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
      */
-    export interface InvoicingCycleConfiguration {
+    export 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.
+     */
+    export interface InvoicingCycleConfiguration {
+      /**
+       * The duration of the billing period.
+       */
+      duration: number;
+
+      /**
+       * The unit of billing period duration.
+       */
+      duration_unit: 'day' | 'month';
+    }
   }
 
   export interface NewPlanCumulativeGroupedBulkPrice {
@@ -3464,6 +4328,11 @@ export namespace PlanCreateParams {
      */
     currency?: string | null;
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    dimensional_price_configuration?: NewPlanCumulativeGroupedBulkPrice.DimensionalPriceConfiguration | null;
+
     /**
      * An alias for the price.
      */
@@ -3511,6 +4380,482 @@ export namespace PlanCreateParams {
       duration_unit: 'day' | 'month';
     }
 
+    /**
+     * For dimensional price: specifies a price group and dimension values
+     */
+    export 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.
+     */
+    export interface InvoicingCycleConfiguration {
+      /**
+       * The duration of the billing period.
+       */
+      duration: number;
+
+      /**
+       * The unit of billing period duration.
+       */
+      duration_unit: 'day' | 'month';
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace NewPlanTieredPackageWithMinimumPrice {
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    export 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
+     */
+    export 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.
+     */
+    export interface InvoicingCycleConfiguration {
+      /**
+       * The duration of the billing period.
+       */
+      duration: number;
+
+      /**
+       * The unit of billing period duration.
+       */
+      duration_unit: 'day' | 'month';
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace NewPlanMatrixWithAllocationPrice {
+    export 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>;
+    }
+
+    export namespace MatrixWithAllocationConfig {
+      export 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.
+     */
+    export 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
+     */
+    export 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.
+     */
+    export interface InvoicingCycleConfiguration {
+      /**
+       * The duration of the billing period.
+       */
+      duration: number;
+
+      /**
+       * The unit of billing period duration.
+       */
+      duration_unit: 'day' | 'month';
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace NewPlanGroupedTieredPrice {
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    export 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
+     */
+    export 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.