metronome-sdk 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/rbi/metronome_sdk/models/v2/contract_retrieve_response.rbi

@@ -186,6 +186,28 @@ module MetronomeSDK
           sig { params(ending_before: Time).void }
           attr_writer :ending_before
 
+          # Either a **parent** configuration with a list of children or a **child**
+          # configuration with a single parent.
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::Variants
+              )
+            )
+          end
+          attr_reader :hierarchy_configuration
+
+          sig do
+            params(
+              hierarchy_configuration:
+                T.any(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::OrHash,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::OrHash
+                )
+            ).void
+          end
+          attr_writer :hierarchy_configuration
+
           # Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
           # prices automatically. EXPLICIT prioritization requires specifying priorities for
           # each multiplier; the one with the lowest priority value will be prioritized
@@ -243,6 +265,13 @@ module MetronomeSDK
           end
           attr_writer :prepaid_balance_threshold_configuration
 
+          # Priority of the contract.
+          sig { returns(T.nilable(Float)) }
+          attr_reader :priority
+
+          sig { params(priority: Float).void }
+          attr_writer :priority
+
           # This field's availability is dependent on your client's configuration.
           sig { returns(T.nilable(T::Array[MetronomeSDK::ProService])) }
           attr_reader :professional_services
@@ -370,6 +399,28 @@ module MetronomeSDK
           end
           attr_writer :spend_threshold_configuration
 
+          # List of subscriptions on the contract.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription
+                ]
+              )
+            )
+          end
+          attr_reader :subscriptions
+
+          sig do
+            params(
+              subscriptions:
+                T::Array[
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::OrHash
+                ]
+            ).void
+          end
+          attr_writer :subscriptions
+
           sig { returns(T.nilable(Float)) }
           attr_reader :total_contract_value
 
@@ -422,6 +473,11 @@ module MetronomeSDK
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::CustomerBillingProviderConfiguration::OrHash,
               discounts: T::Array[MetronomeSDK::Discount::OrHash],
               ending_before: Time,
+              hierarchy_configuration:
+                T.any(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::OrHash,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::OrHash
+                ),
               multiplier_override_prioritization:
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization::OrSymbol,
               name: String,
@@ -429,6 +485,7 @@ module MetronomeSDK
               netsuite_sales_order_id: String,
               prepaid_balance_threshold_configuration:
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::OrHash,
+              priority: Float,
               professional_services: T::Array[MetronomeSDK::ProService::OrHash],
               rate_card_id: String,
               recurring_commits:
@@ -448,6 +505,10 @@ module MetronomeSDK
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::ScheduledChargesOnUsageInvoices::OrSymbol,
               spend_threshold_configuration:
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::OrHash,
+              subscriptions:
+                T::Array[
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::OrHash
+                ],
               total_contract_value: Float,
               uniqueness_key: String
             ).returns(T.attached_class)
@@ -472,6 +533,9 @@ module MetronomeSDK
             # This field's availability is dependent on your client's configuration.
             discounts: nil,
             ending_before: nil,
+            # Either a **parent** configuration with a list of children or a **child**
+            # configuration with a single parent.
+            hierarchy_configuration: nil,
             # Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
             # prices automatically. EXPLICIT prioritization requires specifying priorities for
             # each multiplier; the one with the lowest priority value will be prioritized
@@ -482,6 +546,8 @@ module MetronomeSDK
             # This field's availability is dependent on your client's configuration.
             netsuite_sales_order_id: nil,
             prepaid_balance_threshold_configuration: nil,
+            # Priority of the contract.
+            priority: nil,
             # This field's availability is dependent on your client's configuration.
             professional_services: nil,
             rate_card_id: nil,
@@ -498,6 +564,8 @@ module MetronomeSDK
             # on a separate invoice from usage charges.
             scheduled_charges_on_usage_invoices: nil,
             spend_threshold_configuration: nil,
+            # List of subscriptions on the contract.
+            subscriptions: nil,
             total_contract_value: nil,
             # Prevents the creation of duplicates. If a request to create a record is made
             # with a previously used uniqueness key, a new record will not be created and the
@@ -543,6 +611,8 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::CustomerBillingProviderConfiguration,
                 discounts: T::Array[MetronomeSDK::Discount],
                 ending_before: Time,
+                hierarchy_configuration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::Variants,
                 multiplier_override_prioritization:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization::TaggedSymbol,
                 name: String,
@@ -550,6 +620,7 @@ module MetronomeSDK
                 netsuite_sales_order_id: String,
                 prepaid_balance_threshold_configuration:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration,
+                priority: Float,
                 professional_services: T::Array[MetronomeSDK::ProService],
                 rate_card_id: String,
                 recurring_commits:
@@ -569,6 +640,10 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::ScheduledChargesOnUsageInvoices::TaggedSymbol,
                 spend_threshold_configuration:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration,
+                subscriptions:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription
+                  ],
                 total_contract_value: Float,
                 uniqueness_key: String
               }
@@ -690,6 +765,24 @@ module MetronomeSDK
             sig { params(description: String).void }
             attr_writer :description
 
+            # Optional configuration for commit hierarchy access control
+            sig do
+              returns(
+                T.nilable(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration
+                )
+              )
+            end
+            attr_reader :hierarchy_configuration
+
+            sig do
+              params(
+                hierarchy_configuration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::OrHash
+              ).void
+            end
+            attr_writer :hierarchy_configuration
+
             # The contract that this commit will be billed on.
             sig do
               returns(
@@ -725,21 +818,7 @@ module MetronomeSDK
               returns(
                 T.nilable(
                   T::Array[
-                    T.any(
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitSegmentStartLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitAutomatedInvoiceDeductionLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitRolloverLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitExpirationLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitCanceledLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitCreditedLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitInitialBalanceLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitAutomatedInvoiceDeductionLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitRolloverLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitTrueupLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitManualLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitManualLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitExpirationLedgerEntry
-                    )
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::Variants
                   ]
                 )
               )
@@ -838,6 +917,30 @@ module MetronomeSDK
             sig { params(salesforce_opportunity_id: String).void }
             attr_writer :salesforce_opportunity_id
 
+            # List of filters that determine what kind of customer usage draws down a commit
+            # or credit. A customer's usage needs to meet the condition of at least one of the
+            # specifiers to contribute to a commit's or credit's drawdown.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Specifier
+                  ]
+                )
+              )
+            end
+            attr_reader :specifiers
+
+            sig do
+              params(
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Specifier::OrHash
+                  ]
+              ).void
+            end
+            attr_writer :specifiers
+
             sig do
               params(
                 id: String,
@@ -855,6 +958,8 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Contract::OrHash,
                 custom_fields: T::Hash[Symbol, String],
                 description: String,
+                hierarchy_configuration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::OrHash,
                 invoice_contract:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::InvoiceContract::OrHash,
                 invoice_schedule: MetronomeSDK::SchedulePointInTime::OrHash,
@@ -884,7 +989,11 @@ module MetronomeSDK
                 rolled_over_from:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::RolledOverFrom::OrHash,
                 rollover_fraction: Float,
-                salesforce_opportunity_id: String
+                salesforce_opportunity_id: String,
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Specifier::OrHash
+                  ]
               ).returns(T.attached_class)
             end
             def self.new(
@@ -910,6 +1019,8 @@ module MetronomeSDK
               contract: nil,
               custom_fields: nil,
               description: nil,
+              # Optional configuration for commit hierarchy access control
+              hierarchy_configuration: nil,
               # The contract that this commit will be billed on.
               invoice_contract: nil,
               # The schedule that the customer will be invoiced for this commit.
@@ -927,7 +1038,11 @@ module MetronomeSDK
               rolled_over_from: nil,
               rollover_fraction: nil,
               # This field's availability is dependent on your client's configuration.
-              salesforce_opportunity_id: nil
+              salesforce_opportunity_id: nil,
+              # List of filters that determine what kind of customer usage draws down a commit
+              # or credit. A customer's usage needs to meet the condition of at least one of the
+              # specifiers to contribute to a commit's or credit's drawdown.
+              specifiers: nil
             )
             end
 
