metronome-sdk 3.7.0 → 3.9.0

data/lib/metronome_sdk/models/v1/contract_create_response.rb

@@ -103,7 +103,6 @@ module MetronomeSDK
             optional :custom_fields, MetronomeSDK::Internal::Type::HashOf[String]
 
             # @!attribute customer_billing_provider_configuration
-            #   The billing provider configuration associated with the contract.
             #
             #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration, nil]
             optional :customer_billing_provider_configuration,
@@ -238,7 +237,7 @@ module MetronomeSDK
             #
             #   @param custom_fields [Hash{Symbol=>String}] Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
             #
-            #   @param customer_billing_provider_configuration [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration] The billing provider configuration associated with the contract.
+            #   @param customer_billing_provider_configuration [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration]
             #
             #   @param ending_before [Time]
             #
@@ -368,29 +367,80 @@ module MetronomeSDK
             # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract#customer_billing_provider_configuration
             class CustomerBillingProviderConfiguration < MetronomeSDK::Internal::Type::BaseModel
               # @!attribute id
+              #   ID of this configuration; can be provided as the
+              #   billing_provider_configuration_id when creating a contract.
               #
-              #   @return [String, nil]
-              optional :id, String
+              #   @return [String]
+              required :id, String
+
+              # @!attribute archived_at
+              #
+              #   @return [Time, nil]
+              required :archived_at, Time, nil?: true
 
               # @!attribute billing_provider
+              #   The billing provider set for this configuration.
               #
-              #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::BillingProvider, nil]
-              optional :billing_provider,
+              #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::BillingProvider]
+              required :billing_provider,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::BillingProvider }
 
+              # @!attribute configuration
+              #   Configuration for the billing provider. The structure of this object is specific
+              #   to the billing provider.
+              #
+              #   @return [Hash{Symbol=>Object}]
+              required :configuration, MetronomeSDK::Internal::Type::HashOf[MetronomeSDK::Internal::Type::Unknown]
+
+              # @!attribute customer_id
+              #
+              #   @return [String]
+              required :customer_id, String
+
               # @!attribute delivery_method
+              #   The method to use for delivering invoices to this customer.
               #
-              #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::DeliveryMethod, nil]
-              optional :delivery_method,
+              #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::DeliveryMethod]
+              required :delivery_method,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::DeliveryMethod }
 
-              # @!method initialize(id: nil, billing_provider: nil, delivery_method: nil)
-              #   The billing provider configuration associated with the contract.
+              # @!attribute delivery_method_configuration
+              #   Configuration for the delivery method. The structure of this object is specific
+              #   to the delivery method.
               #
-              #   @param id [String]
-              #   @param billing_provider [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::BillingProvider]
-              #   @param delivery_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::DeliveryMethod]
+              #   @return [Hash{Symbol=>Object}]
+              required :delivery_method_configuration,
+                       MetronomeSDK::Internal::Type::HashOf[MetronomeSDK::Internal::Type::Unknown]
+
+              # @!attribute delivery_method_id
+              #   ID of the delivery method to use for this customer.
+              #
+              #   @return [String]
+              required :delivery_method_id, String
+
+              # @!method initialize(id:, archived_at:, billing_provider:, configuration:, customer_id:, delivery_method:, delivery_method_configuration:, delivery_method_id:)
+              #   Some parameter documentations has been truncated, see
+              #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration}
+              #   for more details.
+              #
+              #   @param id [String] ID of this configuration; can be provided as the billing*provider_configuration*
+              #
+              #   @param archived_at [Time, nil]
+              #
+              #   @param billing_provider [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::BillingProvider] The billing provider set for this configuration.
+              #
+              #   @param configuration [Hash{Symbol=>Object}] Configuration for the billing provider. The structure of this object is specific
+              #
+              #   @param customer_id [String]
+              #
+              #   @param delivery_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration::DeliveryMethod] The method to use for delivering invoices to this customer.
+              #
+              #   @param delivery_method_configuration [Hash{Symbol=>Object}] Configuration for the delivery method. The structure of this object is specific
+              #
+              #   @param delivery_method_id [String] ID of the delivery method to use for this customer.
 
