Account

Fetch account signals

Changed on

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.

get/v1/accounts/{account_token}/signals

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/accounts/{account_token}/signals
  • Auth
    API key in header Authorization

Path parameters

account_tokenstring uuid required

The token of the account to fetch signals for.

Response

Account Signals

avg_transaction_amountnumber nullable required

The average approved transaction amount over the entity's lifetime, in cents. Null if fewer than 5 approved transactions have been recorded.

stdev_transaction_amountnumber nullable required

The standard deviation of approved transaction amounts over the entity's lifetime, in cents. Null if fewer than 30 approved transactions have been recorded.

approved_txn_countinteger nullable required

The total number of approved transactions over the entity's lifetime.

avg_transaction_amount_7dnumber nullable required

The average approved transaction amount over the last 7 days, in cents. Null if fewer than 5 approved transactions in window.

stdev_transaction_amount_7dnumber nullable required

The standard deviation of approved transaction amounts over the last 7 days, in cents. Null if fewer than 30 approved transactions in window.

approved_txn_count_7dinteger nullable required

The number of approved transactions in the last 7 days.

avg_transaction_amount_30dnumber nullable required

The average approved transaction amount over the last 30 days, in cents. Null if fewer than 5 approved transactions in window.

stdev_transaction_amount_30dnumber nullable required

The standard deviation of approved transaction amounts over the last 30 days, in cents. Null if fewer than 30 approved transactions in window.

approved_txn_count_30dinteger nullable required

The number of approved transactions in the last 30 days.

avg_transaction_amount_90dnumber nullable required

The average approved transaction amount over the last 90 days, in cents. Null if fewer than 5 approved transactions in window.

stdev_transaction_amount_90dnumber nullable required

The standard deviation of approved transaction amounts over the last 90 days, in cents. Null if fewer than 30 approved transactions in window.

approved_txn_count_90dinteger nullable required

The number of approved transactions in the last 90 days.

is_first_transactionboolean nullable required

Whether the entity has no prior transaction history. Returns true if no history is found. Null if transaction history exists but a first transaction timestamp is unavailable.

time_since_last_transaction_daysnumber nullable required

The number of days since the last approved transaction on the entity.

three_ds_success_ratenumber nullable required

The 3DS authentication success rate for the card, as a percentage from 0.0 to 100.0. Null for account responses.

distinct_country_countinteger nullable required

The number of distinct merchant countries seen in the entity's transaction history.

distinct_mcc_countinteger nullable required

The number of distinct MCCs seen in the entity's transaction history.

seen_countriesstring[] nullable required

The set of merchant countries seen in the entity's transaction history. Clients can use this to determine whether a new transaction's country is novel (i.e. compute is_new_country).

seen_mccsstring[] nullable required

The set of MCCs seen in the entity's transaction history. Clients can use this to determine whether a new transaction's MCC is novel (i.e. compute is_new_mcc).

seen_merchantsstring[] nullable required

The set of card acceptor IDs seen in the card's approved transaction history, capped at the 1000 most recently seen. Null for account responses. Clients can use this to determine whether a new transaction's merchant is novel (i.e. compute is_new_merchant).

first_txn_atstring date-time nullable required

The timestamp of the first approved transaction for the entity, in ISO 8601 format.

last_txn_approved_atstring date-time nullable required

The timestamp of the most recent approved transaction for the entity, in ISO 8601 format.

last_cp_countrystring nullable required

The merchant country of the last card-present transaction.

last_cp_postal_codestring nullable required

The merchant postal code of the last card-present transaction.

last_cp_timestampstring date-time nullable required

The timestamp of the last card-present transaction, in ISO 8601 format.

approved_txn_amount_m2number nullable required

The Welford M2 accumulator for lifetime approved transaction amounts. Used together with avg_transaction_amount and approved_txn_count to compute the z-score of a new transaction amount (variance = M2 / (count - 1)).

approved_txn_amount_m2_7dnumber nullable required

The Welford M2 accumulator for approved transaction amounts over the last 7 days.

approved_txn_amount_m2_30dnumber nullable required

The Welford M2 accumulator for approved transaction amounts over the last 30 days.

approved_txn_amount_m2_90dnumber nullable required

The Welford M2 accumulator for approved transaction amounts over the last 90 days.

three_ds_success_countinteger nullable required

The number of successful 3DS authentications for the card. Null for account responses.

three_ds_total_countinteger nullable required

The total number of 3DS authentication attempts for the card. Null for account responses.

Changes