lithic 0.13.0 → 0.14.0

data/rbi/lithic/resources/accounts.rbi

@@ -123,6 +123,27 @@ module Lithic
       )
       end
 
+      # Returns behavioral feature state derived from an account's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: ACCOUNT`, `IS_NEW_COUNTRY` with `scope: ACCOUNT`)
+      # and custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to
+      # inspect feature values before writing rules and debug rule behavior.
+      #
+      # Note: 3DS fields are not available at the account scope and will be null.
+      sig do
+        params(
+          account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::SignalsResponse)
+      end
+      def retrieve_signals(
+        # The token of the account to fetch signals for.
+        account_token,
+        request_options: {}
+      )
+      end
+
       # Get an Account's available spend limits, which is based on the spend limit
       # configured on the Account and the amount already spent over the spend limit's
       # duration. For example, if the Account has a daily spend limit of $1000

data/rbi/lithic/resources/cards.rbi

@@ -590,6 +590,25 @@ module Lithic
       )
       end
 
+      # Returns behavioral feature state derived from a card's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: CARD`, `IS_NEW_COUNTRY` with `scope: CARD`) and
+      # custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to inspect
+      # feature values before writing rules and debug rule behavior.
+      sig do
+        params(
+          card_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::SignalsResponse)
+      end
+      def retrieve_signals(
+        # The token of the card to fetch signals for.
+        card_token,
+        request_options: {}
+      )
+      end
+
       # Get a Card's available spend limit, which is based on the spend limit configured
       # on the Card and the amount already spent over the spend limit's duration. For
       # example, if the Card has a monthly spend limit of $1000 configured, and has

data/sig/lithic/models/account_retrieve_signals_params.rbs

@@ -0,0 +1,23 @@
+module Lithic
+  module Models
+    type account_retrieve_signals_params =
+      { account_token: String } & Lithic::Internal::Type::request_parameters
+
+    class AccountRetrieveSignalsParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      attr_accessor account_token: String
+
+      def initialize: (
+        account_token: String,
+        ?request_options: Lithic::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        account_token: String,
+        request_options: Lithic::RequestOptions
+      }
+    end
+  end
+end

data/sig/lithic/models/auth_rules/conditional_authorization_action_parameters.rbs

@@ -106,6 +106,8 @@ module Lithic
             | :DISTINCT_COUNTRY_COUNT
             | :IS_NEW_MERCHANT
             | :THREE_DS_SUCCESS_RATE
+            | :TRAVEL_SPEED
+            | :DISTANCE_FROM_LAST_TRANSACTION
 
           module Attribute
             extend Lithic::Internal::Type::Enum
@@ -147,6 +149,8 @@ module Lithic
             DISTINCT_COUNTRY_COUNT: :DISTINCT_COUNTRY_COUNT
             IS_NEW_MERCHANT: :IS_NEW_MERCHANT
             THREE_DS_SUCCESS_RATE: :THREE_DS_SUCCESS_RATE
+            TRAVEL_SPEED: :TRAVEL_SPEED
+            DISTANCE_FROM_LAST_TRANSACTION: :DISTANCE_FROM_LAST_TRANSACTION
 
             def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::attribute]
           end
@@ -154,7 +158,8 @@ module Lithic
           type parameters =
             {
               interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             }
 
           class Parameters < Lithic::Internal::Type::BaseModel
@@ -170,14 +175,22 @@ module Lithic
               Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
             ) -> Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
 
+            attr_reader unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit?
+
+            def unit=: (
+              Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
+            ) -> Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
+
             def initialize: (
               ?interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              ?scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              ?scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              ?unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             ) -> void
 
             def to_hash: -> {
               interval: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::interval,
-              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope
+              scope: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope,
+              unit: Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit
             }
 
             type interval = :LIFETIME | :"7D" | :"30D" | :"90D"
@@ -204,6 +217,19 @@ module Lithic
 
               def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::scope]
             end
+
+            type unit = :MPH | :KPH | :MILES | :KILOMETERS
+
+            module Unit
+              extend Lithic::Internal::Type::Enum
+
+              MPH: :MPH
+              KPH: :KPH
+              MILES: :MILES
+              KILOMETERS: :KILOMETERS
+
+              def self?.values: -> ::Array[Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::unit]
+            end
           end
         end
       end

data/sig/lithic/models/card_retrieve_signals_params.rbs

