prelude-sdk 0.2.0 → 0.3.0

data/lib/prelude_sdk/models/verification_create_params.rb

@@ -111,8 +111,8 @@ module PreludeSDK
 
       class Options < PreludeSDK::Internal::Type::BaseModel
         # @!attribute app_realm
-        #   This allows you to automatically retrieve and fill the OTP code on mobile apps.
-        #   Currently only Android devices are supported.
+        #   This allows automatic OTP retrieval on mobile apps and web browsers. Supported
+        #   platforms are Android (SMS Retriever API) and Web (WebOTP API).
         #
         #   @return [PreludeSDK::Models::VerificationCreateParams::Options::AppRealm, nil]
         optional :app_realm, -> { PreludeSDK::VerificationCreateParams::Options::AppRealm }
@@ -140,12 +140,6 @@ module PreludeSDK
         #   @return [String, nil]
         optional :custom_code, String
 
-        # @!attribute integration
-        #   The integration that triggered the verification.
-        #
-        #   @return [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Integration, nil]
-        optional :integration, enum: -> { PreludeSDK::VerificationCreateParams::Options::Integration }
-
         # @!attribute locale
         #   A BCP-47 formatted locale string with the language the text message will be sent
         #   to. If there's no locale set, the language will be determined by the country
@@ -195,13 +189,13 @@ module PreludeSDK
         #   @return [Hash{Symbol=>String}, nil]
         optional :variables, PreludeSDK::Internal::Type::HashOf[String]
 
-        # @!method initialize(app_realm: nil, callback_url: nil, code_size: nil, custom_code: nil, integration: nil, locale: nil, verification_method: nil, preferred_channel: nil, sender_id: nil, template_id: nil, variables: nil)
+        # @!method initialize(app_realm: nil, callback_url: nil, code_size: nil, custom_code: nil, locale: nil, verification_method: nil, preferred_channel: nil, sender_id: nil, template_id: nil, variables: nil)
         #   Some parameter documentations has been truncated, see
         #   {PreludeSDK::Models::VerificationCreateParams::Options} for more details.
         #
         #   Verification options
         #
-        #   @param app_realm [PreludeSDK::Models::VerificationCreateParams::Options::AppRealm] This allows you to automatically retrieve and fill the OTP code on mobile apps.
+        #   @param app_realm [PreludeSDK::Models::VerificationCreateParams::Options::AppRealm] This allows automatic OTP retrieval on mobile apps and web browsers. Supported p
         #
         #   @param callback_url [String] The URL where webhooks will be sent when verification events occur, including ve
         #
@@ -209,8 +203,6 @@ module PreludeSDK
         #
         #   @param custom_code [String] The custom code to use for OTP verification. To use the custom code feature, con
         #
-        #   @param integration [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Integration] The integration that triggered the verification.
-        #
         #   @param locale [String] A BCP-47 formatted locale string with the language the text message will be sent
         #
         #   @param verification_method [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::Method] The method used for verifying this phone number. The 'voice' option provides an
@@ -226,16 +218,19 @@ module PreludeSDK
         # @see PreludeSDK::Models::VerificationCreateParams::Options#app_realm
         class AppRealm < PreludeSDK::Internal::Type::BaseModel
           # @!attribute platform
-          #   The platform the SMS will be sent to. We are currently only supporting
-          #   "android".
+          #   The platform for automatic OTP retrieval. Use "android" for the SMS Retriever
+          #   API or "web" for the WebOTP API.
           #
           #   @return [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::AppRealm::Platform]
           required :platform, enum: -> { PreludeSDK::VerificationCreateParams::Options::AppRealm::Platform }
 
           # @!attribute value
-          #   The Android SMS Retriever API hash code that identifies your app. For more
-          #   information, see
-          #   [Google documentation](https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string).
+          #   The value depends on the platform:
+          #
+          #   - For Android: The SMS Retriever API hash code (11 characters). See
+          #     [Google documentation](https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string).
+          #   - For Web: The origin domain (e.g., "example.com" or "www.example.com"). See
+          #     [WebOTP API documentation](https://developer.mozilla.org/en-US/docs/Web/API/WebOTP_API).
           #
           #   @return [String]
           required :value, String