@@ -949,26 +1064,14 @@ module MetronomeSDK
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Contract,
                   custom_fields: T::Hash[Symbol, String],
                   description: String,
+                  hierarchy_configuration:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration,
                   invoice_contract:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::InvoiceContract,
                   invoice_schedule: MetronomeSDK::SchedulePointInTime,
                   ledger:
                     T::Array[
-                      T.any(
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitSegmentStartLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitAutomatedInvoiceDeductionLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitRolloverLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitExpirationLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitCanceledLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitCreditedLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitInitialBalanceLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitAutomatedInvoiceDeductionLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitRolloverLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitTrueupLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PrepaidCommitManualLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitManualLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::PostpaidCommitExpirationLedgerEntry
-                      )
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Ledger::Variants
                     ],
                   name: String,
                   netsuite_sales_order_id: String,
@@ -978,7 +1081,11 @@ module MetronomeSDK
                   rolled_over_from:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::RolledOverFrom,
                   rollover_fraction: Float,
-                  salesforce_opportunity_id: String
+                  salesforce_opportunity_id: String,
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Specifier
+                    ]
                 }
               )
             end
@@ -1064,6 +1171,274 @@ module MetronomeSDK
               end
             end
 
+            class HierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::Variants
+                )
+              end
+              attr_accessor :child_access
+
+              # Optional configuration for commit hierarchy access control
+              sig do
+                params(
+                  child_access:
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::OrHash,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::OrHash,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::OrHash
+                    )
+                ).returns(T.attached_class)
+              end
+              def self.new(child_access:)
+              end
+
+              sig do
+                override.returns(
+                  {
+                    child_access:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::Variants
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module ChildAccess
+                extend MetronomeSDK::Internal::Type::Union
+
+                Variants =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs
+                    )
+                  end
+
+                class CommitHierarchyChildAccessAll < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll,
+                        MetronomeSDK::Internal::AnyHash
+                      )
+                    end
+
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                    )
+                  end
+                  attr_accessor :type
+
+                  sig do
+                    params(
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(type:)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    ALL =
+                      T.let(
+                        :ALL,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class CommitHierarchyChildAccessNone < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone,
+                        MetronomeSDK::Internal::AnyHash
+                      )
+                    end
+
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                    )
+                  end
+                  attr_accessor :type
+
+                  sig do
+                    params(
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(type:)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    NONE =
+                      T.let(
+                        :NONE,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class CommitHierarchyChildAccessContractIDs < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs,
+                        MetronomeSDK::Internal::AnyHash
+                      )
+                    end
+
+                  sig { returns(T::Array[String]) }
+                  attr_accessor :contract_ids
+
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                    )
+                  end
+                  attr_accessor :type
+
+                  sig do
+                    params(
+                      contract_ids: T::Array[String],
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(contract_ids:, type:)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        contract_ids: T::Array[String],
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    CONTRACT_IDS =
+                      T.let(
+                        :CONTRACT_IDS,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::HierarchyConfiguration::ChildAccess::Variants
+                    ]
+                  )
+                end
+                def self.variants
+                end
+              end
+            end
+
             class InvoiceContract < MetronomeSDK::Internal::Type::BaseModel
               OrHash =
                 T.type_alias do
@@ -2291,33 +2666,104 @@ module MetronomeSDK
               def to_hash
               end
             end
-          end
 
-          class Override < MetronomeSDK::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override,
-                  MetronomeSDK::Internal::AnyHash
-                )
-              end
+            class Specifier < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Commit::Specifier,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
 
-            sig { returns(String) }
-            attr_accessor :id
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :presentation_group_values
 
-            sig { returns(Time) }
-            attr_accessor :starting_at
+              sig do
+                params(presentation_group_values: T::Hash[Symbol, String]).void
+              end
+              attr_writer :presentation_group_values
 
-            sig { returns(T.nilable(T::Array[String])) }
-            attr_reader :applicable_product_tags
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :pricing_group_values
 
-            sig { params(applicable_product_tags: T::Array[String]).void }
-            attr_writer :applicable_product_tags
+              sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+              attr_writer :pricing_group_values
 
-            sig { returns(T.nilable(Time)) }
-            attr_reader :ending_before
+              # If provided, the specifier will only apply to the product with the specified ID.
+              sig { returns(T.nilable(String)) }
+              attr_reader :product_id
 
-            sig { params(ending_before: Time).void }
+              sig { params(product_id: String).void }
+              attr_writer :product_id
+
+              # If provided, the specifier will only apply to products with all the specified
+              # tags.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :product_tags
+
+              sig { params(product_tags: T::Array[String]).void }
+              attr_writer :product_tags
+
+              sig do
+                params(
+                  presentation_group_values: T::Hash[Symbol, String],
+                  pricing_group_values: T::Hash[Symbol, String],
+                  product_id: String,
+                  product_tags: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                presentation_group_values: nil,
+                pricing_group_values: nil,
+                # If provided, the specifier will only apply to the product with the specified ID.
+                product_id: nil,
+                # If provided, the specifier will only apply to products with all the specified
+                # tags.
+                product_tags: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    presentation_group_values: T::Hash[Symbol, String],
+                    pricing_group_values: T::Hash[Symbol, String],
+                    product_id: String,
+                    product_tags: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
+          end
+
+          class Override < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :id
+
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :applicable_product_tags
+
+            sig { params(applicable_product_tags: T::Array[String]).void }
+            attr_writer :applicable_product_tags
+
+            sig { returns(T.nilable(Time)) }
+            attr_reader :ending_before
+
+            sig { params(ending_before: Time).void }
             attr_writer :ending_before
 
             sig { returns(T.nilable(T::Boolean)) }
@@ -2542,6 +2988,23 @@ module MetronomeSDK
                   )
                 end
 
+              sig do
+                returns(
+                  T.nilable(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                  )
+                )
+              end
+              attr_reader :billing_frequency
+
+              sig do
+                params(
+                  billing_frequency:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::OrSymbol
+                ).void
+              end
+              attr_writer :billing_frequency
+
               sig { returns(T.nilable(T::Array[String])) }
               attr_reader :commit_ids
 
