whop_sdk 2.2.0 → 2.3.0

data/lib/whop_sdk/partners/businesses/types/retrieve_businesses_response_payout_percentages.rb

@@ -13,6 +13,8 @@ module Whop_sdk
           field :sales, -> { Integer }, optional: false, nullable: false
 
           field :transfer, -> { Integer }, optional: false, nullable: true
+
+          field :withdrawal, -> { Integer }, optional: false, nullable: true
         end
       end
     end

data/lib/whop_sdk/partners/client.rb

@@ -107,6 +107,7 @@ module Whop_sdk
       # @option params [Whop_sdk::Partners::Types::ReferredUsersPartnersRequestUserID, nil] :user_id
       # @option params [String, nil] :earning_partner_id
       # @option params [String, nil] :earning_partner_username
+      # @option params [String, nil] :referring_account_id
       # @option params [String, nil] :query
       # @option params [Boolean, nil] :has_businesses
       # @option params [Boolean, nil] :has_earning_businesses
@@ -127,6 +128,7 @@ module Whop_sdk
         query_params["user_id"] = params[:user_id] if params.key?(:user_id)
         query_params["earning_partner_id"] = params[:earning_partner_id] if params.key?(:earning_partner_id)
         query_params["earning_partner_username"] = params[:earning_partner_username] if params.key?(:earning_partner_username)
+        query_params["referring_account_id"] = params[:referring_account_id] if params.key?(:referring_account_id)
         query_params["query"] = params[:query] if params.key?(:query)
         query_params["has_businesses"] = params[:has_businesses] if params.key?(:has_businesses)
         query_params["has_earning_businesses"] = params[:has_earning_businesses] if params.key?(:has_earning_businesses)

data/lib/whop_sdk/partners/types/referred_users_partners_request.rb

@@ -10,6 +10,8 @@ module Whop_sdk
 
         field :earning_partner_username, -> { String }, optional: true, nullable: false
 
+        field :referring_account_id, -> { String }, optional: true, nullable: false
+
         field :query, -> { String }, optional: true, nullable: false
 
         field :has_businesses, -> { Internal::Types::Boolean }, optional: true, nullable: false

data/lib/whop_sdk/payment_quotes/types/create_payment_quotes_request_address.rb

@@ -4,10 +4,11 @@ module Whop_sdk
   module PaymentQuotes
     module Types
       # The buyer's billing address. Where tax is calculated when no shipping address is given, and the address a tax
-      # registration belongs to. A seller that collects tax on this purchase needs the buyer located: provide a
-      # `country` here, on `shipping_address`, or an `ip_address`. Only the keys you supply are kept. The payment that
-      # consumes the quote must put the buyer in the same place, by country, state and postal code, through its own
-      # `shipping_address` or its confirmation token's billing address, or it is refused with `quote_mismatch`.
+      # registration belongs to. A seller that collects tax on this purchase needs the buyer located by a `country`
+      # here, on `shipping_address`, or an `ip_address`; without one the quote is refused with
+      # `quote_location_required`. Only the keys you supply are kept. The payment that consumes the quote must put the
+      # buyer in the same place, by country, state and postal code, through its own `shipping_address` or its
+      # confirmation token's billing address, or it is refused with `quote_mismatch`.
       class CreatePaymentQuotesRequestAddress < Internal::Types::Model
         field :city, -> { String }, optional: true, nullable: false
 

data/lib/whop_sdk/payments/client.rb

@@ -388,7 +388,9 @@ module Whop_sdk
         end
       end
 
-      # Voids or cancels an eligible payment. The request is rejected if the payment is no longer eligible.
+      # Voids or cancels an eligible payment. The request is rejected if the payment is no longer eligible. Some
+      # processors confirm the release of a card authorization asynchronously: the payment is then returned still
+      # `authorized`, and a `payment.canceled` webhook follows once the hold is released.
       #
       # @param request_options [Hash]
       # @param params [Hash]

data/lib/whop_sdk/payments/types/create_payments_request.rb

@@ -14,10 +14,14 @@ module Whop_sdk
 
         field :email, -> { String }, optional: true, nullable: false
 
+        field :ip_address, -> { String }, optional: true, nullable: false
+
         field :member_id, -> { String }, optional: true, nullable: false
 
         field :metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
 