@@ -245,40 +240,28 @@ module PreludeSDK
           #   {PreludeSDK::Models::VerificationCreateParams::Options::AppRealm} for more
           #   details.
           #
-          #   This allows you to automatically retrieve and fill the OTP code on mobile apps.
-          #   Currently only Android devices are supported.
+          #   This allows automatic OTP retrieval on mobile apps and web browsers. Supported
+          #   platforms are Android (SMS Retriever API) and Web (WebOTP API).
           #
-          #   @param platform [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::AppRealm::Platform] The platform the SMS will be sent to. We are currently only supporting "android"
+          #   @param platform [Symbol, PreludeSDK::Models::VerificationCreateParams::Options::AppRealm::Platform] The platform for automatic OTP retrieval. Use "android" for the SMS Retriever AP
           #
-          #   @param value [String] The Android SMS Retriever API hash code that identifies your app.
+          #   @param value [String] The value depends on the platform:
 
-          # The platform the SMS will be sent to. We are currently only supporting
-          # "android".
+          # The platform for automatic OTP retrieval. Use "android" for the SMS Retriever
+          # API or "web" for the WebOTP API.
           #
           # @see PreludeSDK::Models::VerificationCreateParams::Options::AppRealm#platform
           module Platform
             extend PreludeSDK::Internal::Type::Enum
 
             ANDROID = :android
+            WEB = :web
 
             # @!method self.values
             #   @return [Array<Symbol>]
           end
         end
 
-        # The integration that triggered the verification.
-        #
-        # @see PreludeSDK::Models::VerificationCreateParams::Options#integration
-        module Integration
-          extend PreludeSDK::Internal::Type::Enum
-
-          AUTH0 = :auth0
-          SUPABASE = :supabase
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
         # The method used for verifying this phone number. The 'voice' option provides an
         # accessible alternative for visually impaired users by delivering the
         # verification code through a phone call rather than a text message. It also
@@ -325,8 +308,9 @@ module PreludeSDK
         optional :app_version, String
 
         # @!attribute device_id
-        #   The unique identifier for the user's device. For Android, this corresponds to
-        #   the `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
+        #   A unique ID for the user's device. You should ensure that each user device has a
+        #   unique `device_id` value. Ideally, for Android, this corresponds to the
+        #   `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
         #
         #   @return [String, nil]
         optional :device_id, String
@@ -344,23 +328,26 @@ module PreludeSDK
         optional :device_platform, enum: -> { PreludeSDK::VerificationCreateParams::Signals::DevicePlatform }
 
         # @!attribute ip
-        #   The IP address of the user's device.
+        #   The public IP v4 or v6 address of the end-user's device. You should collect this
+        #   from your backend. If your backend is behind a proxy, use the `X-Forwarded-For`,
+        #   `Forwarded`, `True-Client-IP`, `CF-Connecting-IP` or an equivalent header to get
+        #   the actual public IP of the end-user's device.
         #
         #   @return [String, nil]
         optional :ip, String
 
         # @!attribute is_trusted_user
-        #   This signal should provide a higher level of trust, indicating that the user is
-        #   genuine. Contact us to discuss your use case. For more details, refer to
+        #   This signal should indicate a higher level of trust, explicitly stating that the
+        #   user is genuine. Contact us to discuss your use case. For more details, refer to
         #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
         #
         #   @return [Boolean, nil]
         optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
 
         # @!attribute ja4_fingerprint
-        #   The JA4 fingerprint observed for the connection. Prelude will infer it
-        #   automatically when requests go through our client SDK (which uses Prelude's
-        #   edge), but you can also provide it explicitly if you terminate TLS yourself.
+        #   The JA4 fingerprint observed for the end-user's connection. Prelude will infer
+        #   it automatically when you use our Frontend SDKs (which use Prelude's edge
+        #   network), but you can also forward the value if you terminate TLS yourself.
         #
         #   @return [String, nil]
         optional :ja4_fingerprint, String
@@ -388,17 +375,17 @@ module PreludeSDK
         #
         #   @param app_version [String] The version of your application.
         #
