{
  "transaction_token": "uuid",
  "required": true,
  "description": "The unique identifier for the transaction",
  "success_response": {
    "code": 200,
    "description": "Successful response with the requested account activity"
  },
  "base_class": "INTERNALTRANSFERCARDPAYMENTEXTERNAL_PAYMENTMANAGEMENT_OPERATIONHOLD",
  "status": {
    "type": "string",
    "enum": ["PENDING", "SETTLED", "DECLINED", "REVERSED", "CANCELED", "RETURNED"],
    "required": true 
  },
  "token": {
    "type": "uuid",
    "required": true
  },
  "created": {
    "type": "date-time",
    "required": true,
    "format": "ISO 8601"
  },
  "updated": {
    "type": "date-time",
    "required": true,
    "format": "ISO 8601"
  },
  "family": {
    "type": "const",
    "enum": ["INTERNAL"],
    "description": "Financial Transaction"
  },
  "category": {
    "type": "string",
    "enum": ["ACH", "WIRE", "BALANCE_OR_FUNDING", "FEE", "REWARD", "ADJUSTMENT", "DERECOGNITION", "DISPUTE", "CARD", "EXTERNAL_ACH", "EXTERNAL_CHECK", "EXTERNAL_FEDNOW", "EXTERNAL_RTP", "EXTERNAL_TRANSFER", "EXTERNAL_WIRE", "MANAGEMENT_ADJUSTMENT", "MANAGEMENT_DISPUTE", "MANAGEMENT_FEE", "MANAGEMENT_REWARD", "MANAGEMENT_DISBURSEMENT", "HOLD", "PROGRAM_FUNDING"],
    "required": true
  },
  "result": {
    "type": "string",
    "enum": ["APPROVED", "DECLINED"],
    "required": true
  },
  "currency": {
    "type": "string",
    "required": true,
    "description": "Currency of the transaction, represented in ISO 4217 format"
  },
  "settled_amount": {
    "type": "integer",
    "required": true,
    "description": "Settled amount in cents"
  },
  "pending_amount": {
    "type": "integer",
    "required": true,
    "description": "Pending amount in cents"
  },
  "events": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "integer",
          "description": "Amount of the financial event"
        },
        "created": {
          "type": "date-time",
          "description": "Date and time when the financial event occurred. UTC time zone."
        },
        "result": {
          "type": "string",
          "enum": ["APPROVED", "DECLINED"],
          "description": "Indicates success or failure of financial event"
        },
        "token": {
          "type": "uuid",
          "description": "Globally unique identifier."
        },
        "type": {
          "type": "string",
          "enum": ["ACH_ORIGINATION_CANCELLED", "ACH_ORIGINATION_INITIATED", "ACH_ORIGINATION_PROCESSED", "ACH_ORIGINATION_RELEASED", "ACH_ORIGINATION_REJECTED", "ACH_ORIGINATION_REVIEWED", "ACH_ORIGINATION_SETTLED", "ACH_RECEIPT_PROCESSED", "ACH_RECEIPT_RELEASED", "ACH_RECEIPT_SETTLED", "ACH_RETURN_INITIATED", "ACH_RETURN_PROCESSED", "ACH_RETURN_REJECTED", "ACH_RETURN_SETTLED", "AUTHORIZATION", "AUTHORIZATION_ADVICE", "AUTHORIZATION_EXPIRY", "AUTHORIZATION_REVERSAL", "BALANCE_INQUIRY", "BILLING_ERROR", "BILLING_ERROR_REVERSAL", "CARD_TO_CARD", "CASH_BACK", "CASH_BACK_REVERSAL", "CLEARING", "COLLECTION", "CORRECTION_CREDIT", "CORRECTION_DEBIT", "CREDIT_AUTHORIZATION", "CREDIT_AUTHORIZATION_ADVICE", "CURRENCY_CONVERSION", "CURRENCY_CONVERSION_REVERSAL", "DISPUTE_WON", "EXTERNAL_ACH_CANCELED", "EXTERNAL_ACH_INITIATED", "EXTERNAL_ACH_RELEASED", "EXTERNAL_ACH_REVERSED", "EXTERNAL_ACH_SETTLED", "EXTERNAL_CHECK_CANCELED", "EXTERNAL_CHECK_INITIATED", "EXTERNAL_CHECK_RELEASED", "EXTERNAL_CHECK_REVERSED", "EXTERNAL_CHECK_SETTLED", "EXTERNAL_FEDNOW_CANCELED", "EXTERNAL_FEDNOW_INITIATED", "EXTERNAL_FEDNOW_RELEASED", "EXTERNAL_FEDNOW_REVERSED", "EXTERNAL_FEDNOW_SETTLED", "EXTERNAL_RTP_CANCELED", "EXTERNAL_RTP_INITIATED", "EXTERNAL_RTP_RELEASED", "EXTERNAL_RTP_REVERSED", "EXTERNAL_RTP_SETTLED", "EXTERNAL_TRANSFER_CANCELED", "EXTERNAL_TRANSFER_INITIATED", "EXTERNAL_TRANSFER_RELEASED", "EXTERNAL_TRANSFER_REVERSED", "EXTERNAL_TRANSFER_SETTLED", "EXTERNAL_WIRE_CANCELED", "EXTERNAL_WIRE_INITIATED", "EXTERNAL_WIRE_RELEASED", "EXTERNAL_WIRE_REVERSED", "EXTERNAL_WIRE_SETTLED", "FINANCIAL_AUTHORIZATION", "FINANCIAL_CREDIT_AUTHORIZATION", "INTEREST", "INTEREST_REVERSAL", "INTERNAL_ADJUSTMENT", "LATE_PAYMENT", "LATE_PAYMENT_REVERSAL", "LOSS_WRITE_OFF", "PROVISIONAL_CREDIT", "PROVISIONAL_CREDIT_REVERSAL", "SERVICE", "RETURN", "RETURN_REVERSAL", "TRANSFER", "TRANSFER_INSUFFICIENT_FUNDS", "RETURNED_PAYMENT", "RETURNED_PAYMENT_REVERSAL", "LITHIC_NETWORK_PAYMENT", "ANNUAL", "ANNUAL_REVERSAL", "QUARTERLY", "QUARTERLY_REVERSAL", "MONTHLY", "MONTHLY_REVERSAL", "ACCOUNT_TO_ACCOUNT"]
        },
        "descriptor": {
          "type": "string",
          "required": true
        }
      }
    }
  },
  "financial_account_token": {
    "type": "uuid",
    "required": true
  },
  "error_response": {
    "400": "Bad request",
    "401": "Unauthorized",
    "403": "Forbidden",
    "404": "Not found",
    "500": "Internal server error"
  },
  "example_request": "curl --request GET \
     --url https://sandbox.lithic.com/v1/account_activity/transaction_token \
     --header 'accept: application/json'",
  "example_response": {
    "status": "PENDING",
    "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "created": "2026-07-18T00:25:34.903Z",
    "updated": "2026-07-18T00:25:34.903Z",
    "family": "string",
    "category": "ACH",
    "result": "APPROVED",
    "currency": "USD",
    "settled_amount": 200,
    "pending_amount": 500,
    "events": [
      {
        "amount": 0,
        "created": "2026-07-18T00:25:34.903Z",
        "result": "APPROVED",
        "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "type": "ACH_ORIGINATION_CANCELLED"
      }
    ],
    "descriptor": "string",
    "financial_account_token": "0cc87075-57cf-4607-8722-f42e2cb2c0cd"
  }
}