@@ -2590,6 +3053,8 @@ module MetronomeSDK
 
               sig do
                 params(
+                  billing_frequency:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::OrSymbol,
                   commit_ids: T::Array[String],
                   presentation_group_values: T::Hash[Symbol, T.nilable(String)],
                   pricing_group_values: T::Hash[Symbol, String],
@@ -2600,6 +3065,7 @@ module MetronomeSDK
                 ).returns(T.attached_class)
               end
               def self.new(
+                billing_frequency: nil,
                 commit_ids: nil,
                 presentation_group_values: nil,
                 pricing_group_values: nil,
@@ -2613,6 +3079,8 @@ module MetronomeSDK
               sig do
                 override.returns(
                   {
+                    billing_frequency:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol,
                     commit_ids: T::Array[String],
                     presentation_group_values:
                       T::Hash[Symbol, T.nilable(String)],
@@ -2626,6 +3094,50 @@ module MetronomeSDK
               end
               def to_hash
               end
+
+              module BillingFrequency
+                extend MetronomeSDK::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                MONTHLY =
+                  T.let(
+                    :MONTHLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                  )
+                QUARTERLY =
+                  T.let(
+                    :QUARTERLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                  )
+                ANNUAL =
+                  T.let(
+                    :ANNUAL,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                  )
+                WEEKLY =
+                  T.let(
+                    :WEEKLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
             end
 
             class OverrideTier < MetronomeSDK::Internal::Type::BaseModel
@@ -3255,20 +3767,31 @@ module MetronomeSDK
             sig { params(description: String).void }
             attr_writer :description
 
+            # Optional configuration for credit hierarchy access control
+            sig do
+              returns(
+                T.nilable(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration
+                )
+              )
+            end
+            attr_reader :hierarchy_configuration
+
+            sig do
+              params(
+                hierarchy_configuration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::OrHash
+              ).void
+            end
+            attr_writer :hierarchy_configuration
+
             # A list of ordered events that impact the balance of a credit. For example, an
             # invoice deduction or an expiration.
             sig do
               returns(
                 T.nilable(
                   T::Array[
-                    T.any(
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditExpirationLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCanceledLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCreditedLedgerEntry,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditManualLedgerEntry
-                    )
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::Variants
                   ]
                 )
               )
@@ -3320,6 +3843,30 @@ module MetronomeSDK
             sig { params(salesforce_opportunity_id: String).void }
             attr_writer :salesforce_opportunity_id
 
+            # List of filters that determine what kind of customer usage draws down a commit
+            # or credit. A customer's usage needs to meet the condition of at least one of the
+            # specifiers to contribute to a commit's or credit's drawdown.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Specifier
+                  ]
+                )
+              )
+            end
+            attr_reader :specifiers
+
+            sig do
+              params(
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Specifier::OrHash
+                  ]
+              ).void
+            end
+            attr_writer :specifiers
+
             sig do
               params(
                 id: String,
@@ -3336,6 +3883,8 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Contract::OrHash,
                 custom_fields: T::Hash[Symbol, String],
                 description: String,
+                hierarchy_configuration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::OrHash,
                 ledger:
                   T::Array[
                     T.any(
@@ -3350,7 +3899,11 @@ module MetronomeSDK
                 name: String,
                 netsuite_sales_order_id: String,
                 priority: Float,
-                salesforce_opportunity_id: String
+                salesforce_opportunity_id: String,
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Specifier::OrHash
+                  ]
               ).returns(T.attached_class)
             end
             def self.new(
@@ -3374,6 +3927,8 @@ module MetronomeSDK
               contract: nil,
               custom_fields: nil,
               description: nil,
+              # Optional configuration for credit hierarchy access control
+              hierarchy_configuration: nil,
               # A list of ordered events that impact the balance of a credit. For example, an
               # invoice deduction or an expiration.
               ledger: nil,
@@ -3384,7 +3939,11 @@ module MetronomeSDK
               # will apply first.
               priority: nil,
               # This field's availability is dependent on your client's configuration.
-              salesforce_opportunity_id: nil
+              salesforce_opportunity_id: nil,
+              # List of filters that determine what kind of customer usage draws down a commit
+              # or credit. A customer's usage needs to meet the condition of at least one of the
+              # specifiers to contribute to a commit's or credit's drawdown.
+              specifiers: nil
             )
             end
 
@@ -3405,21 +3964,20 @@ module MetronomeSDK
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Contract,
                   custom_fields: T::Hash[Symbol, String],
                   description: String,
+                  hierarchy_configuration:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration,
                   ledger:
                     T::Array[
-                      T.any(
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditExpirationLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCanceledLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCreditedLedgerEntry,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditManualLedgerEntry
-                      )
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::Variants
                     ],
                   name: String,
                   netsuite_sales_order_id: String,
                   priority: Float,
-                  salesforce_opportunity_id: String
+                  salesforce_opportunity_id: String,
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Specifier
+                    ]
                 }
               )
             end
@@ -3500,108 +4058,376 @@ module MetronomeSDK
               end
             end
 
-            module Ledger
-              extend MetronomeSDK::Internal::Type::Union
-
-              Variants =
+            class HierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
                 T.type_alias do
                   T.any(
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditExpirationLedgerEntry,
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCanceledLedgerEntry,
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCreditedLedgerEntry,
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditManualLedgerEntry
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration,
+                    MetronomeSDK::Internal::AnyHash
                   )
                 end
 
-              class CreditSegmentStartLedgerEntry < MetronomeSDK::Internal::Type::BaseModel
-                OrHash =
-                  T.type_alias do
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::Variants
+                )
+              end
+              attr_accessor :child_access
+
+              # Optional configuration for credit hierarchy access control
+              sig do
+                params(
+                  child_access:
                     T.any(
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
-                      MetronomeSDK::Internal::AnyHash
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::OrHash,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::OrHash,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::OrHash
                     )
-                  end
-
-                sig { returns(Float) }
-                attr_accessor :amount
-
-                sig { returns(String) }
-                attr_accessor :segment_id
-
-                sig { returns(Time) }
-                attr_accessor :timestamp
-
-                sig do
-                  returns(
-                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
-                  )
-                end
-                attr_accessor :type
+                ).returns(T.attached_class)
+              end
+              def self.new(child_access:)
+              end
 
-                sig do
-                  params(
-                    amount: Float,
-                    segment_id: String,
-                    timestamp: Time,
-                    type:
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::OrSymbol
-                  ).returns(T.attached_class)
-                end
-                def self.new(amount:, segment_id:, timestamp:, type:)
-                end
+              sig do
+                override.returns(
+                  {
+                    child_access:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::Variants
+                  }
+                )
+              end
+              def to_hash
+              end
 
-                sig do
-                  override.returns(
-                    {
-                      amount: Float,
-                      segment_id: String,
-                      timestamp: Time,
-                      type:
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
-                    }
-                  )
-                end
-                def to_hash
-                end
+              module ChildAccess
+                extend MetronomeSDK::Internal::Type::Union
 
-                module Type
-                  extend MetronomeSDK::Internal::Type::Enum
+                Variants =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs
+                    )
+                  end
 
-                  TaggedSymbol =
+                class CommitHierarchyChildAccessAll < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
                     T.type_alias do
-                      T.all(
-                        Symbol,
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll,
+                        MetronomeSDK::Internal::AnyHash
                       )
                     end
-                  OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-                  CREDIT_SEGMENT_START =
-                    T.let(
-                      :CREDIT_SEGMENT_START,
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
                     )
+                  end
+                  attr_accessor :type
 
                   sig do
-                    override.returns(
-                      T::Array[
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
-                      ]
-                    )
+                    params(
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::OrSymbol
+                    ).returns(T.attached_class)
                   end
-                  def self.values
+                  def self.new(type:)
                   end
-                end
-              end
 