-        #   @param device_id [String] The unique identifier for the user's device. For Android, this corresponds to th
+        #   @param device_id [String] A unique ID for the user's device. You should ensure that each user device has a
         #
         #   @param device_model [String] The model of the user's device.
         #
         #   @param device_platform [Symbol, PreludeSDK::Models::VerificationCreateParams::Signals::DevicePlatform] The type of the user's device.
         #
-        #   @param ip [String] The IP address of the user's device.
+        #   @param ip [String] The public IP v4 or v6 address of the end-user's device. You should collect this
         #
-        #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
+        #   @param is_trusted_user [Boolean] This signal should indicate a higher level of trust, explicitly stating that the
         #
-        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
+        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the end-user's connection. Prelude will infer i
         #
         #   @param os_version [String] The version of the user's device operating system.
         #

data/lib/prelude_sdk/models/verification_create_response.rb

@@ -21,6 +21,13 @@ module PreludeSDK
       # @!attribute status
       #   The status of the verification.
       #
+      #   - `success` - A new verification window was created.
+      #   - `retry` - A new attempt was created for an existing verification window.
+      #   - `challenged` - The verification is suspicious and is restricted to non-SMS and
+      #     non-voice channels only. This mode must be enabled for your customer account
+      #     by Prelude support.
+      #   - `blocked` - The verification was blocked.
+      #
       #   @return [Symbol, PreludeSDK::Models::VerificationCreateResponse::Status]
       required :status, enum: -> { PreludeSDK::Models::VerificationCreateResponse::Status }
 
@@ -105,12 +112,20 @@ module PreludeSDK
 
       # The status of the verification.
       #
+      # - `success` - A new verification window was created.
+      # - `retry` - A new attempt was created for an existing verification window.
+      # - `challenged` - The verification is suspicious and is restricted to non-SMS and
+      #   non-voice channels only. This mode must be enabled for your customer account
+      #   by Prelude support.
+      # - `blocked` - The verification was blocked.
+      #
       # @see PreludeSDK::Models::VerificationCreateResponse#status
       module Status
         extend PreludeSDK::Internal::Type::Enum
 
         SUCCESS = :success
         RETRY = :retry
+        CHALLENGED = :challenged
         BLOCKED = :blocked
 
         # @!method self.values

data/lib/prelude_sdk/models/verification_management_delete_phone_number_params.rb

@@ -7,13 +7,20 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
+      # @!attribute action
+      #
+      #   @return [Symbol, PreludeSDK::Models::VerificationManagementDeletePhoneNumberParams::Action]
+      required :action, enum: -> { PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action }
+
       # @!attribute phone_number
       #   An E.164 formatted phone number to remove from the list.
       #
       #   @return [String]
       required :phone_number, String
 
-      # @!method initialize(phone_number:, request_options: {})
+      # @!method initialize(action:, phone_number:, request_options: {})
+      #   @param action [Symbol, PreludeSDK::Models::VerificationManagementDeletePhoneNumberParams::Action]
+      #
       #   @param phone_number [String] An E.164 formatted phone number to remove from the list.
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]

data/lib/prelude_sdk/models/verification_management_list_phone_numbers_params.rb

@@ -7,7 +7,13 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute action
+      #
+      #   @return [Symbol, PreludeSDK::Models::VerificationManagementListPhoneNumbersParams::Action]
+      required :action, enum: -> { PreludeSDK::VerificationManagementListPhoneNumbersParams::Action }
+
+      # @!method initialize(action:, request_options: {})
+      #   @param action [Symbol, PreludeSDK::Models::VerificationManagementListPhoneNumbersParams::Action]
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
 
       module Action

data/lib/prelude_sdk/models/verification_management_set_phone_number_params.rb

@@ -7,13 +7,20 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
+      # @!attribute action
+      #
+      #   @return [Symbol, PreludeSDK::Models::VerificationManagementSetPhoneNumberParams::Action]
+      required :action, enum: -> { PreludeSDK::VerificationManagementSetPhoneNumberParams::Action }
+
       # @!attribute phone_number
       #   An E.164 formatted phone number to add to the list.
       #
       #   @return [String]
       required :phone_number, String
 
-      # @!method initialize(phone_number:, request_options: {})
+      # @!method initialize(action:, phone_number:, request_options: {})
+      #   @param action [Symbol, PreludeSDK::Models::VerificationManagementSetPhoneNumberParams::Action]
+      #
       #   @param phone_number [String] An E.164 formatted phone number to add to the list.
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]