+              # The billing provider set for this configuration.
+              #
               # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration#billing_provider
               module BillingProvider
                 extend MetronomeSDK::Internal::Type::Enum
@@ -409,6 +459,8 @@ module MetronomeSDK
                 #   @return [Array<Symbol>]
               end
 
+              # The method to use for delivering invoices to this customer.
+              #
               # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::CustomerBillingProviderConfiguration#delivery_method
               module DeliveryMethod
                 extend MetronomeSDK::Internal::Type::Enum
@@ -578,6 +630,14 @@ module MetronomeSDK
               optional :proration,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::Proration }
 
+              # @!attribute proration_rounding
+              #   Rounding configuration for prorated recurring commit amounts.
+              #
+              #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding, nil]
+              optional :proration_rounding,
+                       -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding },
+                       nil?: true
+
               # @!attribute recurrence_frequency
               #   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
@@ -611,7 +671,7 @@ module MetronomeSDK
               #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
               optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, invoice_amount: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
+              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, invoice_amount: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, proration_rounding: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
               #   Some parameter documentations has been truncated, see
               #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit}
               #   for more details.
@@ -650,7 +710,9 @@ module MetronomeSDK
               #
               #   @param proration [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::Proration] Determines whether the first and last commit will be prorated. If not provided,
               #
-              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided:
+              #   @param proration_rounding [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding, nil] Rounding configuration for prorated recurring commit amounts.
+              #
+              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided: -
               #
               #   @param rollover_fraction [Float] Will be passed down to the individual commits. This controls how much of an indi
               #
@@ -795,6 +857,105 @@ module MetronomeSDK
                 #   @return [Array<Symbol>]
               end
 
+              # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit#proration_rounding
+              class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute access
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access, nil]
+                optional :access,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access }
+
+                # @!attribute invoice
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice, nil]
+                optional :invoice,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice }
+
+                # @!method initialize(access: nil, invoice: nil)
+                #   Rounding configuration for prorated recurring commit amounts.
+                #
+                #   @param access [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access]
+                #   @param invoice [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice]
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding#access
+                class Access < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Access#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding#invoice
+                class Invoice < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCommit::ProrationRounding::Invoice#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+              end
+
               # 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
@@ -809,6 +970,7 @@ module MetronomeSDK
                 QUARTERLY = :QUARTERLY
                 ANNUAL = :ANNUAL
                 WEEKLY = :WEEKLY
+                DAILY = :DAILY
 
                 # @!method self.values
                 #   @return [Array<Symbol>]
@@ -916,6 +1078,14 @@ module MetronomeSDK
               optional :proration,
                        enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::Proration }
 
+              # @!attribute proration_rounding
+              #   Rounding configuration for prorated recurring credit amounts.
+              #
+              #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding, nil]
+              optional :proration_rounding,
+                       -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding },
+                       nil?: true
+
               # @!attribute recurrence_frequency
               #   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
@@ -949,7 +1119,7 @@ module MetronomeSDK
               #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
               optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
+              # @!method initialize(id:, access_amount:, commit_duration:, priority:, product:, rate_type:, starting_at:, applicable_product_ids: nil, applicable_product_tags: nil, contract: nil, description: nil, ending_before: nil, hierarchy_configuration: nil, name: nil, netsuite_sales_order_id: nil, proration: nil, proration_rounding: nil, recurrence_frequency: nil, rollover_fraction: nil, specifiers: nil, subscription_config: nil)
               #   Some parameter documentations has been truncated, see
               #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit}
               #   for more details.
@@ -986,7 +1156,9 @@ module MetronomeSDK
               #
               #   @param proration [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::Proration] Determines whether the first and last commit will be prorated. If not provided,
               #
-              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided:
+              #   @param proration_rounding [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding, nil] Rounding configuration for prorated recurring credit amounts.
+              #
+              #   @param recurrence_frequency [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::RecurrenceFrequency] The frequency at which the recurring commits will be created. If not provided: -
               #
               #   @param rollover_fraction [Float] Will be passed down to the individual commits. This controls how much of an indi
               #
@@ -1106,6 +1278,59 @@ module MetronomeSDK
                 #   @return [Array<Symbol>]
               end
 
