orb-billing 5.48.0 → 5.75.1

package/resources/shared.d.ts

@@ -10,7 +10,7 @@ export interface Address {
 }
 export interface AdjustmentInterval {
     id: string;
-    adjustment: PlanPhaseUsageDiscountAdjustment | PlanPhaseAmountDiscountAdjustment | PlanPhasePercentageDiscountAdjustment | PlanPhaseMinimumAdjustment | PlanPhaseMaximumAdjustment;
+    adjustment: PlanPhaseUsageDiscountAdjustment | PlanPhaseAmountDiscountAdjustment | PlanPhasePercentageDiscountAdjustment | AdjustmentInterval.PlanPhaseTieredPercentageDiscountAdjustment | PlanPhaseMinimumAdjustment | PlanPhaseMaximumAdjustment;
     /**
      * The price interval IDs that this adjustment applies to.
      */
@@ -24,6 +24,82 @@ export interface AdjustmentInterval {
      */
     start_date: string;
 }
+export declare namespace AdjustmentInterval {
+    interface PlanPhaseTieredPercentageDiscountAdjustment {
+        id: string;
+        adjustment_type: 'tiered_percentage_discount';
+        /**
+         * @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<PlanPhaseTieredPercentageDiscountAdjustment.Filter>;
+        /**
+         * True for adjustments that apply to an entire invoice, false for adjustments that
+         * apply to only one price.
+         */
+        is_invoice_level: boolean;
+        /**
+         * The plan phase in which this adjustment is active.
+         */
+        plan_phase_order: number | null;
+        /**
+         * The reason for the adjustment.
+         */
+        reason: string | null;
+        /**
+         * The adjustment id this adjustment replaces. This adjustment will take the place
+         * of the replaced adjustment in plan version migrations.
+         */
+        replaces_adjustment_id: string | null;
+        /**
+         * The ordered, contiguous bands of cumulative eligible spend, each discounted at
+         * its own percentage (progressive fill-a-tier), applied to the prices this
+         * adjustment covers in a given billing period.
+         */
+        tiers: Array<PlanPhaseTieredPercentageDiscountAdjustment.Tier>;
+    }
+    namespace PlanPhaseTieredPercentageDiscountAdjustment {
+        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>;
+        }
+        /**
+         * One band of a tiered percentage discount. Bounds are denominated in the
+         * discount's currency. `lower_bound` is the exclusive start of the band and
+         * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+         * open-ended final tier.
+         */
+        interface Tier {
+            /**
+             * Exclusive lower bound of cumulative spend for this tier.
+             */
+            lower_bound: number;
+            /**
+             * The percentage (between 0 and 1) discounted from spend that falls within this
+             * tier.
+             */
+            percentage: number;
+            /**
+             * Inclusive upper bound of cumulative spend for this tier; null for the final
+             * open-ended tier.
+             */
+            upper_bound?: number | null;
+        }
+    }
+}
 export interface AggregatedCost {
     per_price_costs: Array<PerPriceCost>;
     /**
@@ -282,11 +358,13 @@ export declare namespace ChangedSubscriptionResources {
          * | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
          * | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
          * | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+         * | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
          * | Finland                | `eu_vat`     | European VAT Number                                                                                     |
          * | France                 | `eu_vat`     | European VAT Number                                                                                     |
          * | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
          * | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
          * | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+         * | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
          * | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
          * | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
          * | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -298,6 +376,7 @@ export declare namespace ChangedSubscriptionResources {
          * | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
          * | Israel                 | `il_vat`     | Israel VAT                                                                                              |
          * | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+         * | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
          * | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
          * | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
          * | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -328,6 +407,7 @@ export declare namespace ChangedSubscriptionResources {
          * | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
          * | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
          * | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+         * | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
          * | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
          * | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
          * | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -349,6 +429,7 @@ export declare namespace ChangedSubscriptionResources {
          * | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
          * | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
          * | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+         * | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
          * | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
          * | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
          * | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -391,8 +472,8 @@ export declare namespace ChangedSubscriptionResources {
          */
         eligible_to_issue_at: string | null;
         /**
-         * A URL for the customer-facing invoice portal. This URL expires 30 days after the
-         * invoice's due date, or 60 days after being re-generated through the UI.
+         * A URL for the customer-facing invoice portal. This URL expires 60 days after the
+         * link is generated, or 30 days after the invoice's due date — whichever is later.
          */
         hosted_invoice_url: string | null;
         /**
@@ -587,7 +668,7 @@ export declare namespace ChangedSubscriptionResources {
              * invoice calculations (ie. usage discounts -> amount discounts -> percentage
              * discounts -> minimums -> maximums).
              */
-            adjustments: Array<Shared.MonetaryUsageDiscountAdjustment | Shared.MonetaryAmountDiscountAdjustment | Shared.MonetaryPercentageDiscountAdjustment | Shared.MonetaryMinimumAdjustment | Shared.MonetaryMaximumAdjustment>;
+            adjustments: Array<Shared.MonetaryUsageDiscountAdjustment | Shared.MonetaryAmountDiscountAdjustment | Shared.MonetaryPercentageDiscountAdjustment | LineItem.MonetaryTieredPercentageDiscountAdjustment | Shared.MonetaryMinimumAdjustment | Shared.MonetaryMaximumAdjustment>;
             /**
              * The final amount for a line item after all adjustments and pre paid credits have
              * been applied.
@@ -659,6 +740,82 @@ export declare namespace ChangedSubscriptionResources {
              */
             usage_customer_ids: Array<string> | null;
         }