data/lib/prelude_sdk/models/watch_predict_params.rb

@@ -105,8 +105,9 @@ module PreludeSDK
         optional :app_version, String
 
         # @!attribute device_id
-        #   The unique identifier for the user's device. For Android, this corresponds to
-        #   the `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
+        #   A unique ID for the user's device. You should ensure that each user device has a
+        #   unique `device_id` value. Ideally, for Android, this corresponds to the
+        #   `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
         #
         #   @return [String, nil]
         optional :device_id, String
@@ -124,23 +125,26 @@ module PreludeSDK
         optional :device_platform, enum: -> { PreludeSDK::WatchPredictParams::Signals::DevicePlatform }
 
         # @!attribute ip
-        #   The IP address of the user's device.
+        #   The public IP v4 or v6 address of the end-user's device. You should collect this
+        #   from your backend. If your backend is behind a proxy, use the `X-Forwarded-For`,
+        #   `Forwarded`, `True-Client-IP`, `CF-Connecting-IP` or an equivalent header to get
+        #   the actual public IP of the end-user's device.
         #
         #   @return [String, nil]
         optional :ip, String
 
         # @!attribute is_trusted_user
-        #   This signal should provide a higher level of trust, indicating that the user is
-        #   genuine. Contact us to discuss your use case. For more details, refer to
+        #   This signal should indicate a higher level of trust, explicitly stating that the
+        #   user is genuine. Contact us to discuss your use case. For more details, refer to
         #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
         #
         #   @return [Boolean, nil]
         optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
 
         # @!attribute ja4_fingerprint
-        #   The JA4 fingerprint observed for the connection. Prelude will infer it
-        #   automatically when requests go through our client SDK (which uses Prelude's
-        #   edge), but you can also provide it explicitly if you terminate TLS yourself.
+        #   The JA4 fingerprint observed for the end-user's connection. Prelude will infer
+        #   it automatically when you use our Frontend SDKs (which use Prelude's edge
+        #   network), but you can also forward the value if you terminate TLS yourself.
         #
         #   @return [String, nil]
         optional :ja4_fingerprint, String
@@ -168,17 +172,17 @@ module PreludeSDK
         #
         #   @param app_version [String] The version of your application.
         #
-        #   @param device_id [String] The unique identifier for the user's device. For Android, this corresponds to th
+        #   @param device_id [String] A unique ID for the user's device. You should ensure that each user device has a
         #
         #   @param device_model [String] The model of the user's device.
         #
         #   @param device_platform [Symbol, PreludeSDK::Models::WatchPredictParams::Signals::DevicePlatform] The type of the user's device.
         #
-        #   @param ip [String] The IP address of the user's device.
+        #   @param ip [String] The public IP v4 or v6 address of the end-user's device. You should collect this
         #
-        #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
+        #   @param is_trusted_user [Boolean] This signal should indicate a higher level of trust, explicitly stating that the
         #
-        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
+        #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the end-user's connection. Prelude will infer i
         #
         #   @param os_version [String] The version of the user's device operating system.
         #

data/lib/prelude_sdk/models/watch_predict_response.rb

@@ -23,7 +23,37 @@ module PreludeSDK
       #   @return [String]
       required :request_id, String
 
-      # @!method initialize(id:, prediction:, request_id:)
+      # @!attribute risk_factors
+      #   The risk factors that contributed to the suspicious prediction. Only present
+      #   when prediction is "suspicious" and the anti-fraud system detected specific risk
+      #   signals.
+      #
+      #   - `behavioral_pattern` - The phone number past behavior during verification
+      #     flows exhibits suspicious patterns.
+      #   - `device_attribute` - The device exhibits characteristics associated with
+      #     suspicious activity patterns.
+      #   - `fraud_database` - The phone number has been flagged as suspicious in one or
+      #     more of our fraud databases.
+      #   - `location_discrepancy` - The phone number prefix and IP address discrepancy
+      #     indicates potential fraud.
+      #   - `network_fingerprint` - The network connection exhibits characteristics
+      #     associated with suspicious activity patterns.
+      #   - `poor_conversion_history` - The phone number has a history of poorly
+      #     converting to a verified phone number.
+      #   - `prefix_concentration` - The phone number is part of a range known to be
+      #     associated with suspicious activity patterns.
+      #   - `suspected_request_tampering` - The SDK signature is invalid and the request
+      #     is considered to be tampered with.
+      #   - `suspicious_ip_address` - The IP address is deemed to be associated with
+      #     suspicious activity patterns.
+      #   - `temporary_phone_number` - The phone number is known to be a temporary or
+      #     disposable number.
+      #
+      #   @return [Array<Symbol, PreludeSDK::Models::WatchPredictResponse::RiskFactor>, nil]
+      optional :risk_factors,
+               -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::Models::WatchPredictResponse::RiskFactor] }
+
+      # @!method initialize(id:, prediction:, request_id:, risk_factors: nil)
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::WatchPredictResponse} for more details.
       #