+              # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit#proration_rounding
+              class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+                # @!attribute access
+                #
+                #   @return [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access, nil]
+                optional :access,
+                         -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access }
+
+                # @!method initialize(access: nil)
+                #   Rounding configuration for prorated recurring credit amounts.
+                #
+                #   @param access [MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access]
+
+                # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding#access
+                class Access < MetronomeSDK::Internal::Type::BaseModel
+                  # @!attribute decimal_places
+                  #   Number of decimal places to round to. Applied directly to the stored monetary
+                  #   representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                  #   nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                  #   dollar).
+                  #
+                  #   @return [Float]
+                  required :decimal_places, Float
+
+                  # @!attribute rounding_method
+                  #
+                  #   @return [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod]
+                  required :rounding_method,
+                           enum: -> { MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod }
+
+                  # @!method initialize(decimal_places:, rounding_method:)
+                  #   Some parameter documentations has been truncated, see
+                  #   {MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access}
+                  #   for more details.
+                  #
+                  #   @param decimal_places [Float] Number of decimal places to round to. Applied directly to the stored monetary re
+                  #
+                  #   @param rounding_method [Symbol, MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access::RoundingMethod]
+
+                  # @see MetronomeSDK::Models::V1::ContractCreateResponse::Data::Contract::RecurringCredit::ProrationRounding::Access#rounding_method
+                  module RoundingMethod
+                    extend MetronomeSDK::Internal::Type::Enum
+
+                    HALF_UP = :HALF_UP
+                    FLOOR = :FLOOR
+                    CEILING = :CEILING
+
+                    # @!method self.values
+                    #   @return [Array<Symbol>]
+                  end
+                end
+              end
+
               # 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
@@ -1120,6 +1345,7 @@ module MetronomeSDK
                 QUARTERLY = :QUARTERLY
                 ANNUAL = :ANNUAL
                 WEEKLY = :WEEKLY
+                DAILY = :DAILY
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