+        field :off_session, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
         field :payment_method, -> { Whop_sdk::Payments::Types::CreatePaymentsRequestPaymentMethod }, optional: true, nullable: false
 
         field :payment_method_id, -> { String }, optional: true, nullable: false

data/lib/whop_sdk/payouts/client.rb

@@ -167,7 +167,10 @@ module Whop_sdk
       end
 
       # Fetches one payout by its `wdrl_` ID, or by the `cofr_` conversion request ID a stablecoin payout carries as
-      # `payout_request_id` — both ids answer with the same payout object.
+      # `payout_request_id` — both ids answer with the same payout object. Authentication is optional. Anyone with the
+      # ID can view payout tracking details, including notes, trace code, exchange rate, and payout request ID.
+      # Accounting fields require payout:withdrawal:read on the owning ledger. A supplied invalid credential returns
+      # 401.
       #
       # @param request_options [Hash]
       # @param params [Hash]

data/lib/whop_sdk/payouts/methods/types/create_methods_request_recipient.rb

@@ -4,13 +4,13 @@ module Whop_sdk
   module Payouts
     module Methods
       module Types
-        # Creates an external recipient and saves the bank method on their payout account, bound to the funding account.
-        # The MassPay email is generated when omitted; the recipient does not need a Whop login or Sumsub verification.
+        # Creates a recipient payout account linked to the funding ledger as a non-default account, then saves the bank
+        # method on it. No Whop user, company, or recipient ledger is created. A valid recipient email is required.
         # Recipient methods cannot be default or recurring methods and cannot use Plaid.
         class CreateMethodsRequestRecipient < Internal::Types::Model
           field :country, -> { String }, optional: false, nullable: false
 
-          field :email, -> { String }, optional: true, nullable: false
+          field :email, -> { String }, optional: false, nullable: false
 
           field :first_name, -> { String }, optional: false, nullable: false
 

data/lib/whop_sdk/payouts/methods/types/create_methods_response_recipient.rb

@@ -8,11 +8,11 @@ module Whop_sdk
         class CreateMethodsResponseRecipient < Internal::Types::Model
           field :country, -> { String }, optional: false, nullable: false
 
+          field :email, -> { String }, optional: false, nullable: false
+
           field :first_name, -> { String }, optional: false, nullable: false
 
           field :last_name, -> { String }, optional: false, nullable: false
-
-          field :user_id, -> { String }, optional: false, nullable: false
         end
       end
     end

data/lib/whop_sdk/payouts/methods/types/list_methods_response_data_item_recipient.rb

@@ -8,11 +8,11 @@ module Whop_sdk
         class ListMethodsResponseDataItemRecipient < Internal::Types::Model
           field :country, -> { String }, optional: false, nullable: false
 
+          field :email, -> { String }, optional: false, nullable: false
+
           field :first_name, -> { String }, optional: false, nullable: false
 
           field :last_name, -> { String }, optional: false, nullable: false
-
-          field :user_id, -> { String }, optional: false, nullable: false
         end
       end
     end

data/lib/whop_sdk/payouts/methods/types/list_methods_response_limits_standard_error_code.rb

@@ -15,7 +15,6 @@ module Whop_sdk
           RMI_CLEAR = "rmi_clear"
           IDENTITY_RFI_CLEAR = "identity_rfi_clear"
           GUARDIAN_ID_CLEAR = "guardian_id_clear"
-          ECOMMERCE_FULFILLMENT_CONNECTED = "ecommerce_fulfillment_connected"
           BLOCK_MOVE_MONEY_OUT = "block_move_money_out"
           BLOCK_MOVE_MONEY_OUT_SET_BY_PARENT = "block_move_money_out_set_by_parent"
           NO_AVAILABLE_BALANCE = "no_available_balance"

data/lib/whop_sdk/payouts/methods/types/update_methods_response_recipient.rb

@@ -8,11 +8,11 @@ module Whop_sdk
         class UpdateMethodsResponseRecipient < Internal::Types::Model
           field :country, -> { String }, optional: false, nullable: false
 
+          field :email, -> { String }, optional: false, nullable: false
+
           field :first_name, -> { String }, optional: false, nullable: false
 
           field :last_name, -> { String }, optional: false, nullable: false
-
-          field :user_id, -> { String }, optional: false, nullable: false
         end
       end
     end

data/lib/whop_sdk/payouts/types/create_quote_payouts_response.rb