-              class CreditAutomatedInvoiceDeductionLedgerEntry < MetronomeSDK::Internal::Type::BaseModel
-                OrHash =
-                  T.type_alias do
-                    T.any(
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
-                      MetronomeSDK::Internal::AnyHash
+                  sig do
+                    override.returns(
+                      {
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    ALL =
+                      T.let(
+                        :ALL,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessAll::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class CommitHierarchyChildAccessNone < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone,
+                        MetronomeSDK::Internal::AnyHash
+                      )
+                    end
+
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                    )
+                  end
+                  attr_accessor :type
+
+                  sig do
+                    params(
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(type:)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    NONE =
+                      T.let(
+                        :NONE,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessNone::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class CommitHierarchyChildAccessContractIDs < MetronomeSDK::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs,
+                        MetronomeSDK::Internal::AnyHash
+                      )
+                    end
+
+                  sig { returns(T::Array[String]) }
+                  attr_accessor :contract_ids
+
+                  sig do
+                    returns(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                    )
+                  end
+                  attr_accessor :type
+
+                  sig do
+                    params(
+                      contract_ids: T::Array[String],
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(contract_ids:, type:)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        contract_ids: T::Array[String],
+                        type:
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    CONTRACT_IDS =
+                      T.let(
+                        :CONTRACT_IDS,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::CommitHierarchyChildAccessContractIDs::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::HierarchyConfiguration::ChildAccess::Variants
+                    ]
+                  )
+                end
+                def self.variants
+                end
+              end
+            end
+
+            module Ledger
+              extend MetronomeSDK::Internal::Type::Union
+
+              Variants =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditExpirationLedgerEntry,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCanceledLedgerEntry,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditCreditedLedgerEntry,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditManualLedgerEntry
+                  )
+                end
+
+              class CreditSegmentStartLedgerEntry < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(Float) }
+                attr_accessor :amount
+
+                sig { returns(String) }
+                attr_accessor :segment_id
+
+                sig { returns(Time) }
+                attr_accessor :timestamp
+
+                sig do
+                  returns(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
+                  )
+                end
+                attr_accessor :type
+
+                sig do
+                  params(
+                    amount: Float,
+                    segment_id: String,
+                    timestamp: Time,
+                    type:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::OrSymbol
+                  ).returns(T.attached_class)
+                end
+                def self.new(amount:, segment_id:, timestamp:, type:)
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      amount: Float,
+                      segment_id: String,
+                      timestamp: Time,
+                      type:
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                module Type
+                  extend MetronomeSDK::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  CREDIT_SEGMENT_START =
+                    T.let(
+                      :CREDIT_SEGMENT_START,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditSegmentStartLedgerEntry::Type::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
+              class CreditAutomatedInvoiceDeductionLedgerEntry < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Ledger::CreditAutomatedInvoiceDeductionLedgerEntry,
+                      MetronomeSDK::Internal::AnyHash
                     )
                   end
 
@@ -4044,6 +4870,77 @@ module MetronomeSDK
               def self.variants
               end
             end
+
+            class Specifier < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Credit::Specifier,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :presentation_group_values
+
+              sig do
+                params(presentation_group_values: T::Hash[Symbol, String]).void
+              end
+              attr_writer :presentation_group_values
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :pricing_group_values
+
+              sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+              attr_writer :pricing_group_values
+
+              # If provided, the specifier will only apply to the product with the specified ID.
+              sig { returns(T.nilable(String)) }
+              attr_reader :product_id
+
+              sig { params(product_id: String).void }
+              attr_writer :product_id
+
+              # If provided, the specifier will only apply to products with all the specified
+              # tags.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :product_tags
+
+              sig { params(product_tags: T::Array[String]).void }
+              attr_writer :product_tags
+
+              sig do
+                params(
+                  presentation_group_values: T::Hash[Symbol, String],
+                  pricing_group_values: T::Hash[Symbol, String],
+                  product_id: String,
+                  product_tags: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                presentation_group_values: nil,
+                pricing_group_values: nil,
+                # If provided, the specifier will only apply to the product with the specified ID.
+                product_id: nil,
+                # If provided, the specifier will only apply to products with all the specified
+                # tags.
+                product_tags: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    presentation_group_values: T::Hash[Symbol, String],
+                    pricing_group_values: T::Hash[Symbol, String],
+                    product_id: String,
+                    product_tags: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
           end
 
           class CustomerBillingProviderConfiguration < MetronomeSDK::Internal::Type::BaseModel
@@ -4203,29 +5100,210 @@ module MetronomeSDK
             end
           end
 
-          # Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
-          # prices automatically. EXPLICIT prioritization requires specifying priorities for
-          # each multiplier; the one with the lowest priority value will be prioritized
-          # first.
-          module MultiplierOverridePrioritization
-            extend MetronomeSDK::Internal::Type::Enum
+          # Either a **parent** configuration with a list of children or a **child**
+          # configuration with a single parent.
+          module HierarchyConfiguration
+            extend MetronomeSDK::Internal::Type::Union
 
-            TaggedSymbol =
+            Variants =
               T.type_alias do
-                T.all(
-                  Symbol,
-                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization
+                T.any(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration
                 )
               end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-            LOWEST_MULTIPLIER =
-              T.let(
-                :LOWEST_MULTIPLIER,
-                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization::TaggedSymbol
-              )
-            EXPLICIT =
-              T.let(
+            class ParentHierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              # List of contracts that belong to this parent.
+              sig do
+                returns(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::Child
+                  ]
+                )
+              end
+              attr_accessor :children
+
+              sig do
+                params(
+                  children:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::Child::OrHash
+                    ]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # List of contracts that belong to this parent.
+                children:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    children:
+                      T::Array[
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::Child
+                      ]
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Child < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ParentHierarchyConfiguration::Child,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(String) }
+                attr_accessor :contract_id
+
+                sig { returns(String) }
+                attr_accessor :customer_id
+
+                sig do
+                  params(contract_id: String, customer_id: String).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(contract_id:, customer_id:)
+                end
+
+                sig do
+                  override.returns({ contract_id: String, customer_id: String })
+                end
+                def to_hash
+                end
+              end
+            end
+
+            class ChildHierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              # The single parent contract/customer for this child.
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::Parent
+                )
+              end
+              attr_reader :parent
+
+              sig do
+                params(
+                  parent:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::Parent::OrHash
+                ).void
+              end
+              attr_writer :parent
+
+              sig do
+                params(
+                  parent:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::Parent::OrHash
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # The single parent contract/customer for this child.
+                parent:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    parent:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::Parent
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Parent < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::ChildHierarchyConfiguration::Parent,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(String) }
+                attr_accessor :contract_id
+
+                sig { returns(String) }
+                attr_accessor :customer_id
+
+                # The single parent contract/customer for this child.
+                sig do
+                  params(contract_id: String, customer_id: String).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(contract_id:, customer_id:)
+                end
+
+                sig do
+                  override.returns({ contract_id: String, customer_id: String })
+                end
+                def to_hash
+                end
+              end
+            end
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::HierarchyConfiguration::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
+          end
+
+          # Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
+          # prices automatically. EXPLICIT prioritization requires specifying priorities for
+          # each multiplier; the one with the lowest priority value will be prioritized
+          # first.
+          module MultiplierOverridePrioritization
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            LOWEST_MULTIPLIER =
+              T.let(
+                :LOWEST_MULTIPLIER,
+                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization::TaggedSymbol
+              )
+            EXPLICIT =
+              T.let(
                 :EXPLICIT,
                 MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::MultiplierOverridePrioritization::TaggedSymbol
               )
@@ -4295,6 +5373,14 @@ module MetronomeSDK
             sig { returns(Float) }
             attr_accessor :threshold_amount
 
+            # If provided, the threshold, recharge-to amount, and the resulting threshold
+            # commit amount will be in terms of this credit type instead of the fiat currency.
+            sig { returns(T.nilable(String)) }
+            attr_reader :custom_credit_type_id
+
+            sig { params(custom_credit_type_id: String).void }
+            attr_writer :custom_credit_type_id
+
             sig do
               params(
                 commit:
@@ -4303,7 +5389,8 @@ module MetronomeSDK
                 payment_gate_config:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::OrHash,
                 recharge_to_amount: Float,
-                threshold_amount: Float
+                threshold_amount: Float,
+                custom_credit_type_id: String
               ).returns(T.attached_class)
             end
             def self.new(
@@ -4317,7 +5404,10 @@ module MetronomeSDK
               recharge_to_amount:,
               # Specify the threshold amount for the contract. Each time the contract's balance
               # lowers to this amount, a threshold charge will be initiated.
-              threshold_amount:
+              threshold_amount:,
+              # If provided, the threshold, recharge-to amount, and the resulting threshold
+              # commit amount will be in terms of this credit type instead of the fiat currency.
+              custom_credit_type_id: nil
             )
             end
 
@@ -4330,7 +5420,8 @@ module MetronomeSDK
                   payment_gate_config:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig,
                   recharge_to_amount: Float,
-                  threshold_amount: Float
+                  threshold_amount: Float,
+                  custom_credit_type_id: String
                 }
               )
             end
@@ -4351,17 +5442,18 @@ module MetronomeSDK
               sig { returns(String) }
               attr_accessor :product_id
 
-              # Which products the threshold commit applies to. If both applicable_product_ids
-              # and applicable_product_tags are not provided, the commit applies to all
-              # products.
+              # Which products the threshold commit applies to. If applicable_product_ids,
+              # applicable_product_tags or specifiers are not provided, the commit applies to
+              # all products.
               sig { returns(T.nilable(T::Array[String])) }
               attr_reader :applicable_product_ids
 
               sig { params(applicable_product_ids: T::Array[String]).void }
               attr_writer :applicable_product_ids
 
-              # Which tags the threshold commit applies to. If both applicable_product_ids and
-              # applicable_product_tags are not provided, the commit applies to all products.
+              # Which tags the threshold commit applies to. If applicable_product_ids,
+              # applicable_product_tags or specifiers are not provided, the commit applies to
+              # all products.
               sig { returns(T.nilable(T::Array[String])) }
               attr_reader :applicable_product_tags
 
@@ -4382,30 +5474,65 @@ module MetronomeSDK
               sig { params(name: String).void }
               attr_writer :name
 