@@ -0,0 +1,23 @@
+module Lithic
+  module Models
+    type card_retrieve_signals_params =
+      { card_token: String } & Lithic::Internal::Type::request_parameters
+
+    class CardRetrieveSignalsParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      attr_accessor card_token: String
+
+      def initialize: (
+        card_token: String,
+        ?request_options: Lithic::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        card_token: String,
+        request_options: Lithic::RequestOptions
+      }
+    end
+  end
+end

data/sig/lithic/models/signals_response.rbs

@@ -0,0 +1,170 @@
+module Lithic
+  module Models
+    type signals_response =
+      {
+        :approved_txn_amount_m2 => Float?,
+        :approved_txn_amount_m2_30d => Float?,
+        :approved_txn_amount_m2_7d => Float?,
+        :approved_txn_amount_m2_90d => Float?,
+        approved_txn_count: Integer?,
+        :approved_txn_count_30d => Integer?,
+        :approved_txn_count_7d => Integer?,
+        :approved_txn_count_90d => Integer?,
+        avg_transaction_amount: Float?,
+        :avg_transaction_amount_30d => Float?,
+        :avg_transaction_amount_7d => Float?,
+        :avg_transaction_amount_90d => Float?,
+        distinct_country_count: Integer?,
+        distinct_mcc_count: Integer?,
+        first_txn_at: Time?,
+        is_first_transaction: bool?,
+        last_cp_country: String?,
+        last_cp_postal_code: String?,
+        last_cp_timestamp: Time?,
+        last_txn_approved_at: Time?,
+        seen_countries: ::Array[String]?,
+        seen_mccs: ::Array[String]?,
+        seen_merchants: ::Array[String]?,
+        stdev_transaction_amount: Float?,
+        :stdev_transaction_amount_30d => Float?,
+        :stdev_transaction_amount_7d => Float?,
+        :stdev_transaction_amount_90d => Float?,
+        three_ds_success_count: Integer?,
+        three_ds_success_rate: Float?,
+        three_ds_total_count: Integer?,
+        time_since_last_transaction_days: Float?
+      }
+
+    class SignalsResponse < Lithic::Internal::Type::BaseModel
+      attr_accessor approved_txn_amount_m2: Float?
+
+      attr_accessor approved_txn_amount_m2_30d: Float?
+
+      attr_accessor approved_txn_amount_m2_7d: Float?
+
+      attr_accessor approved_txn_amount_m2_90d: Float?
+
+      attr_accessor approved_txn_count: Integer?
+
+      attr_accessor approved_txn_count_30d: Integer?
+
+      attr_accessor approved_txn_count_7d: Integer?
+
+      attr_accessor approved_txn_count_90d: Integer?
+
+      attr_accessor avg_transaction_amount: Float?
+
+      attr_accessor avg_transaction_amount_30d: Float?
+
+      attr_accessor avg_transaction_amount_7d: Float?
+
+      attr_accessor avg_transaction_amount_90d: Float?
+
+      attr_accessor distinct_country_count: Integer?
+
+      attr_accessor distinct_mcc_count: Integer?
+
+      attr_accessor first_txn_at: Time?
+
+      attr_accessor is_first_transaction: bool?
+
+      attr_accessor last_cp_country: String?
+
+      attr_accessor last_cp_postal_code: String?
+
+      attr_accessor last_cp_timestamp: Time?
+
+      attr_accessor last_txn_approved_at: Time?
+
+      attr_accessor seen_countries: ::Array[String]?
+
+      attr_accessor seen_mccs: ::Array[String]?
+
+      attr_accessor seen_merchants: ::Array[String]?
+
+      attr_accessor stdev_transaction_amount: Float?
+
+      attr_accessor stdev_transaction_amount_30d: Float?
+
+      attr_accessor stdev_transaction_amount_7d: Float?
+
+      attr_accessor stdev_transaction_amount_90d: Float?
+
+      attr_accessor three_ds_success_count: Integer?
+
+      attr_accessor three_ds_success_rate: Float?
+
+      attr_accessor three_ds_total_count: Integer?
+
+      attr_accessor time_since_last_transaction_days: Float?
+
+      def initialize: (
+        approved_txn_amount_m2: Float?,
+        approved_txn_amount_m2_30d: Float?,
+        approved_txn_amount_m2_7d: Float?,
+        approved_txn_amount_m2_90d: Float?,
+        approved_txn_count: Integer?,
+        approved_txn_count_30d: Integer?,
+        approved_txn_count_7d: Integer?,
+        approved_txn_count_90d: Integer?,
+        avg_transaction_amount: Float?,
+        avg_transaction_amount_30d: Float?,
+        avg_transaction_amount_7d: Float?,
+        avg_transaction_amount_90d: Float?,
+        distinct_country_count: Integer?,
+        distinct_mcc_count: Integer?,
+        first_txn_at: Time?,
+        is_first_transaction: bool?,
+        last_cp_country: String?,
+        last_cp_postal_code: String?,
+        last_cp_timestamp: Time?,
+        last_txn_approved_at: Time?,
+        seen_countries: ::Array[String]?,
+        seen_mccs: ::Array[String]?,
+        seen_merchants: ::Array[String]?,
+        stdev_transaction_amount: Float?,
+        stdev_transaction_amount_30d: Float?,
+        stdev_transaction_amount_7d: Float?,
+        stdev_transaction_amount_90d: Float?,
+        three_ds_success_count: Integer?,
+        three_ds_success_rate: Float?,
+        three_ds_total_count: Integer?,
+        time_since_last_transaction_days: Float?
+      ) -> void
+
+      def to_hash: -> {
+        :approved_txn_amount_m2 => Float?,
+        :approved_txn_amount_m2_30d => Float?,
+        :approved_txn_amount_m2_7d => Float?,
+        :approved_txn_amount_m2_90d => Float?,
+        approved_txn_count: Integer?,
+        :approved_txn_count_30d => Integer?,
+        :approved_txn_count_7d => Integer?,
+        :approved_txn_count_90d => Integer?,
+        avg_transaction_amount: Float?,
+        :avg_transaction_amount_30d => Float?,
+        :avg_transaction_amount_7d => Float?,
+        :avg_transaction_amount_90d => Float?,
+        distinct_country_count: Integer?,
+        distinct_mcc_count: Integer?,
+        first_txn_at: Time?,
+        is_first_transaction: bool?,
+        last_cp_country: String?,
+        last_cp_postal_code: String?,
+        last_cp_timestamp: Time?,
+        last_txn_approved_at: Time?,
+        seen_countries: ::Array[String]?,
+        seen_mccs: ::Array[String]?,
+        seen_merchants: ::Array[String]?,
+        stdev_transaction_amount: Float?,
+        :stdev_transaction_amount_30d => Float?,
+        :stdev_transaction_amount_7d => Float?,
+        :stdev_transaction_amount_90d => Float?,
+        three_ds_success_count: Integer?,
+        three_ds_success_rate: Float?,
+        three_ds_total_count: Integer?,
+        time_since_last_transaction_days: Float?
+      }
+    end
+  end
+end