@@ -21,6 +21,8 @@ module Whop_sdk
         field :object, -> { Whop_sdk::Payouts::Types::CreateQuotePayoutsResponseObject }, optional: false, nullable: false
 
         field :quote_token, -> { String }, optional: false, nullable: false
+
+        field :recommended_method, -> { Whop_sdk::Payouts::Types::CreateQuotePayoutsResponseRecommendedMethod }, optional: false, nullable: true
       end
     end
   end

data/lib/whop_sdk/payouts/types/create_quote_payouts_response_recommended_method.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Payouts
+    module Types
+      # An optional payout method to connect for estimated savings. The quote still uses the requested saved method.
+      class CreateQuotePayoutsResponseRecommendedMethod < Internal::Types::Model
+        field :country, -> { String }, optional: false, nullable: false
+
+        field :destination_currency, -> { String }, optional: false, nullable: false
+
+        field :estimated_arrival, -> { String }, optional: false, nullable: true
+
+        field :estimated_fee, -> { Whop_sdk::Types::Money }, optional: false, nullable: false
+
+        field :estimated_savings, -> { Whop_sdk::Types::Money }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+
+        field :supported_payout_method_id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/payouts/types/post_payout_method_created_payload_data_recipient.rb

@@ -7,11 +7,11 @@ module Whop_sdk
       class PostPayoutMethodCreatedPayloadDataRecipient < Internal::Types::Model
         field :country, -> { String }, optional: false, nullable: false
 
+        field :email, -> { String }, optional: false, nullable: false
+
         field :first_name, -> { String }, optional: false, nullable: false
 
         field :last_name, -> { String }, optional: false, nullable: false
-
-        field :user_id, -> { String }, optional: false, nullable: false
       end
     end
   end

data/lib/whop_sdk/payouts/types/retrieve_payouts_response.rb

@@ -4,7 +4,7 @@ module Whop_sdk
   module Payouts
     module Types
       class RetrievePayoutsResponse < Internal::Types::Model
-        field :amount, -> { String }, optional: false, nullable: false
+        field :amount, -> { String }, optional: true, nullable: false
 
         field :created_at, -> { String }, optional: false, nullable: false
 
@@ -24,15 +24,15 @@ module Whop_sdk
 
         field :failure, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseFailure }, optional: false, nullable: true
 
-        field :fee_amount, -> { String }, optional: false, nullable: false
+        field :fee_amount, -> { String }, optional: true, nullable: false
 
-        field :fee_paid_by, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseFeePaidBy }, optional: false, nullable: false
+        field :fee_paid_by, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseFeePaidBy }, optional: true, nullable: false
 
         field :id, -> { String }, optional: false, nullable: false
 
-        field :markup_fee, -> { String }, optional: false, nullable: false
+        field :markup_fee, -> { String }, optional: true, nullable: false
 
-        field :metadata, -> { Internal::Types::Hash[String, String] }, optional: false, nullable: false
+        field :metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
 
         field :net_amount, -> { String }, optional: false, nullable: false
 
@@ -46,11 +46,15 @@ module Whop_sdk
 
         field :payout_request_id, -> { String }, optional: false, nullable: true
 
-        field :source, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseSource }, optional: false, nullable: true
+        field :recipient_name, -> { String }, optional: true, nullable: false
+
+        field :sender_name, -> { String }, optional: true, nullable: false
+
+        field :source, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseSource }, optional: true, nullable: false
 
         field :speed, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseSpeed }, optional: false, nullable: false
 
-        field :statement_descriptor, -> { String }, optional: false, nullable: true
+        field :statement_descriptor, -> { String }, optional: true, nullable: false
 
         field :status, -> { Whop_sdk::Payouts::Types::RetrievePayoutsResponseStatus }, optional: false, nullable: false
 

data/lib/whop_sdk/payouts/types/retrieve_payouts_response_payout_method.rb

@@ -3,7 +3,8 @@
 module Whop_sdk
   module Payouts
     module Types
-      # The saved payout method used. Requires payout:destination:read; null without it.
+      # Payout method display details. The nickname requires payout:destination:read on the owning ledger; otherwise it
+      # is null.
       class RetrievePayoutsResponsePayoutMethod < Internal::Types::Model
         field :nickname, -> { String }, optional: false, nullable: true
 

data/lib/whop_sdk/setup_intents/client.rb

@@ -85,9 +85,10 @@ module Whop_sdk
 
       # Saves a buyer's payment method for later without charging it. Pass a `confirmation_token` for a method the buyer
       # just supplied through the payment elements in setup mode, or a `payment_method_id` already on file to re-verify
