dodopayments 1.51.1 → 1.52.5

data/lib/dodopayments/models/price.rb

@@ -12,6 +12,9 @@ module Dodopayments
       # Recurring price details.
       variant -> { Dodopayments::Price::RecurringPrice }
 
+      # Usage Based price details.
+      variant -> { Dodopayments::Price::UsageBasedPrice }
+
       class OneTimePrice < Dodopayments::Internal::Type::BaseModel
         # @!attribute currency
         #   The currency in which the payment is made.
@@ -22,8 +25,8 @@ module Dodopayments
         # @!attribute discount
         #   Discount applied to the price, represented as a percentage (0 to 100).
         #
-        #   @return [Float]
-        required :discount, Float
+        #   @return [Integer]
+        required :discount, Integer
 
         # @!attribute price
         #   The payment amount, in the smallest denomination of the currency (e.g., cents
@@ -76,7 +79,7 @@ module Dodopayments
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
         #
-        #   @param discount [Float] Discount applied to the price, represented as a percentage (0 to 100).
+        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
         #
         #   @param price [Integer] The payment amount, in the smallest denomination of the currency (e.g., cents fo
         #
@@ -111,8 +114,8 @@ module Dodopayments
         # @!attribute discount
         #   Discount applied to the price, represented as a percentage (0 to 100).
         #
-        #   @return [Float]
-        required :discount, Float
+        #   @return [Integer]
+        required :discount, Integer
 
         # @!attribute payment_frequency_count
         #   Number of units for the payment frequency. For example, a value of `1` with a
@@ -179,7 +182,7 @@ module Dodopayments
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
         #
-        #   @param discount [Float] Discount applied to the price, represented as a percentage (0 to 100).
+        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
         #
         #   @param payment_frequency_count [Integer] Number of units for the payment frequency.
         #
@@ -210,8 +213,120 @@ module Dodopayments
         end
       end
 
+      class UsageBasedPrice < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #   The currency in which the payment is made.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute discount
+        #   Discount applied to the price, represented as a percentage (0 to 100).
+        #
+        #   @return [Integer]
+        required :discount, Integer
+
+        # @!attribute fixed_price
+        #   The fixed payment amount. Represented in the lowest denomination of the currency
+        #   (e.g., cents for USD). For example, to charge $1.00, pass `100`.
+        #
+        #   @return [Integer]
+        required :fixed_price, Integer
+
+        # @!attribute payment_frequency_count
+        #   Number of units for the payment frequency. For example, a value of `1` with a
+        #   `payment_frequency_interval` of `month` represents monthly payments.
+        #
+        #   @return [Integer]
+        required :payment_frequency_count, Integer
+
+        # @!attribute payment_frequency_interval
+        #   The time interval for the payment frequency (e.g., day, month, year).
+        #
+        #   @return [Symbol, Dodopayments::Models::TimeInterval]
+        required :payment_frequency_interval, enum: -> { Dodopayments::TimeInterval }
+
+        # @!attribute purchasing_power_parity
+        #   Indicates if purchasing power parity adjustments are applied to the price.
+        #   Purchasing power parity feature is not available as of now
+        #
+        #   @return [Boolean]
+        required :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute subscription_period_count
+        #   Number of units for the subscription period. For example, a value of `12` with a
+        #   `subscription_period_interval` of `month` represents a one-year subscription.
+        #
+        #   @return [Integer]
+        required :subscription_period_count, Integer
+
+        # @!attribute subscription_period_interval
+        #   The time interval for the subscription period (e.g., day, month, year).
+        #
+        #   @return [Symbol, Dodopayments::Models::TimeInterval]
+        required :subscription_period_interval, enum: -> { Dodopayments::TimeInterval }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Dodopayments::Models::Price::UsageBasedPrice::Type]
+        required :type, enum: -> { Dodopayments::Price::UsageBasedPrice::Type }
+
+        # @!attribute meters
+        #
+        #   @return [Array<Dodopayments::Models::AddMeterToPrice>, nil]
+        optional :meters,
+                 -> {
+                   Dodopayments::Internal::Type::ArrayOf[Dodopayments::AddMeterToPrice]
+                 },
+                 nil?: true
+
+        # @!attribute tax_inclusive
+        #   Indicates if the price is tax inclusive
+        #
+        #   @return [Boolean, nil]
+        optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
+
+        # @!method initialize(currency:, discount:, fixed_price:, payment_frequency_count:, payment_frequency_interval:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, type:, meters: nil, tax_inclusive: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Price::UsageBasedPrice} for more details.
+        #
+        #   Usage Based price details.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
+        #
+        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
+        #
+        #   @param fixed_price [Integer] The fixed payment amount. Represented in the lowest denomination of the currency
+        #
+        #   @param payment_frequency_count [Integer] Number of units for the payment frequency.
+        #
+        #   @param payment_frequency_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the payment frequency (e.g., day, month, year).
+        #
+        #   @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price.
+        #
+        #   @param subscription_period_count [Integer] Number of units for the subscription period.
+        #
+        #   @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the subscription period (e.g., day, month, year).
+        #
+        #   @param type [Symbol, Dodopayments::Models::Price::UsageBasedPrice::Type]
+        #
+        #   @param meters [Array<Dodopayments::Models::AddMeterToPrice>, nil]
+        #
+        #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
+
+        # @see Dodopayments::Models::Price::UsageBasedPrice#type
+        module Type
+          extend Dodopayments::Internal::Type::Enum
+
+          USAGE_BASED_PRICE = :usage_based_price
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @!method self.variants
-      #   @return [Array(Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice)]
+      #   @return [Array(Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice)]
     end
   end
 end