data/sig/lithic/models.rbs

@@ -41,6 +41,8 @@ module Lithic
 
   class AccountRetrieveParams = Lithic::Models::AccountRetrieveParams
 
+  class AccountRetrieveSignalsParams = Lithic::Models::AccountRetrieveSignalsParams
+
   class AccountRetrieveSpendLimitsParams = Lithic::Models::AccountRetrieveSpendLimitsParams
 
   class AccountSpendLimits = Lithic::Models::AccountSpendLimits
@@ -133,6 +135,8 @@ module Lithic
 
   class CardRetrieveParams = Lithic::Models::CardRetrieveParams
 
+  class CardRetrieveSignalsParams = Lithic::Models::CardRetrieveSignalsParams
+
   class CardRetrieveSpendLimitsParams = Lithic::Models::CardRetrieveSpendLimitsParams
 
   module Cards = Lithic::Models::Cards
@@ -437,6 +441,8 @@ module Lithic
 
   class ShippingAddress = Lithic::Models::ShippingAddress
 
+  class SignalsResponse = Lithic::Models::SignalsResponse
+
   module SpendLimitDuration = Lithic::Models::SpendLimitDuration
 
   class StatementsCreatedWebhookEvent = Lithic::Models::StatementsCreatedWebhookEvent

data/sig/lithic/resources/accounts.rbs

@@ -27,6 +27,11 @@ module Lithic
         ?request_options: Lithic::request_opts
       ) -> Lithic::Internal::CursorPage[Lithic::Account]
 
+      def retrieve_signals: (
+        String account_token,
+        ?request_options: Lithic::request_opts
+      ) -> Lithic::SignalsResponse
+
       def retrieve_spend_limits: (
         String account_token,
         ?request_options: Lithic::request_opts

data/sig/lithic/resources/cards.rbs

@@ -108,6 +108,11 @@ module Lithic
         ?request_options: Lithic::request_opts
       ) -> Lithic::Card
 
