Transaction Token

Definition

• transaction_token (uuid, required): The token of the transaction that the enhanced data is associated with.

Response Structure

200 - Fraud report for the specified transaction.

• transaction_token (uuid, required): The universally unique identifier (UUID) associated with the transaction being reported.
• fraud_status (string, enum, required): The fraud status of the transaction, 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.
  • NOT_FRAUDULENT: The transaction is marked as not fraudulent.
  • NO_REPORTED_FRAUD: Indicates that no fraud report exists for the transaction.
• fraud_type (string, enum): Specifies the type or category of fraud, supporting:
  • FIRST_PARTY_FRAUD
  • ACCOUNT_TAKEOVER
  • CARD_COMPROMISED
  • IDENTITY_THEFT
  • CARDHOLDER_MANIPULATION
• comment (string): Provides additional context about the fraud report.
• created_at (date-time): Timestamp of when the fraud report was created.
• updated_at (date-time): Timestamp of the last update to the fraud report.

Error Responses

400 - Bad Request

• A parameter in the query does not match the valid queries for the endpoint.

401 - Unauthorized

• User has not been authenticated, invalid or missing API key, etc.

404 - Not Found

• The specified resource was not found.

422 - Unprocessable Entity

429 - Too Many Requests

• Client has exceeded the number of allowed requests in a given time period.

Example Request

curl --request GET \
     --url https://sandbox.lithic.com/v1/fraud/transactions/transaction_token \
     --header 'accept: application/json'

Example Response

{
  "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fraud_status": "SUSPECTED_FRAUD",
  "fraud_type": "FIRST_PARTY_FRAUD",
  "comment": "string",
  "created_at": "2026-07-18T00:25:39.405Z",
  "updated_at": "2026-07-18T00:25:39.405Z"
}