+              # List of filters that determine what kind of customer usage draws down a commit
+              # or credit. A customer's usage needs to meet the condition of at least one of the
+              # specifiers to contribute to a commit's or credit's drawdown. This field cannot
+              # be used together with `applicable_product_ids` or `applicable_product_tags`.
+              sig do
+                returns(
+                  T.nilable(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::Commit::Specifier
+                    ]
+                  )
+                )
+              end
+              attr_reader :specifiers
+
+              sig do
+                params(
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::Commit::Specifier::OrHash
+                    ]
+                ).void
+              end
+              attr_writer :specifiers
+
               sig do
                 params(
                   product_id: String,
                   applicable_product_ids: T::Array[String],
                   applicable_product_tags: T::Array[String],
                   description: String,
-                  name: String
+                  name: String,
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::Commit::Specifier::OrHash
+                    ]
                 ).returns(T.attached_class)
               end
               def self.new(
                 # The commit product that will be used to generate the line item for commit
                 # payment.
                 product_id:,
-                # Which products the threshold commit applies to. If both applicable_product_ids
-                # and applicable_product_tags are not provided, the commit applies to all
-                # products.
+                # Which products the threshold commit applies to. If applicable_product_ids,
+                # applicable_product_tags or specifiers are not provided, the commit applies to
+                # all products.
                 applicable_product_ids: nil,
-                # Which tags the threshold commit applies to. If both applicable_product_ids and
-                # applicable_product_tags are not provided, the commit applies to all products.
+                # Which tags the threshold commit applies to. If applicable_product_ids,
+                # applicable_product_tags or specifiers are not provided, the commit applies to
+                # all products.
                 applicable_product_tags: nil,
                 description: nil,
                 # Specify the name of the line item for the threshold charge. If left blank, it
                 # will default to the commit product name.
-                name: nil
+                name: nil,
+                # List of filters that determine what kind of customer usage draws down a commit
+                # or credit. A customer's usage needs to meet the condition of at least one of the
+                # specifiers to contribute to a commit's or credit's drawdown. This field cannot
+                # be used together with `applicable_product_ids` or `applicable_product_tags`.
+                specifiers: nil
               )
               end
 
@@ -4416,12 +5543,91 @@ module MetronomeSDK
                     applicable_product_ids: T::Array[String],
                     applicable_product_tags: T::Array[String],
                     description: String,
-                    name: String
+                    name: String,
+                    specifiers:
+                      T::Array[
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::Commit::Specifier
+                      ]
                   }
                 )
               end
               def to_hash
               end
+
+              class Specifier < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::Commit::Specifier,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(T.nilable(T::Hash[Symbol, String])) }
+                attr_reader :presentation_group_values
+
+                sig do
+                  params(
+                    presentation_group_values: T::Hash[Symbol, String]
+                  ).void
+                end
+                attr_writer :presentation_group_values
+
+                sig { returns(T.nilable(T::Hash[Symbol, String])) }
+                attr_reader :pricing_group_values
+
+                sig do
+                  params(pricing_group_values: T::Hash[Symbol, String]).void
+                end
+                attr_writer :pricing_group_values
+
+                # If provided, the specifier will only apply to the product with the specified ID.
+                sig { returns(T.nilable(String)) }
+                attr_reader :product_id
+
+                sig { params(product_id: String).void }
+                attr_writer :product_id
+
+                # If provided, the specifier will only apply to products with all the specified
+                # tags.
+                sig { returns(T.nilable(T::Array[String])) }
+                attr_reader :product_tags
+
+                sig { params(product_tags: T::Array[String]).void }
+                attr_writer :product_tags
+
+                sig do
+                  params(
+                    presentation_group_values: T::Hash[Symbol, String],
+                    pricing_group_values: T::Hash[Symbol, String],
+                    product_id: String,
+                    product_tags: T::Array[String]
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  presentation_group_values: nil,
+                  pricing_group_values: nil,
+                  # If provided, the specifier will only apply to the product with the specified ID.
+                  product_id: nil,
+                  # If provided, the specifier will only apply to products with all the specified
+                  # tags.
+                  product_tags: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      presentation_group_values: T::Hash[Symbol, String],
+                      pricing_group_values: T::Hash[Symbol, String],
+                      product_id: String,
+                      product_tags: T::Array[String]
+                    }
+                  )
+                end
+                def to_hash
+                end
+              end
             end
 
             class PaymentGateConfig < MetronomeSDK::Internal::Type::BaseModel
@@ -4444,7 +5650,25 @@ module MetronomeSDK
               end
               attr_accessor :payment_gate_type
 