@@ -32,6 +62,8 @@ module PreludeSDK
       #   @param prediction [Symbol, PreludeSDK::Models::WatchPredictResponse::Prediction] The prediction outcome.
       #
       #   @param request_id [String] A string that identifies this specific request. Report it back to us to help us
+      #
+      #   @param risk_factors [Array<Symbol, PreludeSDK::Models::WatchPredictResponse::RiskFactor>] The risk factors that contributed to the suspicious prediction. Only present whe
 
       # The prediction outcome.
       #
@@ -45,6 +77,24 @@ module PreludeSDK
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      module RiskFactor
+        extend PreludeSDK::Internal::Type::Enum
+
+        BEHAVIORAL_PATTERN = :behavioral_pattern
+        DEVICE_ATTRIBUTE = :device_attribute
+        FRAUD_DATABASE = :fraud_database
+        LOCATION_DISCREPANCY = :location_discrepancy
+        NETWORK_FINGERPRINT = :network_fingerprint
+        POOR_CONVERSION_HISTORY = :poor_conversion_history
+        PREFIX_CONCENTRATION = :prefix_concentration
+        SUSPECTED_REQUEST_TAMPERING = :suspected_request_tampering
+        SUSPICIOUS_IP_ADDRESS = :suspicious_ip_address
+        TEMPORARY_PHONE_NUMBER = :temporary_phone_number
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/prelude_sdk/models/watch_send_feedbacks_params.rb

@@ -32,38 +32,18 @@ module PreludeSDK
         #   @return [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Type]
         required :type, enum: -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Type }
 
-        # @!attribute dispatch_id
-        #   The identifier of the dispatch that came from the front-end SDK.
-        #
-        #   @return [String, nil]
-        optional :dispatch_id, String
-
         # @!attribute metadata
         #   The metadata for this feedback.
         #
         #   @return [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Metadata, nil]
         optional :metadata, -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Metadata }
 
-        # @!attribute signals
-        #   The signals used for anti-fraud. For more details, refer to
-        #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-        #
-        #   @return [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals, nil]
-        optional :signals, -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Signals }
-
-        # @!method initialize(target:, type:, dispatch_id: nil, metadata: nil, signals: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {PreludeSDK::Models::WatchSendFeedbacksParams::Feedback} for more details.
-        #
+        # @!method initialize(target:, type:, metadata: nil)
         #   @param target [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Target] The feedback target. Only supports phone numbers for now.
         #
         #   @param type [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Type] The type of feedback.
         #
-        #   @param dispatch_id [String] The identifier of the dispatch that came from the front-end SDK.
-        #
         #   @param metadata [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Metadata] The metadata for this feedback.
-        #
-        #   @param signals [PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals] The signals used for anti-fraud. For more details, refer to [Signals](/verify/v2
 
         # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback#target
         class Target < PreludeSDK::Internal::Type::BaseModel
@@ -131,113 +111,6 @@ module PreludeSDK
           #
           #   @param correlation_id [String] A user-defined identifier to correlate this feedback with. It is returned in the
         end