data/lib/metronome_sdk/models/v1/contract_get_subscription_seats_history_params.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#get_subscription_seats_history
+      class ContractGetSubscriptionSeatsHistoryParams < MetronomeSDK::Internal::Type::BaseModel
+        extend MetronomeSDK::Internal::Type::RequestParameters::Converter
+        include MetronomeSDK::Internal::Type::RequestParameters
+
+        # @!attribute contract_id
+        #
+        #   @return [String]
+        required :contract_id, String
+
+        # @!attribute customer_id
+        #
+        #   @return [String]
+        required :customer_id, String
+
+        # @!attribute subscription_id
+        #
+        #   @return [String]
+        required :subscription_id, String
+
+        # @!attribute covering_date
+        #   Get the seats history segment for the covering date. Cannot be used with
+        #   `starting_at` or `ending_before`.
+        #
+        #   @return [Time, nil]
+        optional :covering_date, Time, nil?: true
+
+        # @!attribute cursor
+        #   Cursor for pagination. Use the value from the `next_page` field of the previous
+        #   response to retrieve the next page of results.
+        #
+        #   @return [String, nil]
+        optional :cursor, String, nil?: true
+
+        # @!attribute ending_before
+        #   Include seats history segments that are active at or before this timestamp. Use
+        #   with `starting_at` to get a specific time range. If not set, there's no upper
+        #   bound.
+        #
+        #   @return [Time, nil]
+        optional :ending_before, Time, nil?: true
+
+        # @!attribute limit
+        #   Maximum number of seat schedule entries to return. Defaults to 10. Required
+        #   range: 1 <= x <= 10.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer, nil?: true
+
+        # @!attribute starting_at
+        #   Include seats history segments that are active at or after this timestamp. Use
+        #   with `ending_before` to get a specific time range. If not set, there's no lower
+        #   bound.
+        #
+        #   @return [Time, nil]
+        optional :starting_at, Time, nil?: true
+
+        # @!method initialize(contract_id:, customer_id:, subscription_id:, covering_date: nil, cursor: nil, ending_before: nil, limit: nil, starting_at: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryParams} for more
+        #   details.
+        #
+        #   @param contract_id [String]
+        #
+        #   @param customer_id [String]
+        #
+        #   @param subscription_id [String]
+        #
+        #   @param covering_date [Time, nil] Get the seats history segment for the covering date. Cannot be used with `starti
+        #
+        #   @param cursor [String, nil] Cursor for pagination. Use the value from the `next_page` field of the previous
+        #
+        #   @param ending_before [Time, nil] Include seats history segments that are active at or before this timestamp. Use
+        #
+        #   @param limit [Integer, nil] Maximum number of seat schedule entries to return. Defaults to 10. Required rang
+        #
+        #   @param starting_at [Time, nil] Include seats history segments that are active at or after this timestamp. Use w
+        #
+        #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/metronome_sdk/models/v1/contract_get_subscription_seats_history_response.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#get_subscription_seats_history
+      class ContractGetSubscriptionSeatsHistoryResponse < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data>]
+        required :data,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data] }
+
+        # @!attribute next_page
+        #   Cursor for the next page of results
+        #
+        #   @return [String, nil]
+        required :next_page, String, nil?: true
+
+        # @!method initialize(data:, next_page:)
+        #   @param data [Array<MetronomeSDK::Models::V1::ContractGetSubscriptionSeatsHistoryResponse::Data>]
+        #
+        #   @param next_page [String, nil] Cursor for the next page of results
+
+        class Data < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute assigned_seat_ids
+          #   Array of seat IDs that are assigned in this period
+          #
+          #   @return [Array<String>]
+          required :assigned_seat_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
+
+          # @!attribute ending_before
+          #   The end time of this seat schedule period (null if ongoing)
+          #
+          #   @return [Time, nil]
+          required :ending_before, Time, nil?: true
+
+          # @!attribute starting_at
+          #   The start time of this seat schedule period
+          #
+          #   @return [Time]
+          required :starting_at, Time
+
+          # @!attribute total_quantity
+          #   Total number of assigned and unassigned seats in this period
+          #
+          #   @return [Integer]
+          required :total_quantity, Integer
+
+          # @!method initialize(assigned_seat_ids:, ending_before:, starting_at:, total_quantity:)
+          #   @param assigned_seat_ids [Array<String>] Array of seat IDs that are assigned in this period
+          #
+          #   @param ending_before [Time, nil] The end time of this seat schedule period (null if ongoing)
+          #
+          #   @param starting_at [Time] The start time of this seat schedule period
+          #
+          #   @param total_quantity [Integer] Total number of assigned and unassigned seats in this period
+        end
+      end
+    end
+  end
+end

data/lib/metronome_sdk/models/v1/contract_list_seat_balances_params.rb

@@ -71,6 +71,13 @@ module MetronomeSDK
         #   @return [Array<String>, nil]
         optional :seat_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
 
+        # @!attribute skip_missing_seat_ids
+        #   When true, any seat_ids not found in contract subscriptions will be silently
+        #   omitted from the response instead of returning a 400 error.
+        #
+        #   @return [Boolean, nil]
+        optional :skip_missing_seat_ids, MetronomeSDK::Internal::Type::Boolean
+
         # @!attribute starting_at
         #   Include only commits or credits with access effective on or after this date
         #   (cannot be used with covering_date).
@@ -86,7 +93,7 @@ module MetronomeSDK
         #   @return [Array<String>, nil]
         optional :subscription_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(contract_id:, customer_id:, covering_date: nil, cursor: nil, effective_before: nil, include_credits_and_commits: nil, include_ledgers: nil, limit: nil, seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
+        # @!method initialize(contract_id:, customer_id:, covering_date: nil, cursor: nil, effective_before: nil, include_credits_and_commits: nil, include_ledgers: nil, limit: nil, seat_ids: nil, skip_missing_seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::V1::ContractListSeatBalancesParams} for more details.
         #
@@ -108,6 +115,8 @@ module MetronomeSDK
         #
         #   @param seat_ids [Array<String>] Optional filter to only include specific seats.
         #
+        #   @param skip_missing_seat_ids [Boolean] When true, any seat_ids not found in contract subscriptions will be silently omi
+        #
         #   @param starting_at [Time] Include only commits or credits with access effective on or after this date (can
         #
         #   @param subscription_ids [Array<String>] Optional filter to only include seats from specific subscriptions. If subscripti