-              # Only applicable if using Stripe as your payment gateway through Metronome.
+              # Only applicable if using PRECALCULATED as your tax type.
+              sig do
+                returns(
+                  T.nilable(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig
+                  )
+                )
+              end
+              attr_reader :precalculated_tax_config
+
+              sig do
+                params(
+                  precalculated_tax_config:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash
+                ).void
+              end
+              attr_writer :precalculated_tax_config
+
+              # Only applicable if using STRIPE as your payment gateway type.
               sig do
                 returns(
                   T.nilable(
@@ -4486,6 +5710,8 @@ module MetronomeSDK
                 params(
                   payment_gate_type:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PaymentGateType::OrSymbol,
+                  precalculated_tax_config:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash,
                   stripe_config:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::OrHash,
                   tax_type:
@@ -4498,7 +5724,9 @@ module MetronomeSDK
                 # facilitate payment using your own payment integration. Select NONE if you do not
                 # wish to payment gate the commit balance.
                 payment_gate_type:,
-                # Only applicable if using Stripe as your payment gateway through Metronome.
+                # Only applicable if using PRECALCULATED as your tax type.
+                precalculated_tax_config: nil,
+                # Only applicable if using STRIPE as your payment gateway type.
                 stripe_config: nil,
                 # Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
                 # not wish Metronome to calculate tax on your behalf. Leaving this field blank
@@ -4512,6 +5740,8 @@ module MetronomeSDK
                   {
                     payment_gate_type:
                       MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PaymentGateType::TaggedSymbol,
+                    precalculated_tax_config:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
                     stripe_config:
                       MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig,
                     tax_type:
@@ -4565,6 +5795,51 @@ module MetronomeSDK
                 end
               end
 
+              class PrecalculatedTaxConfig < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                # Amount of tax to be applied. This should be in the same currency and
+                # denomination as the commit's invoice schedule
+                sig { returns(Float) }
+                attr_accessor :tax_amount
+
+                # Name of the tax to be applied. This may be used in an invoice line item
+                # description.
+                sig { returns(T.nilable(String)) }
+                attr_reader :tax_name
+
+                sig { params(tax_name: String).void }
+                attr_writer :tax_name
+
+                # Only applicable if using PRECALCULATED as your tax type.
+                sig do
+                  params(tax_amount: Float, tax_name: String).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(
+                  # Amount of tax to be applied. This should be in the same currency and
+                  # denomination as the commit's invoice schedule
+                  tax_amount:,
+                  # Name of the tax to be applied. This may be used in an invoice line item
+                  # description.
+                  tax_name: nil
+                )
+                end
+
+                sig do
+                  override.returns({ tax_amount: Float, tax_name: String })
+                end
+                def to_hash
+                end
+              end
+
               class StripeConfig < MetronomeSDK::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
@@ -4582,16 +5857,28 @@ module MetronomeSDK
                 end
                 attr_accessor :payment_type
 
-                # Only applicable if using Stripe as your payment gateway through Metronome.
+                # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+                # your payment type.
+                sig { returns(T.nilable(T::Hash[Symbol, String])) }
+                attr_reader :invoice_metadata
+
+                sig { params(invoice_metadata: T::Hash[Symbol, String]).void }
+                attr_writer :invoice_metadata
+
+                # Only applicable if using STRIPE as your payment gateway type.
                 sig do
                   params(
                     payment_type:
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol,
+                    invoice_metadata: T::Hash[Symbol, String]
                   ).returns(T.attached_class)
                 end
                 def self.new(
                   # If left blank, will default to INVOICE
-                  payment_type:
+                  payment_type:,
+                  # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+                  # your payment type.
+                  invoice_metadata: nil
                 )
                 end
 
@@ -4599,7 +5886,8 @@ module MetronomeSDK
                   override.returns(
                     {
                       payment_type:
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol,
+                      invoice_metadata: T::Hash[Symbol, String]
                     }
                   )
                 end
@@ -4667,7 +5955,17 @@ module MetronomeSDK
                     :STRIPE,
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
                   )
-
+                ANROK =
+                  T.let(
+                    :ANROK,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+                  )
+                PRECALCULATED =
+                  T.let(
+                    :PRECALCULATED,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+                  )
+
                 sig do
                   override.returns(
                     T::Array[
@@ -4835,6 +6133,7 @@ module MetronomeSDK
 
             # Determines whether the first and last commit will be prorated. If not provided,
             # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+            # subscription_config:
             sig do
               returns(
                 T.nilable(
@@ -4855,7 +6154,7 @@ module MetronomeSDK
             # The frequency at which the recurring commits will be created. If not provided: -
             # The commits will be created on the usage invoice frequency. If provided: - The
             # period defined in the duration will correspond to this frequency. - Commits will
-            # be created aligned with the recurring commit's start_date rather than the usage
+            # be created aligned with the recurring commit's starting_at rather than the usage
             # invoice dates.
             sig do
               returns(
@@ -4883,6 +6182,30 @@ module MetronomeSDK
             sig { params(rollover_fraction: Float).void }
             attr_writer :rollover_fraction
 
+            # List of filters that determine what kind of customer usage draws down a commit
+            # or credit. A customer's usage needs to meet the condition of at least one of the
+            # specifiers to contribute to a commit's or credit's drawdown.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Specifier
+                  ]
+                )
+              )
+            end
+            attr_reader :specifiers
+
+            sig do
+              params(
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Specifier::OrHash
+                  ]
+              ).void
+            end
+            attr_writer :specifiers
+
             sig do
               params(
                 id: String,
@@ -4910,7 +6233,11 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Proration::OrSymbol,
                 recurrence_frequency:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::RecurrenceFrequency::OrSymbol,
-                rollover_fraction: Float
+                rollover_fraction: Float,
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Specifier::OrHash
+                  ]
               ).returns(T.attached_class)
             end
             def self.new(
@@ -4943,17 +6270,22 @@ module MetronomeSDK
               netsuite_sales_order_id: nil,
               # Determines whether the first and last commit will be prorated. If not provided,
               # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+              # subscription_config:
               proration: nil,
               # The frequency at which the recurring commits will be created. If not provided: -
               # The commits will be created on the usage invoice frequency. If provided: - The
               # period defined in the duration will correspond to this frequency. - Commits will
-              # be created aligned with the recurring commit's start_date rather than the usage
+              # be created aligned with the recurring commit's starting_at rather than the usage
               # invoice dates.
               recurrence_frequency: nil,
               # Will be passed down to the individual commits. This controls how much of an
               # individual unexpired commit will roll over upon contract transition. Must be
               # between 0 and 1.
-              rollover_fraction: nil
+              rollover_fraction: nil,
+              # List of filters that determine what kind of customer usage draws down a commit
+              # or credit. A customer's usage needs to meet the condition of at least one of the
+              # specifiers to contribute to a commit's or credit's drawdown.
+              specifiers: nil
             )
             end
 
@@ -4985,7 +6317,11 @@ module MetronomeSDK
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Proration::TaggedSymbol,
                   recurrence_frequency:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::RecurrenceFrequency::TaggedSymbol,
-                  rollover_fraction: Float
+                  rollover_fraction: Float,
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Specifier
+                    ]
                 }
               )
             end
@@ -5004,26 +6340,29 @@ module MetronomeSDK
               sig { returns(String) }
               attr_accessor :credit_type_id
 
-              sig { returns(Float) }
-              attr_accessor :quantity
-
               sig { returns(Float) }
               attr_accessor :unit_price
 
+              sig { returns(T.nilable(Float)) }
+              attr_reader :quantity
+
+              sig { params(quantity: Float).void }
+              attr_writer :quantity
+
               # The amount of commit to grant.
               sig do
                 params(
                   credit_type_id: String,
-                  quantity: Float,
-                  unit_price: Float
+                  unit_price: Float,
+                  quantity: Float
                 ).returns(T.attached_class)
               end
-              def self.new(credit_type_id:, quantity:, unit_price:)
+              def self.new(credit_type_id:, unit_price:, quantity: nil)
               end
 
               sig do
                 override.returns(
-                  { credit_type_id: String, quantity: Float, unit_price: Float }
+                  { credit_type_id: String, unit_price: Float, quantity: Float }
                 )
               end
               def to_hash
@@ -5232,6 +6571,7 @@ module MetronomeSDK
 
             # Determines whether the first and last commit will be prorated. If not provided,
             # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+            # subscription_config:
             module Proration
               extend MetronomeSDK::Internal::Type::Enum
 
@@ -5279,7 +6619,7 @@ module MetronomeSDK
             # The frequency at which the recurring commits will be created. If not provided: -
             # The commits will be created on the usage invoice frequency. If provided: - The
             # period defined in the duration will correspond to this frequency. - Commits will
-            # be created aligned with the recurring commit's start_date rather than the usage
+            # be created aligned with the recurring commit's starting_at rather than the usage
             # invoice dates.
             module RecurrenceFrequency
               extend MetronomeSDK::Internal::Type::Enum
@@ -5324,6 +6664,77 @@ module MetronomeSDK
               def self.values
               end
             end
+
+            class Specifier < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCommit::Specifier,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :presentation_group_values
+
+              sig do
+                params(presentation_group_values: T::Hash[Symbol, String]).void
+              end
+              attr_writer :presentation_group_values
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :pricing_group_values
+
+              sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+              attr_writer :pricing_group_values
+
+              # If provided, the specifier will only apply to the product with the specified ID.
+              sig { returns(T.nilable(String)) }
+              attr_reader :product_id
+
+              sig { params(product_id: String).void }
+              attr_writer :product_id
+
+              # If provided, the specifier will only apply to products with all the specified
+              # tags.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :product_tags
+
+              sig { params(product_tags: T::Array[String]).void }
+              attr_writer :product_tags
+
+              sig do
+                params(
+                  presentation_group_values: T::Hash[Symbol, String],
+                  pricing_group_values: T::Hash[Symbol, String],
+                  product_id: String,
+                  product_tags: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                presentation_group_values: nil,
+                pricing_group_values: nil,
+                # If provided, the specifier will only apply to the product with the specified ID.
+                product_id: nil,
+                # If provided, the specifier will only apply to products with all the specified
+                # tags.
+                product_tags: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    presentation_group_values: T::Hash[Symbol, String],
+                    pricing_group_values: T::Hash[Symbol, String],
+                    product_id: String,
+                    product_tags: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
           end
 
           class RecurringCredit < MetronomeSDK::Internal::Type::BaseModel
@@ -5462,6 +6873,7 @@ module MetronomeSDK
 
             # Determines whether the first and last commit will be prorated. If not provided,
             # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+            # subscription_config:
             sig do
               returns(
                 T.nilable(
@@ -5482,7 +6894,7 @@ module MetronomeSDK
             # The frequency at which the recurring commits will be created. If not provided: -
             # The commits will be created on the usage invoice frequency. If provided: - The
             # period defined in the duration will correspond to this frequency. - Commits will
-            # be created aligned with the recurring commit's start_date rather than the usage
+            # be created aligned with the recurring commit's starting_at rather than the usage
             # invoice dates.
             sig do
               returns(
@@ -5510,6 +6922,30 @@ module MetronomeSDK
             sig { params(rollover_fraction: Float).void }
             attr_writer :rollover_fraction
 
+            # List of filters that determine what kind of customer usage draws down a commit
+            # or credit. A customer's usage needs to meet the condition of at least one of the
+            # specifiers to contribute to a commit's or credit's drawdown.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Specifier
+                  ]
+                )
+              )
+            end
+            attr_reader :specifiers
+
+            sig do
+              params(
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Specifier::OrHash
+                  ]
+              ).void
+            end
+            attr_writer :specifiers
+
             sig do
               params(
                 id: String,
@@ -5535,7 +6971,11 @@ module MetronomeSDK
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Proration::OrSymbol,
                 recurrence_frequency:
                   MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::RecurrenceFrequency::OrSymbol,
-                rollover_fraction: Float
+                rollover_fraction: Float,
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Specifier::OrHash
+                  ]
               ).returns(T.attached_class)
             end
             def self.new(
@@ -5566,17 +7006,22 @@ module MetronomeSDK
               netsuite_sales_order_id: nil,
               # Determines whether the first and last commit will be prorated. If not provided,
               # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+              # subscription_config:
               proration: nil,
               # The frequency at which the recurring commits will be created. If not provided: -
               # The commits will be created on the usage invoice frequency. If provided: - The
               # period defined in the duration will correspond to this frequency. - Commits will
-              # be created aligned with the recurring commit's start_date rather than the usage
+              # be created aligned with the recurring commit's starting_at rather than the usage
               # invoice dates.
               recurrence_frequency: nil,
               # Will be passed down to the individual commits. This controls how much of an
               # individual unexpired commit will roll over upon contract transition. Must be
               # between 0 and 1.
-              rollover_fraction: nil
+              rollover_fraction: nil,
+              # List of filters that determine what kind of customer usage draws down a commit
+              # or credit. A customer's usage needs to meet the condition of at least one of the
+              # specifiers to contribute to a commit's or credit's drawdown.
+              specifiers: nil
             )
             end
 