+        namespace LineItem {
+            interface MonetaryTieredPercentageDiscountAdjustment {
+                id: string;
+                adjustment_type: 'tiered_percentage_discount';
+                /**
+                 * The value applied by an adjustment.
+                 */
+                amount: string;
+                /**
+                 * @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<MonetaryTieredPercentageDiscountAdjustment.Filter>;
+                /**
+                 * True for adjustments that apply to an entire invoice, false for adjustments that
+                 * apply to only one price.
+                 */
+                is_invoice_level: boolean;
+                /**
+                 * The reason for the adjustment.
+                 */
+                reason: string | null;
+                /**
+                 * The adjustment id this adjustment replaces. This adjustment will take the place
+                 * of the replaced adjustment in plan version migrations.
+                 */
+                replaces_adjustment_id: string | null;
+                /**
+                 * The ordered, contiguous bands of cumulative eligible spend, each discounted at
+                 * its own percentage (progressive fill-a-tier), applied to the prices this
+                 * adjustment covers in a given billing period.
+                 */
+                tiers: Array<MonetaryTieredPercentageDiscountAdjustment.Tier>;
+            }
+            namespace MonetaryTieredPercentageDiscountAdjustment {
+                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>;
+                }
+                /**
+                 * One band of a tiered percentage discount. Bounds are denominated in the
+                 * discount's currency. `lower_bound` is the exclusive start of the band and
+                 * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+                 * open-ended final tier.
+                 */
+                interface Tier {
+                    /**
+                     * Exclusive lower bound of cumulative spend for this tier.
+                     */
+                    lower_bound: number;
+                    /**
+                     * The percentage (between 0 and 1) discounted from spend that falls within this
+                     * tier.
+                     */
+                    percentage: number;
+                    /**
+                     * Inclusive upper bound of cumulative spend for this tier; null for the final
+                     * open-ended tier.
+                     */
+                    upper_bound?: number | null;
+                }
+            }
+        }
         interface PaymentAttempt {
             /**
              * The ID of the payment attempt.
@@ -675,7 +832,7 @@ export declare namespace ChangedSubscriptionResources {
             /**
              * The payment provider that attempted to collect the payment.
              */
-            payment_provider: 'stripe' | null;
+            payment_provider: 'stripe' | 'adyen' | null;
             /**
              * The ID of the payment attempt in the payment provider.
              */
@@ -940,11 +1097,13 @@ export interface CustomerMinified {
  * | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
  * | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
  * | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+ * | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
  * | Finland                | `eu_vat`     | European VAT Number                                                                                     |
  * | France                 | `eu_vat`     | European VAT Number                                                                                     |
  * | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
  * | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
  * | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+ * | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
  * | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
  * | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
  * | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -956,6 +1115,7 @@ export interface CustomerMinified {
  * | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
  * | Israel                 | `il_vat`     | Israel VAT                                                                                              |
  * | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+ * | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
  * | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
  * | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
  * | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -986,6 +1146,7 @@ export interface CustomerMinified {
  * | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
  * | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
  * | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+ * | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
  * | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
  * | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
  * | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -1007,6 +1168,7 @@ export interface CustomerMinified {
  * | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
  * | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
  * | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+ * | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
  * | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
  * | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
  * | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -1030,15 +1192,74 @@ export interface CustomerMinified {
  * | Zimbabwe               | `zw_tin`     | Zimbabwe Tax Identification Number                                                                      |
  */
 export interface CustomerTaxID {
-    country: 'AD' | 'AE' | 'AL' | 'AM' | 'AO' | 'AR' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BJ' | 'BO' | 'BR' | 'BS' | 'BY' | 'CA' | 'CD' | 'CH' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CV' | 'DE' | 'CY' | 'CZ' | 'DK' | 'DO' | 'EC' | 'EE' | 'EG' | 'ES' | 'ET' | 'EU' | 'FI' | 'FR' | 'GB' | 'GE' | 'GN' | 'GR' | 'HK' | 'HR' | 'HU' | 'ID' | 'IE' | 'IL' | 'IN' | 'IS' | 'IT' | 'JP' | 'KE' | 'KG' | 'KH' | 'KR' | 'KZ' | 'LA' | 'LI' | 'LT' | 'LU' | 'LV' | 'MA' | 'MD' | 'ME' | 'MK' | 'MR' | 'MT' | 'MX' | 'MY' | 'NG' | 'NL' | 'NO' | 'NP' | 'NZ' | 'OM' | 'PE' | 'PH' | 'PL' | 'PT' | 'RO' | 'RS' | 'RU' | 'SA' | 'SE' | 'SG' | 'SI' | 'SK' | 'SN' | 'SR' | 'SV' | 'TH' | 'TJ' | 'TR' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VE' | 'VN' | 'ZA' | 'ZM' | 'ZW';
-    type: 'ad_nrt' | 'ae_trn' | 'al_tin' | 'am_tin' | 'ao_tin' | 'ar_cuit' | 'eu_vat' | 'au_abn' | 'au_arn' | 'aw_tin' | 'az_tin' | 'ba_tin' | 'bb_tin' | 'bd_bin' | 'bf_ifu' | 'bg_uic' | 'bh_vat' | 'bj_ifu' | 'bo_tin' | 'br_cnpj' | 'br_cpf' | 'bs_tin' | 'by_tin' | 'ca_bn' | 'ca_gst_hst' | 'ca_pst_bc' | 'ca_pst_mb' | 'ca_pst_sk' | 'ca_qst' | 'cd_nif' | 'ch_uid' | 'ch_vat' | 'cl_tin' | 'cm_niu' | 'cn_tin' | 'co_nit' | 'cr_tin' | 'cv_nif' | 'de_stn' | 'do_rcn' | 'ec_ruc' | 'eg_tin' | 'es_cif' | 'et_tin' | 'eu_oss_vat' | 'gb_vat' | 'ge_vat' | 'gn_nif' | 'hk_br' | 'hr_oib' | 'hu_tin' | 'id_npwp' | 'il_vat' | 'in_gst' | 'is_vat' | 'jp_cn' | 'jp_rn' | 'jp_trn' | 'ke_pin' | 'kg_tin' | 'kh_tin' | 'kr_brn' | 'kz_bin' | 'la_tin' | 'li_uid' | 'li_vat' | 'ma_vat' | 'md_vat' | 'me_pib' | 'mk_vat' | 'mr_nif' | 'mx_rfc' | 'my_frp' | 'my_itn' | 'my_sst' | 'ng_tin' | 'no_vat' | 'no_voec' | 'np_pan' | 'nz_gst' | 'om_vat' | 'pe_ruc' | 'ph_tin' | 'pl_nip' | 'ro_tin' | 'rs_pib' | 'ru_inn' | 'ru_kpp' | 'sa_vat' | 'sg_gst' | 'sg_uen' | 'si_tin' | 'sn_ninea' | 'sr_fin' | 'sv_nit' | 'th_vat' | 'tj_tin' | 'tr_tin' | 'tw_vat' | 'tz_vat' | 'ua_vat' | 'ug_tin' | 'us_ein' | 'uy_ruc' | 'uz_tin' | 'uz_vat' | 've_rif' | 'vn_tin' | 'za_vat' | 'zm_tin' | 'zw_tin';
+    country: 'AD' | 'AE' | 'AL' | 'AM' | 'AO' | 'AR' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BJ' | 'BO' | 'BR' | 'BS' | 'BY' | 'CA' | 'CD' | 'CH' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CV' | 'CY' | 'CZ' | 'DE' | 'DK' | 'DO' | 'EC' | 'EE' | 'EG' | 'ES' | 'ET' | 'EU' | 'FI' | 'FO' | 'FR' | 'GB' | 'GE' | 'GI' | 'GN' | 'GR' | 'HK' | 'HR' | 'HU' | 'ID' | 'IE' | 'IL' | 'IN' | 'IS' | 'IT' | 'JP' | 'KE' | 'KG' | 'KH' | 'KR' | 'KZ' | 'LA' | 'LI' | 'LK' | 'LT' | 'LU' | 'LV' | 'MA' | 'MD' | 'ME' | 'MK' | 'MR' | 'MT' | 'MX' | 'MY' | 'NG' | 'NL' | 'NO' | 'NP' | 'NZ' | 'OM' | 'PE' | 'PH' | 'PL' | 'PT' | 'PY' | 'RO' | 'RS' | 'RU' | 'SA' | 'SE' | 'SG' | 'SI' | 'SK' | 'SN' | 'SR' | 'SV' | 'TH' | 'TJ' | 'TR' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VE' | 'VN' | 'ZA' | 'ZM' | 'ZW';
+    type: 'ad_nrt' | 'ae_trn' | 'al_tin' | 'am_tin' | 'ao_tin' | 'ar_cuit' | 'eu_vat' | 'au_abn' | 'au_arn' | 'aw_tin' | 'az_tin' | 'ba_tin' | 'bb_tin' | 'bd_bin' | 'bf_ifu' | 'bg_uic' | 'bh_vat' | 'bj_ifu' | 'bo_tin' | 'br_cnpj' | 'br_cpf' | 'bs_tin' | 'by_tin' | 'ca_bn' | 'ca_gst_hst' | 'ca_pst_bc' | 'ca_pst_mb' | 'ca_pst_sk' | 'ca_qst' | 'cd_nif' | 'ch_uid' | 'ch_vat' | 'cl_tin' | 'cm_niu' | 'cn_tin' | 'co_nit' | 'cr_tin' | 'cv_nif' | 'de_stn' | 'do_rcn' | 'ec_ruc' | 'eg_tin' | 'es_cif' | 'et_tin' | 'eu_oss_vat' | 'fo_vat' | 'gb_vat' | 'ge_vat' | 'gi_tin' | 'gn_nif' | 'hk_br' | 'hr_oib' | 'hu_tin' | 'id_npwp' | 'il_vat' | 'in_gst' | 'is_vat' | 'it_cf' | 'jp_cn' | 'jp_rn' | 'jp_trn' | 'ke_pin' | 'kg_tin' | 'kh_tin' | 'kr_brn' | 'kz_bin' | 'la_tin' | 'li_uid' | 'li_vat' | 'lk_vat' | 'ma_vat' | 'md_vat' | 'me_pib' | 'mk_vat' | 'mr_nif' | 'mx_rfc' | 'my_frp' | 'my_itn' | 'my_sst' | 'ng_tin' | 'no_vat' | 'no_voec' | 'np_pan' | 'nz_gst' | 'om_vat' | 'pe_ruc' | 'ph_tin' | 'pl_nip' | 'py_ruc' | 'ro_tin' | 'rs_pib' | 'ru_inn' | 'ru_kpp' | 'sa_vat' | 'sg_gst' | 'sg_uen' | 'si_tin' | 'sn_ninea' | 'sr_fin' | 'sv_nit' | 'th_vat' | 'tj_tin' | 'tr_tin' | 'tw_vat' | 'tz_vat' | 'ua_vat' | 'ug_tin' | 'us_ein' | 'uy_ruc' | 'uz_tin' | 'uz_vat' | 've_rif' | 'vn_tin' | 'za_vat' | 'zm_tin' | 'zw_tin';
     value: string;
 }
 export interface DimensionalPriceConfiguration {
     dimension_values: Array<string>;
     dimensional_price_group_id: string;
 }
-export type Discount = PercentageDiscount | TrialDiscount | UsageDiscount | AmountDiscount;
+export type Discount = PercentageDiscount | TrialDiscount | UsageDiscount | AmountDiscount | Discount.TieredPercentageDiscount;
+export declare namespace Discount {
+    interface TieredPercentageDiscount {
+        discount_type: 'tiered_percentage';
+        /**
+         * Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+         * bands of cumulative eligible spend, each discounted at its own percentage
+         * (progressive fill-a-tier).
+         */
+        tiers: Array<TieredPercentageDiscount.Tier>;
+        /**
+         * List of price_ids that this discount applies to. For plan/plan phase discounts,
+         * this can be a subset of prices.
+         */
+        applies_to_price_ids?: Array<string> | null;
+        /**
+         * The filters that determine which prices to apply this discount to.
+         */
+        filters?: Array<TieredPercentageDiscount.Filter> | null;
+        reason?: string | null;
+    }
+    namespace TieredPercentageDiscount {
+        /**
+         * One band of a tiered percentage discount. Bounds are denominated in the
+         * discount's currency. `lower_bound` is the exclusive start of the band and
+         * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+         * open-ended final tier.
+         */
+        interface Tier {
+            /**
+             * Exclusive lower bound of cumulative spend for this tier.
+             */
+            lower_bound: number;
+            /**
+             * The percentage (between 0 and 1) discounted from spend that falls within this
+             * tier.
+             */
+            percentage: number;
+            /**
+             * Inclusive upper bound of cumulative spend for this tier; null for the final
+             * open-ended tier.
+             */
+            upper_bound?: number | null;
+        }
+        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 FixedFeeQuantityScheduleEntry {
     end_date: string | null;
     price_id: string;
@@ -1138,11 +1359,13 @@ export interface Invoice {
      * | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
      * | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
      * | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+     * | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
      * | Finland                | `eu_vat`     | European VAT Number                                                                                     |
      * | France                 | `eu_vat`     | European VAT Number                                                                                     |
      * | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
      * | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
      * | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+     * | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
      * | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
      * | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
      * | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -1154,6 +1377,7 @@ export interface Invoice {
      * | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
      * | Israel                 | `il_vat`     | Israel VAT                                                                                              |
      * | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+     * | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
      * | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
      * | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
      * | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -1184,6 +1408,7 @@ export interface Invoice {
      * | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
      * | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
      * | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+     * | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
      * | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
      * | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
      * | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -1205,6 +1430,7 @@ export interface Invoice {
      * | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
      * | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
      * | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+     * | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
      * | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
      * | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
      * | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -1247,8 +1473,8 @@ export interface Invoice {
      */
     eligible_to_issue_at: string | null;
     /**
-     * A URL for the customer-facing invoice portal. This URL expires 30 days after the
-     * invoice's due date, or 60 days after being re-generated through the UI.
+     * A URL for the customer-facing invoice portal. This URL expires 60 days after the
+     * link is generated, or 30 days after the invoice's due date — whichever is later.
      */
     hosted_invoice_url: string | null;
     /**
@@ -1439,7 +1665,7 @@ export declare namespace Invoice {
          * invoice calculations (ie. usage discounts -> amount discounts -> percentage
          * discounts -> minimums -> maximums).
          */
-        adjustments: Array<Shared.MonetaryUsageDiscountAdjustment | Shared.MonetaryAmountDiscountAdjustment | Shared.MonetaryPercentageDiscountAdjustment | Shared.MonetaryMinimumAdjustment | Shared.MonetaryMaximumAdjustment>;
+        adjustments: Array<Shared.MonetaryUsageDiscountAdjustment | Shared.MonetaryAmountDiscountAdjustment | Shared.MonetaryPercentageDiscountAdjustment | LineItem.MonetaryTieredPercentageDiscountAdjustment | Shared.MonetaryMinimumAdjustment | Shared.MonetaryMaximumAdjustment>;
         /**
          * The final amount for a line item after all adjustments and pre paid credits have
          * been applied.
@@ -1511,6 +1737,82 @@ export declare namespace Invoice {
          */
         usage_customer_ids: Array<string> | null;
     }
+    namespace LineItem {
+        interface MonetaryTieredPercentageDiscountAdjustment {
+            id: string;
+            adjustment_type: 'tiered_percentage_discount';
+            /**
+             * The value applied by an adjustment.
+             */
+            amount: string;
+            /**
+             * @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<MonetaryTieredPercentageDiscountAdjustment.Filter>;
+            /**
+             * True for adjustments that apply to an entire invoice, false for adjustments that
+             * apply to only one price.
+             */
+            is_invoice_level: boolean;
+            /**
+             * The reason for the adjustment.
+             */
+            reason: string | null;
+            /**
+             * The adjustment id this adjustment replaces. This adjustment will take the place
+             * of the replaced adjustment in plan version migrations.
+             */
+            replaces_adjustment_id: string | null;
+            /**
+             * The ordered, contiguous bands of cumulative eligible spend, each discounted at
+             * its own percentage (progressive fill-a-tier), applied to the prices this
+             * adjustment covers in a given billing period.
+             */
+            tiers: Array<MonetaryTieredPercentageDiscountAdjustment.Tier>;
+        }
+        namespace MonetaryTieredPercentageDiscountAdjustment {
+            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>;
+            }
+            /**
+             * One band of a tiered percentage discount. Bounds are denominated in the
+             * discount's currency. `lower_bound` is the exclusive start of the band and
+             * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+             * open-ended final tier.
+             */
+            interface Tier {
+                /**
+                 * Exclusive lower bound of cumulative spend for this tier.
+                 */
+                lower_bound: number;
+                /**
+                 * The percentage (between 0 and 1) discounted from spend that falls within this
+                 * tier.
+                 */
+                percentage: number;
+                /**
+                 * Inclusive upper bound of cumulative spend for this tier; null for the final
+                 * open-ended tier.
+                 */
+                upper_bound?: number | null;
+            }
+        }
+    }
     interface PaymentAttempt {
         /**
          * The ID of the payment attempt.
@@ -1527,7 +1829,7 @@ export declare namespace Invoice {
         /**
          * The payment provider that attempted to collect the payment.
          */
-        payment_provider: 'stripe' | null;
+        payment_provider: 'stripe' | 'adyen' | null;
         /**
          * The ID of the payment attempt in the payment provider.
          */
@@ -1543,7 +1845,66 @@ export declare namespace Invoice {
         succeeded: boolean;
     }
 }
-export type InvoiceLevelDiscount = PercentageDiscount | AmountDiscount | TrialDiscount;
+export type InvoiceLevelDiscount = PercentageDiscount | AmountDiscount | TrialDiscount | InvoiceLevelDiscount.TieredPercentageDiscount;
+export declare namespace InvoiceLevelDiscount {
+    interface TieredPercentageDiscount {
+        discount_type: 'tiered_percentage';
+        /**
+         * Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+         * bands of cumulative eligible spend, each discounted at its own percentage
+         * (progressive fill-a-tier).
+         */
+        tiers: Array<TieredPercentageDiscount.Tier>;
+        /**
+         * List of price_ids that this discount applies to. For plan/plan phase discounts,
+         * this can be a subset of prices.
+         */
+        applies_to_price_ids?: Array<string> | null;
+        /**
+         * The filters that determine which prices to apply this discount to.
+         */
+        filters?: Array<TieredPercentageDiscount.Filter> | null;
+        reason?: string | null;
+    }
+    namespace TieredPercentageDiscount {
+        /**
+         * One band of a tiered percentage discount. Bounds are denominated in the
+         * discount's currency. `lower_bound` is the exclusive start of the band and
+         * `upper_bound` is the inclusive end; `upper_bound` is null only for the
+         * open-ended final tier.
+         */
+        interface Tier {
+            /**
+             * Exclusive lower bound of cumulative spend for this tier.
+             */
+            lower_bound: number;
+            /**
+             * The percentage (between 0 and 1) discounted from spend that falls within this
+             * tier.
+             */
+            percentage: number;
+            /**
+             * Inclusive upper bound of cumulative spend for this tier; null for the final
+             * open-ended tier.
+             */
+            upper_bound?: number | null;
+        }
+        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 InvoiceTiny {
     /**
      * The Invoice id
@@ -2083,6 +2444,14 @@ export interface NewAllocationPrice {
      * The license type ID to associate the price with license allocation.
      */
     license_type_id?: string | null;
+    /**
+     * User-specified key/value pairs for the resource. Individual keys can be removed
+     * by setting the value to `null`, and the entire metadata mapping can be cleared
+     * by setting `metadata` to `null`.
+     */
+    metadata?: {
+        [key: string]: string | null;
+    } | null;
     /**
      * The (per-unit) cost basis of each created block. If non-zero, a customer will be
      * invoiced according to the quantity and per unit cost basis specified for the
@@ -8200,7 +8569,7 @@ export declare namespace PlanPhaseUsageDiscountAdjustment {
  * For more on the types of prices, see
  * [the core concepts documentation](/core-concepts#plan-and-price)
  */
-export type Price = Price.UnitPrice | Price.TieredPrice | Price.BulkPrice | Price.BulkWithFiltersPrice | Price.PackagePrice | Price.MatrixPrice | Price.ThresholdTotalAmountPrice | Price.TieredPackagePrice | Price.TieredWithMinimumPrice | Price.GroupedTieredPrice | Price.TieredPackageWithMinimumPrice | Price.PackageWithAllocationPrice | Price.UnitWithPercentPrice | Price.MatrixWithAllocationPrice | Price.TieredWithProrationPrice | Price.UnitWithProrationPrice | Price.GroupedAllocationPrice | Price.BulkWithProrationPrice | Price.GroupedWithProratedMinimumPrice | Price.GroupedWithMeteredMinimumPrice | Price.GroupedWithMinMaxThresholdsPrice | Price.MatrixWithDisplayNamePrice | Price.GroupedTieredPackagePrice | Price.MaxGroupTieredPackagePrice | Price.ScalableMatrixWithUnitPricingPrice | Price.ScalableMatrixWithTieredPricingPrice | Price.CumulativeGroupedBulkPrice | Price.CumulativeGroupedAllocationPrice | Price.MinimumCompositePrice | Price.PercentCompositePrice | Price.EventOutputPrice;
+export type Price = Price.UnitPrice | Price.TieredPrice | Price.BulkPrice | Price.BulkWithFiltersPrice | Price.PackagePrice | Price.MatrixPrice | Price.ThresholdTotalAmountPrice | Price.TieredPackagePrice | Price.TieredWithMinimumPrice | Price.GroupedTieredPrice | Price.TieredPackageWithMinimumPrice | Price.PackageWithAllocationPrice | Price.UnitWithPercentPrice | Price.MatrixWithAllocationPrice | Price.MatrixWithThresholdDiscountsPrice | Price.TieredWithProrationPrice | Price.UnitWithProrationPrice | Price.GroupedAllocationPrice | Price.BulkWithProrationPrice | Price.GroupedWithProratedMinimumPrice | Price.GroupedWithMeteredMinimumPrice | Price.GroupedWithMinMaxThresholdsPrice | Price.MatrixWithDisplayNamePrice | Price.GroupedTieredPackagePrice | Price.MaxGroupTieredPackagePrice | Price.ScalableMatrixWithUnitPricingPrice | Price.ScalableMatrixWithTieredPricingPrice | Price.CumulativeGroupedBulkPrice | Price.CumulativeGroupedAllocationPrice | Price.DailyCreditAllowancePrice | Price.MeteredAllowancePrice | Price.MinimumCompositePrice | Price.PercentCompositePrice | Price.EventOutputPrice;
 export declare namespace Price {
     interface UnitPrice {
         id: string;
@@ -8220,6 +8589,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8329,6 +8699,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8442,6 +8813,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8551,6 +8923,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8697,6 +9070,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8806,6 +9180,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -8915,6 +9290,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9050,6 +9426,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9184,6 +9561,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9328,6 +9706,7 @@ export declare namespace Price {
          * Configuration for grouped_tiered pricing
          */
         grouped_tiered_config: GroupedTieredPrice.GroupedTieredConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9459,6 +9838,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9589,6 +9969,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9706,6 +10087,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9828,6 +10210,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -9919,13 +10302,13 @@ export declare namespace Price {
             name: string;
         }
     }
-    interface TieredWithProrationPrice {
+    interface MatrixWithThresholdDiscountsPrice {
         id: string;
         billable_metric: Shared.BillableMetricTiny | null;
         billing_cycle_configuration: Shared.BillingCycleConfiguration;
         billing_mode: 'in_advance' | 'in_arrear';
         cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
-        composite_price_filters: Array<TieredWithProrationPrice.CompositePriceFilter> | null;
+        composite_price_filters: Array<MatrixWithThresholdDiscountsPrice.CompositePriceFilter> | null;
         conversion_rate: number | null;
         conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
         created_at: string;
@@ -9937,12 +10320,17 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
          * information.
          */
         item: Shared.ItemSlim;
+        /**
+         * Configuration for matrix_with_threshold_discounts pricing
+         */
+        matrix_with_threshold_discounts_config: MatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
         /**
          * @deprecated
          */
@@ -9971,7 +10359,7 @@ export declare namespace Price {
         /**
          * The pricing model type
          */
-        model_type: 'tiered_with_proration';
+        model_type: 'matrix_with_threshold_discounts';
         name: string;
         plan_phase_order: number | null;
         price_type: 'usage_price' | 'fixed_price' | 'composite_price';
@@ -9980,19 +10368,15 @@ export declare namespace Price {
          * price in plan version migrations.
          */
         replaces_price_id: string | null;
-        /**
-         * Configuration for tiered_with_proration pricing
-         */
-        tiered_with_proration_config: TieredWithProrationPrice.TieredWithProrationConfig;
         dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
         /**
          * The LicenseType resource represents a type of license that can be assigned to
          * users. License types are used during billing by grouping metrics on the
          * configured grouping key.
          */
-        license_type?: TieredWithProrationPrice.LicenseType | null;
+        license_type?: MatrixWithThresholdDiscountsPrice.LicenseType | null;
     }
-    namespace TieredWithProrationPrice {
+    namespace MatrixWithThresholdDiscountsPrice {
         interface CompositePriceFilter {
             /**
              * The property of the price to filter on.
@@ -10008,28 +10392,51 @@ export declare namespace Price {
             values: Array<string>;
         }
         /**
-         * Configuration for tiered_with_proration pricing
+         * Configuration for matrix_with_threshold_discounts pricing
          */
-        interface TieredWithProrationConfig {
+        interface MatrixWithThresholdDiscountsConfig {
             /**
-             * Tiers for rating based on total usage quantities into the specified tier with
-             * proration
+             * Unit price used for usage that does not match any defined matrix cell.
              */
-            tiers: Array<TieredWithProrationConfig.Tier>;
-        }
-        namespace TieredWithProrationConfig {
+            default_unit_amount: string;
             /**
-             * Configuration for a single tiered with proration tier
+             * First matrix dimension key.
              */
-            interface Tier {
+            first_dimension: string;
+            /**
+             * Per-cell unit prices.
+             */
+            matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+            /**
+             * Optional second matrix dimension key.
+             */
+            second_dimension?: string | null;
+            threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+        }
+        namespace MatrixWithThresholdDiscountsConfig {
+            interface MatrixValue {
+                first_dimension_value: string;
+                unit_amount: string;
+                second_dimension_value?: string | null;
+            }
+            interface ThresholdDiscountGroup {
                 /**
-                 * Inclusive tier starting value
+                 * Discount rate applied to spend above the threshold.
                  */
-                tier_lower_bound: string;
+                above_threshold_discount_percentage: string;
                 /**
-                 * Amount per unit
+                 * Discount rate applied to spend at or below the threshold. Set to 0 for no
+                 * baseline discount.
                  */
-                unit_amount: string;
+                below_threshold_discount_percentage: string;
+                /**
+                 * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                 * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                 * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                 */
+                cell_coordinates: string;
+                threshold_amount: string;
+                description?: string | null;
             }
         }
         /**
@@ -10053,13 +10460,13 @@ export declare namespace Price {
             name: string;
         }
     }
-    interface UnitWithProrationPrice {
+    interface TieredWithProrationPrice {
         id: string;
         billable_metric: Shared.BillableMetricTiny | null;
         billing_cycle_configuration: Shared.BillingCycleConfiguration;
         billing_mode: 'in_advance' | 'in_arrear';
         cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
-        composite_price_filters: Array<UnitWithProrationPrice.CompositePriceFilter> | null;
+        composite_price_filters: Array<TieredWithProrationPrice.CompositePriceFilter> | null;
         conversion_rate: number | null;
         conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
         created_at: string;
@@ -10071,6 +10478,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10105,7 +10513,7 @@ export declare namespace Price {
         /**
          * The pricing model type
          */
-        model_type: 'unit_with_proration';
+        model_type: 'tiered_with_proration';
         name: string;
         plan_phase_order: number | null;
         price_type: 'usage_price' | 'fixed_price' | 'composite_price';
@@ -10115,18 +10523,18 @@ export declare namespace Price {
          */
         replaces_price_id: string | null;
         /**
-         * Configuration for unit_with_proration pricing
+         * Configuration for tiered_with_proration pricing
          */
-        unit_with_proration_config: UnitWithProrationPrice.UnitWithProrationConfig;
+        tiered_with_proration_config: TieredWithProrationPrice.TieredWithProrationConfig;
         dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
         /**
          * The LicenseType resource represents a type of license that can be assigned to
          * users. License types are used during billing by grouping metrics on the
          * configured grouping key.
          */
-        license_type?: UnitWithProrationPrice.LicenseType | null;
+        license_type?: TieredWithProrationPrice.LicenseType | null;
     }
-    namespace UnitWithProrationPrice {
+    namespace TieredWithProrationPrice {
         interface CompositePriceFilter {
             /**
              * The property of the price to filter on.
@@ -10142,13 +10550,29 @@ export declare namespace Price {
             values: Array<string>;
         }
         /**
-         * Configuration for unit_with_proration pricing
+         * Configuration for tiered_with_proration pricing
          */
-        interface UnitWithProrationConfig {
+        interface TieredWithProrationConfig {
             /**
-             * Rate per unit of usage
+             * Tiers for rating based on total usage quantities into the specified tier with
+             * proration
              */
-            unit_amount: string;
+            tiers: Array<TieredWithProrationConfig.Tier>;
+        }
+        namespace TieredWithProrationConfig {
+            /**
+             * Configuration for a single tiered with proration tier
+             */
+            interface Tier {
+                /**
+                 * Inclusive tier starting value
+                 */
+                tier_lower_bound: string;
+                /**
+                 * Amount per unit
+                 */
+                unit_amount: string;
+            }
         }
         /**
          * The LicenseType resource represents a type of license that can be assigned to
@@ -10171,13 +10595,13 @@ export declare namespace Price {
             name: string;
         }
     }
-    interface GroupedAllocationPrice {
+    interface UnitWithProrationPrice {
         id: string;
         billable_metric: Shared.BillableMetricTiny | null;
         billing_cycle_configuration: Shared.BillingCycleConfiguration;
         billing_mode: 'in_advance' | 'in_arrear';
         cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
-        composite_price_filters: Array<GroupedAllocationPrice.CompositePriceFilter> | null;
+        composite_price_filters: Array<UnitWithProrationPrice.CompositePriceFilter> | null;
         conversion_rate: number | null;
         conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
         created_at: string;
@@ -10189,10 +10613,130 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
+        invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
-         * Configuration for grouped_allocation pricing
-         */
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
+        item: Shared.ItemSlim;
+        /**
+         * @deprecated
+         */
+        maximum: Shared.Maximum | null;
+        /**
+         * @deprecated
+         */
+        maximum_amount: string | null;
+        /**
+         * User specified key-value pairs for the resource. If not present, this defaults
+         * to an empty dictionary. Individual keys can be removed by setting the value to
+         * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+         * `null`.
+         */
+        metadata: {
+            [key: string]: string;
+        };
+        /**
+         * @deprecated
+         */
+        minimum: Shared.Minimum | null;
+        /**
+         * @deprecated
+         */
+        minimum_amount: string | null;
+        /**
+         * The pricing model type
+         */
+        model_type: 'unit_with_proration';
+        name: string;
+        plan_phase_order: number | null;
+        price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+        /**
+         * The price id this price replaces. This price will take the place of the replaced
+         * price in plan version migrations.
+         */
+        replaces_price_id: string | null;
+        /**
+         * Configuration for unit_with_proration pricing
+         */
+        unit_with_proration_config: UnitWithProrationPrice.UnitWithProrationConfig;
+        dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        license_type?: UnitWithProrationPrice.LicenseType | null;
+    }
+    namespace UnitWithProrationPrice {
+        interface CompositePriceFilter {
+            /**
+             * 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>;
+        }
+        /**
+         * Configuration for unit_with_proration pricing
+         */
+        interface UnitWithProrationConfig {
+            /**
+             * Rate per unit of usage
+             */
+            unit_amount: string;
+        }
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        interface LicenseType {
+            /**
+             * The Orb-assigned unique identifier for the license type.
+             */
+            id: string;
+            /**
+             * The key used for grouping licenses of this type. This is typically a user
+             * identifier field.
+             */
+            grouping_key: string;
+            /**
+             * The name of the license type.
+             */
+            name: string;
+        }
+    }
+    interface GroupedAllocationPrice {
+        id: string;
+        billable_metric: Shared.BillableMetricTiny | null;
+        billing_cycle_configuration: Shared.BillingCycleConfiguration;
+        billing_mode: 'in_advance' | 'in_arrear';
+        cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+        composite_price_filters: Array<GroupedAllocationPrice.CompositePriceFilter> | null;
+        conversion_rate: number | null;
+        conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+        created_at: string;
+        credit_allocation: Shared.Allocation | null;
+        currency: string;
+        /**
+         * @deprecated
+         */
+        discount: Shared.Discount | null;
+        external_price_id: string | null;
+        fixed_price_quantity: number | null;
+        /**
+         * Configuration for grouped_allocation pricing
+         */
         grouped_allocation_config: GroupedAllocationPrice.GroupedAllocationConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10319,6 +10863,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10452,6 +10997,7 @@ export declare namespace Price {
          * Configuration for grouped_with_prorated_minimum pricing
          */
         grouped_with_prorated_minimum_config: GroupedWithProratedMinimumPrice.GroupedWithProratedMinimumConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10578,6 +11124,7 @@ export declare namespace Price {
          * Configuration for grouped_with_metered_minimum pricing
          */
         grouped_with_metered_minimum_config: GroupedWithMeteredMinimumPrice.GroupedWithMeteredMinimumConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10737,6 +11284,7 @@ export declare namespace Price {
          * Configuration for grouped_with_min_max_thresholds pricing
          */
         grouped_with_min_max_thresholds_config: GroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -10863,6 +11411,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11008,6 +11557,7 @@ export declare namespace Price {
          * Configuration for grouped_tiered_package pricing
          */
         grouped_tiered_package_config: GroupedTieredPackagePrice.GroupedTieredPackageConfig;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11140,6 +11690,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11275,6 +11826,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11423,6 +11975,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11571,6 +12124,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11709,6 +12263,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11817,6 +12372,304 @@ export declare namespace Price {
             name: string;
         }
     }
+    interface DailyCreditAllowancePrice {
+        id: string;
+        billable_metric: Shared.BillableMetricTiny | null;
+        billing_cycle_configuration: Shared.BillingCycleConfiguration;
+        billing_mode: 'in_advance' | 'in_arrear';
+        cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+        composite_price_filters: Array<DailyCreditAllowancePrice.CompositePriceFilter> | null;
+        conversion_rate: number | null;
+        conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+        created_at: string;
+        credit_allocation: Shared.Allocation | null;
+        currency: string;
+        /**
+         * Configuration for daily_credit_allowance pricing
+         */
+        daily_credit_allowance_config: DailyCreditAllowancePrice.DailyCreditAllowanceConfig;
+        /**
+         * @deprecated
+         */
+        discount: Shared.Discount | null;
+        external_price_id: string | null;
+        fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
+        invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
+        item: Shared.ItemSlim;
+        /**
+         * @deprecated
+         */
+        maximum: Shared.Maximum | null;
+        /**
+         * @deprecated
+         */
+        maximum_amount: string | null;
+        /**
+         * User specified key-value pairs for the resource. If not present, this defaults
+         * to an empty dictionary. Individual keys can be removed by setting the value to
+         * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+         * `null`.
+         */
+        metadata: {
+            [key: string]: string;
+        };
+        /**
+         * @deprecated
+         */
+        minimum: Shared.Minimum | null;
+        /**
+         * @deprecated
+         */
+        minimum_amount: string | null;
+        /**
+         * The pricing model type
+         */
+        model_type: 'daily_credit_allowance';
+        name: string;
+        plan_phase_order: number | null;
+        price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+        /**
+         * The price id this price replaces. This price will take the place of the replaced
+         * price in plan version migrations.
+         */
+        replaces_price_id: string | null;
+        dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        license_type?: DailyCreditAllowancePrice.LicenseType | null;
+    }
+    namespace DailyCreditAllowancePrice {
+        interface CompositePriceFilter {
+            /**
+             * 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>;
+        }
+        /**
+         * Configuration for daily_credit_allowance pricing
+         */
+        interface DailyCreditAllowanceConfig {
+            /**
+             * Credits granted per day. Lose-it-or-use-it; does not roll over.
+             */
+            daily_allowance: string;
+            /**
+             * Default per-unit credit 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>;
+            /**
+             * Event property whose value identifies the day bucket the event belongs to (e.g.
+             * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+             * resets per distinct value of this property.
+             */
+            event_day_property: string;
+            /**
+             * Per-dimension credit rates
+             */
+            matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+        }
+        namespace DailyCreditAllowanceConfig {
+            /**
+             * Per-dimension credit price for the daily credit allowance model.
+             */
+            interface MatrixValue {
+                /**
+                 * One or two matrix keys to filter usage to this value by. For example, ["model"]
+                 * could be used to apply a different credit rate to each AI model.
+                 */
+                dimension_values: Array<string | null>;
+                /**
+                 * Credits charged per unit of usage matching the specified dimension_values
+                 */
+                unit_amount: string;
+            }
+        }
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        interface LicenseType {
+            /**
+             * The Orb-assigned unique identifier for the license type.
+             */
+            id: string;
+            /**
+             * The key used for grouping licenses of this type. This is typically a user
+             * identifier field.
+             */
+            grouping_key: string;
+            /**
+             * The name of the license type.
+             */
+            name: string;
+        }
+    }
+    interface MeteredAllowancePrice {
+        id: string;
+        billable_metric: Shared.BillableMetricTiny | null;
+        billing_cycle_configuration: Shared.BillingCycleConfiguration;
+        billing_mode: 'in_advance' | 'in_arrear';
+        cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+        composite_price_filters: Array<MeteredAllowancePrice.CompositePriceFilter> | null;
+        conversion_rate: number | null;
+        conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+        created_at: string;
+        credit_allocation: Shared.Allocation | null;
+        currency: string;
+        /**
+         * @deprecated
+         */
+        discount: Shared.Discount | null;
+        external_price_id: string | null;
+        fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
+        invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
+        item: Shared.ItemSlim;
+        /**
+         * @deprecated
+         */
+        maximum: Shared.Maximum | null;
+        /**
+         * @deprecated
+         */
+        maximum_amount: string | null;
+        /**
+         * User specified key-value pairs for the resource. If not present, this defaults
+         * to an empty dictionary. Individual keys can be removed by setting the value to
+         * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+         * `null`.
+         */
+        metadata: {
+            [key: string]: string;
+        };
+        /**
+         * Configuration for metered_allowance pricing
+         */
+        metered_allowance_config: MeteredAllowancePrice.MeteredAllowanceConfig;
+        /**
+         * @deprecated
+         */
+        minimum: Shared.Minimum | null;
+        /**
+         * @deprecated
+         */
+        minimum_amount: string | null;
+        /**
+         * The pricing model type
+         */
+        model_type: 'metered_allowance';
+        name: string;
+        plan_phase_order: number | null;
+        price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+        /**
+         * The price id this price replaces. This price will take the place of the replaced
+         * price in plan version migrations.
+         */
+        replaces_price_id: string | null;
+        dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        license_type?: MeteredAllowancePrice.LicenseType | null;
+    }
+    namespace MeteredAllowancePrice {
+        interface CompositePriceFilter {
+            /**
+             * 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>;
+        }
+        /**
+         * Configuration for metered_allowance pricing
+         */
+        interface MeteredAllowanceConfig {
+            /**
+             * The grouping_key value whose summed quantity represents the allowance for this
+             * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+             * — credit can never exceed actual usage.
+             */
+            allowance_grouping_value: string;
+            /**
+             * The grouping_key value whose summed quantity represents consumption (e.g.
+             * 'download'). Charged at unit_amount.
+             */
+            consumption_grouping_value: string;
+            /**
+             * Event property used to partition the metric into consumption and allowance
+             * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+             * values below select which partition is which.
+             */
+            grouping_key: string;
+            /**
+             * Per-unit price applied to gross consumption and to the allowance credit.
+             */
+            unit_amount: string;
+            /**
+             * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+             */
+            allowance_display_name?: string;
+            /**
+             * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+             */
+            consumption_display_name?: string;
+        }
+        /**
+         * The LicenseType resource represents a type of license that can be assigned to
+         * users. License types are used during billing by grouping metrics on the
+         * configured grouping key.
+         */
+        interface LicenseType {
+            /**
+             * The Orb-assigned unique identifier for the license type.
+             */
+            id: string;
+            /**
+             * The key used for grouping licenses of this type. This is typically a user
+             * identifier field.
+             */
+            grouping_key: string;
+            /**
+             * The name of the license type.
+             */
+            name: string;
+        }
+    }
     interface MinimumCompositePrice {
         id: string;
         billable_metric: Shared.BillableMetricTiny | null;
@@ -11835,6 +12688,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -11957,6 +12811,7 @@ export declare namespace Price {
         discount: Shared.Discount | null;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying
@@ -12032,9 +12887,23 @@ export declare namespace Price {
          */
         interface PercentConfig {
             /**
-             * What percent of the component subtotals to charge
+             * Fraction of the component subtotals to charge (0 < percent <= 1).
              */
             percent: number;
+            /**
+             * Maximum amount to charge. If unset, the fee has no upper bound.
+             */
+            maximum_amount?: string | null;
+            /**
+             * Minimum amount to charge. If unset, the fee is bounded below by 0.
+             */
+            minimum_amount?: string | null;
+            /**
+             * If true, the minimum_amount is prorated based on the service period. The
+             * maximum_amount is an absolute cap (never prorated), and the percent applied to
+             * upstream subtotals is never prorated either.
+             */
+            prorated?: boolean;
         }
         /**
          * The LicenseType resource represents a type of license that can be assigned to
@@ -12079,6 +12948,7 @@ export declare namespace Price {
         event_output_config: EventOutputPrice.EventOutputConfig;
         external_price_id: string | null;
         fixed_price_quantity: number | null;
+        invoice_grouping_key: string | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
         /**
          * A minimal representation of an Item containing only the essential identifying