Fraud Report

Get a fraud report for a transaction

Changed on

Retrieve a fraud report for a specific transaction identified by its unique transaction token.

get/v1/fraud/transactions/{transaction_token}

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/fraud/transactions/{transaction_token}
  • Auth
    API key in header Authorization

Path parameters

transaction_tokenstring uuid required

The token of the transaction that the enhanced data is associated with.

Response

Fraud report for the specified transaction.

transaction_tokenstring uuid required

The universally unique identifier (UUID) associated with the transaction being reported.

fraud_status'SUSPECTED_FRAUD' | 'FRAUDULENT' | 'NOT_FRAUDULENT' | 'NO_REPORTED_FRAUD' required

The fraud status of the transaction, string (enum) supporting the following values:

  • SUSPECTED_FRAUD: The transaction is suspected to be fraudulent, but this hasn’t been confirmed.
  • FRAUDULENT: The transaction is confirmed to be fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.
  • NOT_FRAUDULENT: The transaction is (explicitly) marked as not fraudulent. A transaction may immediately be moved into this state, or be graduated into this state from the SUSPECTED_FRAUD state.
  • NO_REPORTED_FRAUD: Indicates that no fraud report exists for the transaction. It is the default state for transactions that have not been analyzed or associated with any known fraudulent activity.
fraud_type'FIRST_PARTY_FRAUD' | 'ACCOUNT_TAKEOVER' | 'CARD_COMPROMISED' | 'IDENTITY_THEFT' | 'CARDHOLDER_MANIPULATION' nullable

Specifies the type or category of fraud that the transaction is suspected or confirmed to involve, string (enum) supporting the following values:

  • FIRST_PARTY_FRAUD: First-party fraud occurs when a legitimate account or cardholder intentionally misuses financial services for personal gain. This includes actions such as disputing legitimate transactions to obtain a refund, abusing return policies, or defaulting on credit obligations without intent to repay.
  • ACCOUNT_TAKEOVER: Account takeover fraud occurs when a fraudster gains unauthorized access to an existing account, modifies account settings, and carries out fraudulent transactions.
  • CARD_COMPROMISED: Card compromised fraud occurs when a fraudster gains access to card details without taking over the account, such as through physical card theft, cloning, or online data breaches.
  • IDENTITY_THEFT: Identity theft fraud occurs when a fraudster uses stolen personal information, such as Social Security numbers or addresses, to open accounts, apply for loans, or conduct financial transactions in someone's name.
  • CARDHOLDER_MANIPULATION: This type of fraud occurs when a fraudster manipulates or coerces a legitimate cardholder into unauthorized transactions, often through social engineering tactics.
commentstring nullable

Provides additional context or details about the fraud report.

created_atstring date-time nullable

Timestamp representing when the fraud report was created.

updated_atstring date-time nullable

Timestamp representing the last update to the fraud report.

Changes

  • 7732c7d99b3eRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status