data/lib/dodopayments/models/product.rb

@@ -42,7 +42,7 @@ module Dodopayments
       # @!attribute price
       #   Pricing information for the product.
       #
-      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice]
+      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice]
       required :price, union: -> { Dodopayments::Price }
 
       # @!attribute product_id
@@ -123,7 +123,7 @@ module Dodopayments
       #
       #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the product
       #
-      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice] Pricing information for the product.
+      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice] Pricing information for the product.
       #
       #   @param product_id [String] Unique identifier for the product.
       #

data/lib/dodopayments/models/product_archive_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Products#archive
+    class ProductArchiveParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_create_params.rb

@@ -10,7 +10,7 @@ module Dodopayments
       # @!attribute price
       #   Price configuration for the product
       #
-      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice]
+      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice]
       required :price, union: -> { Dodopayments::Price }
 
       # @!attribute tax_category
@@ -87,7 +87,7 @@ module Dodopayments
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::ProductCreateParams} for more details.
       #
-      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice] Price configuration for the product
+      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice] Price configuration for the product
       #
       #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory] Tax category applied to this product
       #

data/lib/dodopayments/models/product_list_response.rb

@@ -88,7 +88,7 @@ module Dodopayments
       # @!attribute price_detail
       #   Details of the price
       #
-      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil]
+      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil]
       optional :price_detail, union: -> { Dodopayments::Price }, nil?: true
 
       # @!attribute tax_inclusive
@@ -125,7 +125,7 @@ module Dodopayments
       #
       #   @param price [Integer, nil] Price of the product, optional.
       #
-      #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil] Details of the price
+      #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] Details of the price
       #
       #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
     end

data/lib/dodopayments/models/product_update_params.rb

@@ -89,7 +89,7 @@ module Dodopayments
       # @!attribute price
       #   Price details of the product.
       #
-      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil]
+      #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil]
       optional :price, union: -> { Dodopayments::Price }, nil?: true
 
       # @!attribute tax_category
@@ -124,7 +124,7 @@ module Dodopayments
       #
       #   @param name [String, nil] Name of the product, optional and must be at most 100 characters.
       #
-      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil] Price details of the product.
+      #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] Price details of the product.
       #
       #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory, nil] Tax category of the product.
       #

data/lib/dodopayments/models/subscription.rb

@@ -46,6 +46,12 @@ module Dodopayments
       #   @return [Hash{Symbol=>String}]
       required :metadata, Dodopayments::Internal::Type::HashOf[String]
 
+      # @!attribute meters
+      #   Meters associated with this subscription (for usage-based billing)
+      #
+      #   @return [Array<Dodopayments::Models::Subscription::Meter>]
+      required :meters, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Subscription::Meter] }
+
       # @!attribute next_billing_date
       #   Timestamp of the next scheduled billing. Indicates the end of current billing
       #   period
@@ -156,7 +162,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :expires_at, Time, nil?: true
 