-
-        # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback#signals
-        class Signals < PreludeSDK::Internal::Type::BaseModel
-          # @!attribute app_version
-          #   The version of your application.
-          #
-          #   @return [String, nil]
-          optional :app_version, String
-
-          # @!attribute device_id
-          #   The unique identifier for the user's device. For Android, this corresponds to
-          #   the `ANDROID_ID` and for iOS, this corresponds to the `identifierForVendor`.
-          #
-          #   @return [String, nil]
-          optional :device_id, String
-
-          # @!attribute device_model
-          #   The model of the user's device.
-          #
-          #   @return [String, nil]
-          optional :device_model, String
-
-          # @!attribute device_platform
-          #   The type of the user's device.
-          #
-          #   @return [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform, nil]
-          optional :device_platform,
-                   enum: -> { PreludeSDK::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform }
-
-          # @!attribute ip
-          #   The IP address of the user's device.
-          #
-          #   @return [String, nil]
-          optional :ip, String
-
-          # @!attribute is_trusted_user
-          #   This signal should provide a higher level of trust, indicating that the user is
-          #   genuine. Contact us to discuss your use case. For more details, refer to
-          #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-          #
-          #   @return [Boolean, nil]
-          optional :is_trusted_user, PreludeSDK::Internal::Type::Boolean
-
-          # @!attribute ja4_fingerprint
-          #   The JA4 fingerprint observed for the connection. Prelude will infer it
-          #   automatically when requests go through our client SDK (which uses Prelude's
-          #   edge), but you can also provide it explicitly if you terminate TLS yourself.
-          #
-          #   @return [String, nil]
-          optional :ja4_fingerprint, String
-
-          # @!attribute os_version
-          #   The version of the user's device operating system.
-          #
-          #   @return [String, nil]
-          optional :os_version, String
-
-          # @!attribute user_agent
-          #   The user agent of the user's device. If the individual fields (os_version,
-          #   device_platform, device_model) are provided, we will prioritize those values
-          #   instead of parsing them from the user agent string.
-          #
-          #   @return [String, nil]
-          optional :user_agent, String
-
-          # @!method initialize(app_version: nil, device_id: nil, device_model: nil, device_platform: nil, ip: nil, is_trusted_user: nil, ja4_fingerprint: nil, os_version: nil, user_agent: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals} for more
-          #   details.
-          #
-          #   The signals used for anti-fraud. For more details, refer to
-          #   [Signals](/verify/v2/documentation/prevent-fraud#signals).
-          #
-          #   @param app_version [String] The version of your application.
-          #
-          #   @param device_id [String] The unique identifier for the user's device. For Android, this corresponds to th
-          #
-          #   @param device_model [String] The model of the user's device.
-          #
-          #   @param device_platform [Symbol, PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals::DevicePlatform] The type of the user's device.
-          #
-          #   @param ip [String] The IP address of the user's device.
-          #
-          #   @param is_trusted_user [Boolean] This signal should provide a higher level of trust, indicating that the user is
-          #
-          #   @param ja4_fingerprint [String] The JA4 fingerprint observed for the connection. Prelude will infer it automatic
-          #
-          #   @param os_version [String] The version of the user's device operating system.
-          #
-          #   @param user_agent [String] The user agent of the user's device. If the individual fields (os_version, devic
-
-          # The type of the user's device.
-          #
-          # @see PreludeSDK::Models::WatchSendFeedbacksParams::Feedback::Signals#device_platform
-          module DevicePlatform
-            extend PreludeSDK::Internal::Type::Enum
-
-            ANDROID = :android
-            IOS = :ios
-            IPADOS = :ipados
-            TVOS = :tvos
-            WEB = :web
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-        end
       end
     end
   end

data/lib/prelude_sdk/resources/lookup.rb

@@ -2,6 +2,8 @@
 
 module PreludeSDK
   module Resources
+    # Retrieve detailed information about a phone number including carrier data, line
+    # type, and portability status.
     class Lookup
       # Some parameter documentations has been truncated, see
       # {PreludeSDK::Models::LookupLookupParams} for more details.
@@ -22,10 +24,11 @@ module PreludeSDK
       # @see PreludeSDK::Models::LookupLookupParams
       def lookup(phone_number, params = {})
         parsed, options = PreludeSDK::LookupLookupParams.dump_request(params)
+        query = PreludeSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["v2/lookup/%1$s", phone_number],
-          query: parsed,
+          query: query,
           model: PreludeSDK::Models::LookupLookupResponse,
           options: options
         )