@@ -5606,7 +7051,11 @@ module MetronomeSDK
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Proration::TaggedSymbol,
                   recurrence_frequency:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::RecurrenceFrequency::TaggedSymbol,
-                  rollover_fraction: Float
+                  rollover_fraction: Float,
+                  specifiers:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Specifier
+                    ]
                 }
               )
             end
@@ -5625,26 +7074,29 @@ module MetronomeSDK
               sig { returns(String) }
               attr_accessor :credit_type_id
 
-              sig { returns(Float) }
-              attr_accessor :quantity
-
               sig { returns(Float) }
               attr_accessor :unit_price
 
+              sig { returns(T.nilable(Float)) }
+              attr_reader :quantity
+
+              sig { params(quantity: Float).void }
+              attr_writer :quantity
+
               # The amount of commit to grant.
               sig do
                 params(
                   credit_type_id: String,
-                  quantity: Float,
-                  unit_price: Float
+                  unit_price: Float,
+                  quantity: Float
                 ).returns(T.attached_class)
               end
-              def self.new(credit_type_id:, quantity:, unit_price:)
+              def self.new(credit_type_id:, unit_price:, quantity: nil)
               end
 
               sig do
                 override.returns(
-                  { credit_type_id: String, quantity: Float, unit_price: Float }
+                  { credit_type_id: String, unit_price: Float, quantity: Float }
                 )
               end
               def to_hash
@@ -5815,6 +7267,7 @@ module MetronomeSDK
 
             # Determines whether the first and last commit will be prorated. If not provided,
             # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+            # subscription_config:
             module Proration
               extend MetronomeSDK::Internal::Type::Enum
 
@@ -5862,7 +7315,7 @@ module MetronomeSDK
             # The frequency at which the recurring commits will be created. If not provided: -
             # The commits will be created on the usage invoice frequency. If provided: - The
             # period defined in the duration will correspond to this frequency. - Commits will
-            # be created aligned with the recurring commit's start_date rather than the usage
+            # be created aligned with the recurring commit's starting_at rather than the usage
             # invoice dates.
             module RecurrenceFrequency
               extend MetronomeSDK::Internal::Type::Enum
@@ -5907,6 +7360,77 @@ module MetronomeSDK
               def self.values
               end
             end