-      # @!method initialize(addons:, billing:, cancel_at_next_billing_date:, created_at:, currency:, customer:, metadata:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancelled_at: nil, discount_cycles_remaining: nil, discount_id: nil, expires_at: nil)
+      # @!method initialize(addons:, billing:, cancel_at_next_billing_date:, created_at:, currency:, customer:, metadata:, meters:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancelled_at: nil, discount_cycles_remaining: nil, discount_id: nil, expires_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Subscription} for more details.
       #
@@ -176,6 +182,8 @@ module Dodopayments
       #
       #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the subscription
       #
+      #   @param meters [Array<Dodopayments::Models::Subscription::Meter>] Meters associated with this subscription (for usage-based billing)
+      #
       #   @param next_billing_date [Time] Timestamp of the next scheduled billing. Indicates the end of current billing pe
       #
       #   @param on_demand [Boolean] Wether the subscription is on-demand or not
@@ -211,6 +219,54 @@ module Dodopayments
       #   @param discount_id [String, nil] The discount id if discount is applied
       #
       #   @param expires_at [Time, nil] Timestamp when the subscription will expire
+
+      class Meter < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute free_threshold
+        #
+        #   @return [Integer]
+        required :free_threshold, Integer
+
+        # @!attribute measurement_unit
+        #
+        #   @return [String]
+        required :measurement_unit, String
+
+        # @!attribute meter_id
+        #
+        #   @return [String]
+        required :meter_id, String
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute price_per_unit
+        #
+        #   @return [String]
+        required :price_per_unit, String
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!method initialize(currency:, free_threshold:, measurement_unit:, meter_id:, name:, price_per_unit:, description: nil)
+        #   Response struct representing usage-based meter cart details for a subscription
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency]
+        #   @param free_threshold [Integer]
+        #   @param measurement_unit [String]
+        #   @param meter_id [String]
+        #   @param name [String]
+        #   @param price_per_unit [String]
+        #   @param description [String, nil]
+      end
     end
   end
 end

data/lib/dodopayments/models/subscription_retrieve_usage_history_params.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Subscriptions#retrieve_usage_history
+    class SubscriptionRetrieveUsageHistoryParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute end_date
+      #   Filter by end date (inclusive)
+      #
+      #   @return [Time, nil]
+      optional :end_date, Time, nil?: true
+
+      # @!attribute meter_id
+      #   Filter by specific meter ID
+      #
+      #   @return [String, nil]
+      optional :meter_id, String, nil?: true
+
+      # @!attribute page_number
+      #   Page number (default: 0)
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer, nil?: true
+
+      # @!attribute page_size
+      #   Page size (default: 10, max: 100)
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer, nil?: true
+
+      # @!attribute start_date
+      #   Filter by start date (inclusive)
+      #
+      #   @return [Time, nil]
+      optional :start_date, Time, nil?: true
+
+      # @!method initialize(end_date: nil, meter_id: nil, page_number: nil, page_size: nil, start_date: nil, request_options: {})
+      #   @param end_date [Time, nil] Filter by end date (inclusive)
+      #
+      #   @param meter_id [String, nil] Filter by specific meter ID
+      #
+      #   @param page_number [Integer, nil] Page number (default: 0)
+      #
+      #   @param page_size [Integer, nil] Page size (default: 10, max: 100)
+      #
+      #   @param start_date [Time, nil] Filter by start date (inclusive)
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/subscription_retrieve_usage_history_response.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Subscriptions#retrieve_usage_history
+    class SubscriptionRetrieveUsageHistoryResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute end_date
+      #   End date of the billing period
+      #
+      #   @return [Time]
+      required :end_date, Time
+
+      # @!attribute meters
+      #   List of meters and their usage for this billing period
+      #
+      #   @return [Array<Dodopayments::Models::SubscriptionRetrieveUsageHistoryResponse::Meter>]
+      required :meters,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::SubscriptionRetrieveUsageHistoryResponse::Meter] }
+
+      # @!attribute start_date
+      #   Start date of the billing period
+      #
+      #   @return [Time]
+      required :start_date, Time
+
+      # @!method initialize(end_date:, meters:, start_date:)
+      #   @param end_date [Time] End date of the billing period
+      #
+      #   @param meters [Array<Dodopayments::Models::SubscriptionRetrieveUsageHistoryResponse::Meter>] List of meters and their usage for this billing period
+      #
+      #   @param start_date [Time] Start date of the billing period
+
+      class Meter < Dodopayments::Internal::Type::BaseModel
+        # @!attribute id
+        #   Meter identifier
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute chargeable_units
+        #   Chargeable units (after free threshold) as string for precision
+        #
+        #   @return [String]
+        required :chargeable_units, String
+
+        # @!attribute consumed_units
+        #   Total units consumed as string for precision
+        #
+        #   @return [String]
+        required :consumed_units, String
+
+        # @!attribute currency
+        #   Currency for the price per unit
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute free_threshold
+        #   Free threshold units for this meter
+        #
+        #   @return [Integer]
+        required :free_threshold, Integer
+
+        # @!attribute name
+        #   Meter name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute price_per_unit
+        #   Price per unit in string format for precision
+        #
+        #   @return [String]
+        required :price_per_unit, String
+
+        # @!attribute total_price
+        #   Total price charged for this meter in smallest currency unit (cents)
+        #
+        #   @return [Integer]
+        required :total_price, Integer
+
+        # @!method initialize(id:, chargeable_units:, consumed_units:, currency:, free_threshold:, name:, price_per_unit:, total_price:)
+        #   @param id [String] Meter identifier
+        #
+        #   @param chargeable_units [String] Chargeable units (after free threshold) as string for precision
+        #
+        #   @param consumed_units [String] Total units consumed as string for precision
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] Currency for the price per unit
+        #
+        #   @param free_threshold [Integer] Free threshold units for this meter
+        #
+        #   @param name [String] Meter name
+        #
+        #   @param price_per_unit [String] Price per unit in string format for precision
+        #
+        #   @param total_price [Integer] Total price charged for this meter in smallest currency unit (cents)
+      end
+    end
+  end
+end