+      def retrieve_signals: (
+        String card_token,
+        ?request_options: Lithic::request_opts
+      ) -> Lithic::SignalsResponse
+
       def retrieve_spend_limits: (
         String card_token,
         ?request_options: Lithic::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lithic
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Lithic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -101,6 +101,7 @@ files:
 - lib/lithic/models/account_holders/entity_delete_params.rb
 - lib/lithic/models/account_list_params.rb
 - lib/lithic/models/account_retrieve_params.rb
+- lib/lithic/models/account_retrieve_signals_params.rb
 - lib/lithic/models/account_retrieve_spend_limits_params.rb
 - lib/lithic/models/account_spend_limits.rb
 - lib/lithic/models/account_update_params.rb
@@ -189,6 +190,7 @@ files:
 - lib/lithic/models/card_renew_params.rb
 - lib/lithic/models/card_renewed_webhook_event.rb
 - lib/lithic/models/card_retrieve_params.rb
+- lib/lithic/models/card_retrieve_signals_params.rb
 - lib/lithic/models/card_retrieve_spend_limits_params.rb
 - lib/lithic/models/card_search_by_pan_params.rb
 - lib/lithic/models/card_shipped_webhook_event.rb
@@ -406,6 +408,7 @@ files:
 - lib/lithic/models/settlement_report_updated_webhook_event.rb
 - lib/lithic/models/settlement_summary_details.rb
 - lib/lithic/models/shipping_address.rb
+- lib/lithic/models/signals_response.rb
 - lib/lithic/models/spend_limit_duration.rb
 - lib/lithic/models/statement_totals.rb
 - lib/lithic/models/statements_created_webhook_event.rb
@@ -592,6 +595,7 @@ files:
 - rbi/lithic/models/account_holders/entity_delete_params.rbi
 - rbi/lithic/models/account_list_params.rbi
 - rbi/lithic/models/account_retrieve_params.rbi
+- rbi/lithic/models/account_retrieve_signals_params.rbi
 - rbi/lithic/models/account_retrieve_spend_limits_params.rbi
 - rbi/lithic/models/account_spend_limits.rbi
 - rbi/lithic/models/account_update_params.rbi
@@ -680,6 +684,7 @@ files:
 - rbi/lithic/models/card_renew_params.rbi
 - rbi/lithic/models/card_renewed_webhook_event.rbi
 - rbi/lithic/models/card_retrieve_params.rbi
+- rbi/lithic/models/card_retrieve_signals_params.rbi
 - rbi/lithic/models/card_retrieve_spend_limits_params.rbi
 - rbi/lithic/models/card_search_by_pan_params.rbi
 - rbi/lithic/models/card_shipped_webhook_event.rbi
@@ -897,6 +902,7 @@ files:
 - rbi/lithic/models/settlement_report_updated_webhook_event.rbi
 - rbi/lithic/models/settlement_summary_details.rbi
 - rbi/lithic/models/shipping_address.rbi
+- rbi/lithic/models/signals_response.rbi
 - rbi/lithic/models/spend_limit_duration.rbi
 - rbi/lithic/models/statement_totals.rbi
 - rbi/lithic/models/statements_created_webhook_event.rbi
@@ -1082,6 +1088,7 @@ files:
 - sig/lithic/models/account_holders/entity_delete_params.rbs
 - sig/lithic/models/account_list_params.rbs
 - sig/lithic/models/account_retrieve_params.rbs
+- sig/lithic/models/account_retrieve_signals_params.rbs
 - sig/lithic/models/account_retrieve_spend_limits_params.rbs
 - sig/lithic/models/account_spend_limits.rbs
 - sig/lithic/models/account_update_params.rbs
@@ -1170,6 +1177,7 @@ files:
 - sig/lithic/models/card_renew_params.rbs
 - sig/lithic/models/card_renewed_webhook_event.rbs
 - sig/lithic/models/card_retrieve_params.rbs
+- sig/lithic/models/card_retrieve_signals_params.rbs
 - sig/lithic/models/card_retrieve_spend_limits_params.rbs
 - sig/lithic/models/card_search_by_pan_params.rbs
 - sig/lithic/models/card_shipped_webhook_event.rbs
@@ -1387,6 +1395,7 @@ files:
 - sig/lithic/models/settlement_report_updated_webhook_event.rbs
 - sig/lithic/models/settlement_summary_details.rbs
 - sig/lithic/models/shipping_address.rbs
+- sig/lithic/models/signals_response.rbs
 - sig/lithic/models/spend_limit_duration.rbs
 - sig/lithic/models/statement_totals.rbs
 - sig/lithic/models/statements_created_webhook_event.rbs