-      # it. The response is the setup intent as created, not its outcome: while it is `requires_action` the buyer still
-      # has a step, so hand `client_secret` to the elements' `handleNextAction` or poll Retrieve setup status. A buyer's
-      # own token holding `member:payment_methods:use` may create a setup intent for itself from a confirmation token.
+      # it. The response is the setup intent as created, not its outcome: it is `processing` while the payment method is
+      # saved in the background, and `requires_action` when the buyer still has a step. Hand `client_secret` to the
+      # elements' `handleNextAction`, or poll Retrieve setup status, for the outcome. A buyer's own token holding
+      # `member:payment_methods:use` may create a setup intent for itself from a confirmation token.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SetupIntents::Types::CreateSetupIntentsRequest]

data/lib/whop_sdk/social_accounts/client.rb

@@ -14,7 +14,7 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Lists the social accounts linked to an account or user.
+      # Deprecated compatibility endpoint. List external accounts with `GET /external_accounts` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -85,7 +85,7 @@ module Whop_sdk
         end
       end
 
-      # Creates or returns a Whop-managed Facebook page or TikTok account for an account.
+      # Deprecated compatibility endpoint. Create external accounts with `POST /external_accounts` instead.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::CreateSocialAccountsRequest]
@@ -122,11 +122,7 @@ module Whop_sdk
         end
       end
 
-      # Starts an OAuth connection flow and returns an authorize_url where the user can connect a social account.
-      # LinkedIn supports personal profiles only, with scopes omitted. TikTok connects the authenticated user’s profile
-      # when scopes are omitted or company advertising assets with advertise. Meta Business and Snapchat support
-      # advertising connections only and require advertise. Personal profile connections must be completed in a browser
-      # signed in as the initiating Whop user.
+      # Deprecated compatibility endpoint. Connect external accounts with `POST /external_accounts/connect` instead.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::ConnectSocialAccountsRequest]
@@ -166,7 +162,7 @@ module Whop_sdk
         end
       end
 
-      # Disconnects a social account from an account or user without deleting the underlying platform account.
+      # Deprecated compatibility endpoint. Disconnect external accounts with `DELETE /external_accounts/{id}` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -210,9 +206,7 @@ module Whop_sdk
         end
       end
 
-      # Lists the active lead (instant) forms that already exist on a connected Facebook page, so an ad can reuse one as
-      # its `lead_gen_form_id` instead of authoring a new form. Every active form comes back in a single response — the
-      # list is not paginated.
+      # Deprecated compatibility endpoint. List lead forms with `GET /external_accounts/{id}/lead_forms` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -257,7 +251,8 @@ module Whop_sdk
         end
       end
 
-      # Lists the creators an Instagram account runs partnership ads with, and where each creator's permission stands.
+      # Deprecated compatibility endpoint. List partners with `GET /external_accounts/{external_account_id}/partners`
+      # instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -311,9 +306,8 @@ module Whop_sdk
         end
       end
 
-      # Invites an Instagram creator to run partnership ads with an Instagram account. The creator approves the
-      # invitation in the Instagram app, and `partnership_status` stays `pending` until they do;
-      # [refresh](/api-reference/beta/social-accounts/refresh) the partner to pick up their answer.
+      # Deprecated compatibility endpoint. Add partners with `POST /external_accounts/{external_account_id}/partners`
+      # instead.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::AddPartnerSocialAccountsRequest]
@@ -358,8 +352,8 @@ module Whop_sdk
         end
       end
 
-      # Revokes a creator's permission to run partnership ads with an Instagram account. Every account that advertises
-      # as the Instagram account loses the partner, since the permission belongs to the Instagram account.
+      # Deprecated compatibility endpoint. Remove partners with `DELETE
+      # /external_accounts/{external_account_id}/partners/{id}` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -405,7 +399,7 @@ module Whop_sdk
         end
       end
 
-      # Lists the existing posts of a connected Facebook page, Instagram account, or TikTok account.
+      # Deprecated compatibility endpoint. List posts with `GET /external_accounts/{id}/posts` instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -464,7 +458,8 @@ module Whop_sdk
         end
       end
 
-      # Refreshes the state of a social account. Use it to clear an `error` that has been resolved.
+      # Deprecated compatibility endpoint. Refresh external accounts with `POST /external_accounts/{id}/refresh`
+      # instead.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::RefreshSocialAccountsRequest]