+
+            class Specifier < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::RecurringCredit::Specifier,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :presentation_group_values
+
+              sig do
+                params(presentation_group_values: T::Hash[Symbol, String]).void
+              end
+              attr_writer :presentation_group_values
+
+              sig { returns(T.nilable(T::Hash[Symbol, String])) }
+              attr_reader :pricing_group_values
+
+              sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+              attr_writer :pricing_group_values
+
+              # If provided, the specifier will only apply to the product with the specified ID.
+              sig { returns(T.nilable(String)) }
+              attr_reader :product_id
+
+              sig { params(product_id: String).void }
+              attr_writer :product_id
+
+              # If provided, the specifier will only apply to products with all the specified
+              # tags.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :product_tags
+
+              sig { params(product_tags: T::Array[String]).void }
+              attr_writer :product_tags
+
+              sig do
+                params(
+                  presentation_group_values: T::Hash[Symbol, String],
+                  pricing_group_values: T::Hash[Symbol, String],
+                  product_id: String,
+                  product_tags: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                presentation_group_values: nil,
+                pricing_group_values: nil,
+                # If provided, the specifier will only apply to the product with the specified ID.
+                product_id: nil,
+                # If provided, the specifier will only apply to products with all the specified
+                # tags.
+                product_tags: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    presentation_group_values: T::Hash[Symbol, String],
+                    pricing_group_values: T::Hash[Symbol, String],
+                    product_id: String,
+                    product_tags: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
           end
 
           class ResellerRoyalty < MetronomeSDK::Internal::Type::BaseModel
@@ -6386,7 +7910,25 @@ module MetronomeSDK
               end
               attr_accessor :payment_gate_type
 
-              # Only applicable if using Stripe as your payment gateway through Metronome.
+              # Only applicable if using PRECALCULATED as your tax type.
+              sig do
+                returns(
+                  T.nilable(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig
+                  )
+                )
+              end
+              attr_reader :precalculated_tax_config
+
+              sig do
+                params(
+                  precalculated_tax_config:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash
+                ).void
+              end
+              attr_writer :precalculated_tax_config
+
+              # Only applicable if using STRIPE as your payment gateway type.
               sig do
                 returns(
                   T.nilable(
@@ -6428,6 +7970,8 @@ module MetronomeSDK
                 params(
                   payment_gate_type:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PaymentGateType::OrSymbol,
+                  precalculated_tax_config:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash,
                   stripe_config:
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::OrHash,
                   tax_type:
@@ -6440,7 +7984,9 @@ module MetronomeSDK
                 # facilitate payment using your own payment integration. Select NONE if you do not
                 # wish to payment gate the commit balance.
                 payment_gate_type:,
-                # Only applicable if using Stripe as your payment gateway through Metronome.
+                # Only applicable if using PRECALCULATED as your tax type.
+                precalculated_tax_config: nil,
+                # Only applicable if using STRIPE as your payment gateway type.
                 stripe_config: nil,
                 # Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
                 # not wish Metronome to calculate tax on your behalf. Leaving this field blank
@@ -6454,6 +8000,8 @@ module MetronomeSDK
                   {
                     payment_gate_type:
                       MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PaymentGateType::TaggedSymbol,
+                    precalculated_tax_config:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
                     stripe_config:
                       MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig,
                     tax_type:
@@ -6507,6 +8055,51 @@ module MetronomeSDK
                 end
               end
 
+              class PrecalculatedTaxConfig < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                # Amount of tax to be applied. This should be in the same currency and
+                # denomination as the commit's invoice schedule
+                sig { returns(Float) }
+                attr_accessor :tax_amount
+
+                # Name of the tax to be applied. This may be used in an invoice line item
+                # description.
+                sig { returns(T.nilable(String)) }
+                attr_reader :tax_name
+
+                sig { params(tax_name: String).void }
+                attr_writer :tax_name
+
+                # Only applicable if using PRECALCULATED as your tax type.
+                sig do
+                  params(tax_amount: Float, tax_name: String).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(
+                  # Amount of tax to be applied. This should be in the same currency and
+                  # denomination as the commit's invoice schedule
+                  tax_amount:,
+                  # Name of the tax to be applied. This may be used in an invoice line item
+                  # description.
+                  tax_name: nil
+                )
+                end
+
+                sig do
+                  override.returns({ tax_amount: Float, tax_name: String })
+                end
+                def to_hash
+                end
+              end
+
               class StripeConfig < MetronomeSDK::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
@@ -6524,16 +8117,28 @@ module MetronomeSDK
                 end
                 attr_accessor :payment_type
 
-                # Only applicable if using Stripe as your payment gateway through Metronome.
+                # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+                # your payment type.
+                sig { returns(T.nilable(T::Hash[Symbol, String])) }
+                attr_reader :invoice_metadata
+
+                sig { params(invoice_metadata: T::Hash[Symbol, String]).void }
+                attr_writer :invoice_metadata
+
+                # Only applicable if using STRIPE as your payment gateway type.
                 sig do
                   params(
                     payment_type:
-                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol,
+                    invoice_metadata: T::Hash[Symbol, String]
                   ).returns(T.attached_class)
                 end
                 def self.new(
                   # If left blank, will default to INVOICE
-                  payment_type:
+                  payment_type:,
+                  # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+                  # your payment type.
+                  invoice_metadata: nil
                 )
                 end
 
@@ -6541,7 +8146,8 @@ module MetronomeSDK
                   override.returns(
                     {
                       payment_type:
-                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol
+                        MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol,
+                      invoice_metadata: T::Hash[Symbol, String]
                     }
                   )
                 end
@@ -6609,6 +8215,16 @@ module MetronomeSDK
                     :STRIPE,
                     MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
                   )
+                ANROK =
+                  T.let(
+                    :ANROK,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+                  )
+                PRECALCULATED =
+                  T.let(
+                    :PRECALCULATED,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+                  )
 
                 sig do
                   override.returns(
@@ -6622,6 +8238,443 @@ module MetronomeSDK
               end
             end
           end
+
+          class Subscription < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig do
+              returns(
+                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::TaggedSymbol
+              )
+            end
+            attr_accessor :collection_schedule
+
+            sig do
+              returns(
+                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration
+              )
+            end
+            attr_reader :proration
+
+            sig do
+              params(
+                proration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::OrHash
+              ).void
+            end
+            attr_writer :proration
+
+            # List of quantity schedule items for the subscription. Only includes the current
+            # quantity and future quantity changes.
+            sig do
+              returns(
+                T::Array[
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::QuantitySchedule
+                ]
+              )
+            end
+            attr_accessor :quantity_schedule
+
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            sig do
+              returns(
+                MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate
+              )
+            end
+            attr_reader :subscription_rate
+
+            sig do
+              params(
+                subscription_rate:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::OrHash
+              ).void
+            end
+            attr_writer :subscription_rate
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :id
+
+            sig { params(id: String).void }
+            attr_writer :id
+
+            sig { returns(T.nilable(T::Hash[Symbol, String])) }
+            attr_reader :custom_fields
+
+            sig { params(custom_fields: T::Hash[Symbol, String]).void }
+            attr_writer :custom_fields
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :description
+
+            sig { params(description: String).void }
+            attr_writer :description
+
+            sig { returns(T.nilable(Time)) }
+            attr_reader :ending_before
+
+            sig { params(ending_before: Time).void }
+            attr_writer :ending_before
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :fiat_credit_type_id
+
+            sig { params(fiat_credit_type_id: String).void }
+            attr_writer :fiat_credit_type_id
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :name
+
+            sig { params(name: String).void }
+            attr_writer :name
+
+            sig do
+              params(
+                collection_schedule:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::OrSymbol,
+                proration:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::OrHash,
+                quantity_schedule:
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::QuantitySchedule::OrHash
+                  ],
+                starting_at: Time,
+                subscription_rate:
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::OrHash,
+                id: String,
+                custom_fields: T::Hash[Symbol, String],
+                description: String,
+                ending_before: Time,
+                fiat_credit_type_id: String,
+                name: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              collection_schedule:,
+              proration:,
+              # List of quantity schedule items for the subscription. Only includes the current
+              # quantity and future quantity changes.
+              quantity_schedule:,
+              starting_at:,
+              subscription_rate:,
+              id: nil,
+              custom_fields: nil,
+              description: nil,
+              ending_before: nil,
+              fiat_credit_type_id: nil,
+              name: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  collection_schedule:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::TaggedSymbol,
+                  proration:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration,
+                  quantity_schedule:
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::QuantitySchedule
+                    ],
+                  starting_at: Time,
+                  subscription_rate:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate,
+                  id: String,
+                  custom_fields: T::Hash[Symbol, String],
+                  description: String,
+                  ending_before: Time,
+                  fiat_credit_type_id: String,
+                  name: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module CollectionSchedule
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              ADVANCE =
+                T.let(
+                  :ADVANCE,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::TaggedSymbol
+                )
+              ARREARS =
+                T.let(
+                  :ARREARS,
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::CollectionSchedule::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            class Proration < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+                )
+              end
+              attr_accessor :invoice_behavior
+
+              sig { returns(T::Boolean) }
+              attr_accessor :is_prorated
+
+              sig do
+                params(
+                  invoice_behavior:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::OrSymbol,
+                  is_prorated: T::Boolean
+                ).returns(T.attached_class)
+              end
+              def self.new(invoice_behavior:, is_prorated:)
+              end
+
+              sig do
+                override.returns(
+                  {
+                    invoice_behavior:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::TaggedSymbol,
+                    is_prorated: T::Boolean
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module InvoiceBehavior
+                extend MetronomeSDK::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                BILL_IMMEDIATELY =
+                  T.let(
+                    :BILL_IMMEDIATELY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+                  )
+                BILL_ON_NEXT_COLLECTION_DATE =
+                  T.let(
+                    :BILL_ON_NEXT_COLLECTION_DATE,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
+            class QuantitySchedule < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::QuantitySchedule,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(Float) }
+              attr_accessor :quantity
+
+              sig { returns(Time) }
+              attr_accessor :starting_at
+
+              sig { returns(T.nilable(Time)) }
+              attr_reader :ending_before
+
+              sig { params(ending_before: Time).void }
+              attr_writer :ending_before
+
+              sig do
+                params(
+                  quantity: Float,
+                  starting_at: Time,
+                  ending_before: Time
+                ).returns(T.attached_class)
+              end
+              def self.new(quantity:, starting_at:, ending_before: nil)
+              end
+
+              sig do
+                override.returns(
+                  { quantity: Float, starting_at: Time, ending_before: Time }
+                )
+              end
+              def to_hash
+              end
+            end
+
+            class SubscriptionRate < MetronomeSDK::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate,
+                    MetronomeSDK::Internal::AnyHash
+                  )
+                end
+
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                )
+              end
+              attr_accessor :billing_frequency
+
+              sig do
+                returns(
+                  MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::Product
+                )
+              end
+              attr_reader :product
+
+              sig do
+                params(
+                  product:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::Product::OrHash
+                ).void
+              end
+              attr_writer :product
+
+              sig do
+                params(
+                  billing_frequency:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::OrSymbol,
+                  product:
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::Product::OrHash
+                ).returns(T.attached_class)
+              end
+              def self.new(billing_frequency:, product:)
+              end
+
+              sig do
+                override.returns(
+                  {
+                    billing_frequency:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol,
+                    product:
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::Product
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module BillingFrequency
+                extend MetronomeSDK::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                MONTHLY =
+                  T.let(
+                    :MONTHLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                  )
+                QUARTERLY =
+                  T.let(
+                    :QUARTERLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                  )
+                ANNUAL =
+                  T.let(
+                    :ANNUAL,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                  )
+                WEEKLY =
+                  T.let(
+                    :WEEKLY,
+                    MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              class Product < MetronomeSDK::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      MetronomeSDK::Models::V2::ContractRetrieveResponse::Data::Subscription::SubscriptionRate::Product,
+                      MetronomeSDK::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(String) }
+                attr_accessor :id
+
+                sig { returns(String) }
+                attr_accessor :name
+
+                sig do
+                  params(id: String, name: String).returns(T.attached_class)
+                end
+                def self.new(id:, name:)
+                end
+
+                sig { override.returns({ id: String, name: String }) }
+                def to_hash
+                end
+              end
+            end
+          end
         end
       end
     end