data/lib/dodopayments/models/usage_event_ingest_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::UsageEvents#ingest
+    class UsageEventIngestParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute events
+      #   List of events to be pushed
+      #
+      #   @return [Array<Dodopayments::Models::EventInput>]
+      required :events, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::EventInput] }
+
+      # @!method initialize(events:, request_options: {})
+      #   @param events [Array<Dodopayments::Models::EventInput>] List of events to be pushed
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/usage_event_ingest_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::UsageEvents#ingest
+    class UsageEventIngestResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute ingested_count
+      #
+      #   @return [Integer]
+      required :ingested_count, Integer
+
+      # @!method initialize(ingested_count:)
+      #   @param ingested_count [Integer]
+    end
+  end
+end

data/lib/dodopayments/models/usage_event_list_params.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::UsageEvents#list
+    class UsageEventListParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute customer_id
+      #   Filter events by customer ID
+      #
+      #   @return [String, nil]
+      optional :customer_id, String
+
+      # @!attribute end_
+      #   Filter events created before this timestamp
+      #
+      #   @return [Time, nil]
+      optional :end_, Time
+
+      # @!attribute event_name
+      #   Filter events by event name. If both event_name and meter_id are provided, they
+      #   must match the meter's configured event_name
+      #
+      #   @return [String, nil]
+      optional :event_name, String
+
+      # @!attribute meter_id
+      #   Filter events by meter ID. When provided, only events that match the meter's
+      #   event_name and filter criteria will be returned
+      #
+      #   @return [String, nil]
+      optional :meter_id, String
+
+      # @!attribute page_number
+      #   Page number (0-based, default: 0)
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Number of events to return per page (default: 10)
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!attribute start
+      #   Filter events created after this timestamp
+      #
+      #   @return [Time, nil]
+      optional :start, Time
+
+      # @!method initialize(customer_id: nil, end_: nil, event_name: nil, meter_id: nil, page_number: nil, page_size: nil, start: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::UsageEventListParams} for more details.
+      #
+      #   @param customer_id [String] Filter events by customer ID
+      #
+      #   @param end_ [Time] Filter events created before this timestamp
+      #
+      #   @param event_name [String] Filter events by event name. If both event_name and meter_id are provided, they
+      #
+      #   @param meter_id [String] Filter events by meter ID. When provided, only events that match the meter's eve
+      #
+      #   @param page_number [Integer] Page number (0-based, default: 0)
+      #
+      #   @param page_size [Integer] Number of events to return per page (default: 10)
+      #
+      #   @param start [Time] Filter events created after this timestamp
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/usage_event_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::UsageEvents#retrieve
+    class UsageEventRetrieveParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end