data/lib/whop_sdk/stats/client.rb

@@ -14,7 +14,9 @@ module Whop_sdk
         @environment = environment
       end
 
-      # Lists every metric you can query, with its unit and the properties you can filter or break it down by.
+      # Deprecated. Lists every metric, which no longer says which of them a projection accepts. List the ones you can
+      # chart with `GET /stats/time_series`. Aggregates that are not bucketed over time are reports, listed at `GET
+      # /stats/reports`.
       #
       # @param request_options [Hash]
       # @param _params [Hash]
@@ -49,13 +51,8 @@ module Whop_sdk
         end
       end
 
-      # Retrieves a metric as a time series of points for an account or user over a time range. The `market_prices`
-      # metric is public and requires no authentication. The `funnel` metric measures 2 to 10 ordered events per person.
-      # Its first matching event inside from/to anchors the cohort, breakdown and conversion window; later entries do
-      # not restart it. Intervening events are allowed, and conversions may occur after to. Funnel values are final
-      # conversion percentages; steps include counts and cumulative conversion percentages. Experiment funnels use
-      # experiment.exposure as step 1 and breakdown_by=variant. Pass steps using bracket parameters such as
-      # steps[1][event]=pixel.page&steps[1][page]=/pricing*&steps[2][event]=payment.completed.
+      # Deprecated compatibility endpoint. Retrieve a metric's time series with `GET /stats/time_series/{metric}`
+      # instead.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -99,6 +96,9 @@ module Whop_sdk
       # @option params [String, nil] :ad_ids
       # @option params [Whop_sdk::Stats::Types::RetrieveStatsRequestSnapshotWindow, nil] :snapshot_window
       # @option params [String, nil] :event
+      # @option params [String, nil] :business_type
+      # @option params [String, nil] :industry_type
+      # @option params [String, nil] :issuer
       # @option params [String, nil] :conversion_window
       # @option params [Boolean, nil] :mature_only
       # @option params [Whop_sdk::Types::RetrieveStatsRequestSteps, nil] :steps
@@ -131,6 +131,7 @@ module Whop_sdk
       # @option params [Integer, nil] :event_count_gte
       # @option params [Integer, nil] :event_count_lt
       # @option params [Integer, nil] :event_count_lte
+      # @option params [String, nil] :referring_account_id
       #
       # @example
       #   client.stats.retrieve(
@@ -180,6 +181,9 @@ module Whop_sdk
         query_params["ad_ids"] = params[:ad_ids] if params.key?(:ad_ids)
         query_params["snapshot_window"] = params[:snapshot_window] if params.key?(:snapshot_window)
         query_params["event"] = params[:event] if params.key?(:event)
+        query_params["business_type"] = params[:business_type] if params.key?(:business_type)
+        query_params["industry_type"] = params[:industry_type] if params.key?(:industry_type)
+        query_params["issuer"] = params[:issuer] if params.key?(:issuer)
         query_params["conversion_window"] = params[:conversion_window] if params.key?(:conversion_window)
         query_params["mature_only"] = params[:mature_only] if params.key?(:mature_only)
         query_params["steps"] = params[:steps] if params.key?(:steps)
@@ -212,6 +216,7 @@ module Whop_sdk
         query_params["event_count_gte"] = params[:event_count_gte] if params.key?(:event_count_gte)
         query_params["event_count_lt"] = params[:event_count_lt] if params.key?(:event_count_lt)
         query_params["event_count_lte"] = params[:event_count_lte] if params.key?(:event_count_lte)
+        query_params["referring_account_id"] = params[:referring_account_id] if params.key?(:referring_account_id)
 
         request = Whop_sdk::Internal::JSON::Request.new(
           base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
@@ -233,6 +238,16 @@ module Whop_sdk
           raise error_class.new(response.body, code: code)
         end
       end
+
+      # @return [Whop_sdk::Reports::Client]
+      def reports
+        @reports ||= Whop_sdk::Stats::Reports::Client.new(client: @client, base_url: @base_url, environment: @environment)
+      end
+
+      # @return [Whop_sdk::TimeSeries::Client]
+      def time_series
+        @time_series ||= Whop_sdk::Stats::TimeSeries::Client.new(client: @client, base_url: @base_url, environment: @environment)
+      end
     end
   end
 end

data/lib/whop_sdk/stats/reports/client.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Stats
+    module Reports
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Lists every report: the aggregates that are not bucketed over time. Each entry names the report's path, its
+        # window kind, the breakdowns it accepts and its columns. A property column is an attribute of the row and lists
+        # the breakdowns it can ride along with. A metric column is a number measured over the row, with the unit that
+        # sets its JSON type, the aggregate that says how to combine it across rows, and the breakdowns and windows it
+        # supports. For a bucketed series, use `GET /stats/time_series`.
+        #
+        # @param request_options [Hash]
+        # @param _params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        #
+        # @example
+        #   client.stats.reports.list
+        #
+        # @return [Whop_sdk::Stats::Reports::Types::ListReportsResponse]
+        def list(request_options: {}, **_params)
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "GET",
+            path: "stats/reports",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::Stats::Reports::Types::ListReportsResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Payments across all of Whop, for up to four windows at once. Break rows down by business type, industry type,
+        # account country or customer country, and let the business type ride along on industry type rows. The report
+        # covers the whole platform, so it takes no `account_id` and any authenticated caller can read it. A breakdown
+        # value with fewer than three businesses behind it is left out, and a filtered total that small comes back with
+        # every metric `null`.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Whop_sdk::Stats::Reports::Types::PlatformTrendsReportsRequestBreakdownBy, nil] :breakdown_by
+        # @option params [String, nil] :columns
+        # @option params [String, nil] :windows
+        # @option params [String, nil] :time_zone
+        # @option params [Whop_sdk::Stats::Reports::Types::PlatformTrendsReportsRequestOrder, nil] :order
+        # @option params [Whop_sdk::Stats::Reports::Types::PlatformTrendsReportsRequestDirection, nil] :direction
+        # @option params [String, nil] :convert_to
+        # @option params [String, nil] :business_type
+        # @option params [String, nil] :industry_type
+        # @option params [String, nil] :account_country
+        # @option params [String, nil] :customer_country
+        # @option params [Integer, nil] :first
+        # @option params [String, nil] :after
+        #
+        # @example
+        #   client.stats.reports.platform_trends
+        #
+        # @return [Whop_sdk::Stats::Reports::Types::PlatformTrendsReportsResponse]
+        def platform_trends(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["breakdown_by"] = params[:breakdown_by] if params.key?(:breakdown_by)
+          query_params["columns"] = params[:columns] if params.key?(:columns)
+          query_params["windows"] = params[:windows] if params.key?(:windows)
+          query_params["time_zone"] = params[:time_zone] if params.key?(:time_zone)
+          query_params["order"] = params[:order] if params.key?(:order)
+          query_params["direction"] = params[:direction] if params.key?(:direction)
+          query_params["convert_to"] = params[:convert_to] if params.key?(:convert_to)
+          query_params["business_type"] = params[:business_type] if params.key?(:business_type)
+          query_params["industry_type"] = params[:industry_type] if params.key?(:industry_type)
+          query_params["account_country"] = params[:account_country] if params.key?(:account_country)
+          query_params["customer_country"] = params[:customer_country] if params.key?(:customer_country)
+          query_params["first"] = params[:first] if params.key?(:first)
+          query_params["after"] = params[:after] if params.key?(:after)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "GET",
+            path: "stats/reports/platform_trends",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::Stats::Reports::Types::PlatformTrendsReportsResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/stats/reports/types/list_reports_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Stats
+    module Reports
+      module Types
+        class ListReportsResponse < Internal::Types::Model
+          field :data, -> { Internal::Types::Array[Whop_sdk::Stats::Reports::Types::ListReportsResponseDataItem] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/stats/reports/types/list_reports_response_data_item.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module Stats
+    module Reports
+      module Types
+        class ListReportsResponseDataItem < Internal::Types::Model
+          field :breakdowns, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+
+          field :columns, -> { Internal::Types::Array[Whop_sdk::Stats::Reports::Types::ListReportsResponseDataItemColumnsItem] }, optional: false, nullable: false
+
+          field :description, -> { String }, optional: false, nullable: false
+
+          field :key, -> { String }, optional: false, nullable: false
+
+          field :path, -> { String }, optional: false, nullable: false
+
+          field :window_field, -> { String }, optional: false, nullable: true
+
+          field :window_kind, -> { Whop_sdk::Stats::Reports::Types::ListReportsResponseDataItemWindowKind }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end