--- title: "List Account Activity" method: GET path: "/v1/account_activity" tags: ["Financial Account"] --- # List Account Activity `GET /v1/account_activity` Retrieve a list of transactions across all public accounts. ## Query parameters - `status` 'DECLINED' | 'EXPIRED' | 'PENDING' | 'RETURNED' | 'REVERSED' | 'SETTLED' | 'VOIDED' - `result` 'APPROVED' | 'DECLINED' - `financial_account_token` string, uuid - `business_account_token` string, uuid - `account_token` string, uuid - `category` 'ACH' | 'WIRE' | 'STABLECOIN' | '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' | 'PROGRAM_TRANSFER' — Note: Inbound wire transfers are coming soon (availability varies by partner bank). The WIRE category is a preview. To learn more, contact your customer success manager. - `begin` string, date-time - `ending_before` string - `end` string, date-time - `page_size` integer - `starting_after` string ## Response `200` Successful response with unified transaction data - BaseTransactionsResponse — A response containing a list of transactions - `has_more` boolean, required — Indicates if there are more transactions available for pagination - `data` BaseTransactionResponse[], required - union — Response containing multiple transaction types. The `family` field determines which transaction type is returned: INTERNAL returns FinancialTransaction, TRANSFER returns BookTransferTransaction, CARD returns CardTransaction, PAYMENT returns PaymentTransaction, EXTERNAL_PAYMENT returns ExternalPaymentResponse, MANAGEMENT_OPERATION returns ManagementOperationTransaction, and HOLD returns HoldTransaction - FinancialTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'INTERNAL', required — INTERNAL - Financial Transaction - `category` 'ACH' | 'WIRE' | 'STABLECOIN' | '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' | 'PROGRAM_TRANSFER', required — Note: Inbound wire transfers are coming soon (availability varies by partner bank). The WIRE category is a preview. To learn more, contact your customer success manager. - `result` 'APPROVED' | 'DECLINED', required - `currency` string, required — Currency of the transaction, represented in ISO 4217 format - `settled_amount` integer, required — Settled amount in cents - `pending_amount` integer, required — Pending amount in cents - `events` FinancialEvent[], required — List of transaction events - `amount` integer — Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents). - `created` string, date-time — Date and time when the financial event occurred. UTC time zone. - `result` 'APPROVED' | 'DECLINED' — APPROVED financial events were successful while DECLINED financial events were declined by user, Lithic, or the network. - `token` string, uuid — Globally unique identifier. - `type` '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' | 'LITHIC_PROGRAM_TRANSFER' | 'BANK_PROGRAM_TRANSFER' | 'ANNUAL' | 'ANNUAL_REVERSAL' | 'QUARTERLY' | 'QUARTERLY_REVERSAL' | 'MONTHLY' | 'MONTHLY_REVERSAL' | 'ACCOUNT_TO_ACCOUNT' | 'STABLECOIN_RECEIVED' | 'STABLECOIN_REVIEWED' | 'STABLECOIN_SETTLED' - `descriptor` string, required — Transaction descriptor - `financial_account_token` string, uuid, required — Financial account token associated with the transaction - BookTransferTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'TRANSFER', required — TRANSFER - Book Transfer Transaction - `result` 'APPROVED' | 'DECLINED', required - `category` 'ADJUSTMENT' | 'BALANCE_OR_FUNDING' | 'DERECOGNITION' | 'DISPUTE' | 'FEE' | 'INTERNAL' | 'REWARD' | 'PROGRAM_FUNDING' | 'PROGRAM_TRANSFER' | 'TRANSFER', required - `currency` string, required — 3-character alphabetic ISO 4217 code for the settling currency of the transaction - `settled_amount` integer, required — Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents) - `pending_amount` integer, required — Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees. The value of this field will go to zero over time once the financial transaction is settled. - `events` BookTransferEvent[], required — A list of all financial events that have modified this transfer - `amount` integer, required — Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents). - `type` 'ATM_BALANCE_INQUIRY' | 'ATM_WITHDRAWAL' | 'ATM_DECLINE' | 'INTERNATIONAL_ATM_WITHDRAWAL' | 'INACTIVITY' | 'STATEMENT' | 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'CUSTOMER_SERVICE' | 'ACCOUNT_MAINTENANCE' | 'ACCOUNT_ACTIVATION' | 'ACCOUNT_CLOSURE' | 'CARD_REPLACEMENT' | 'CARD_DELIVERY' | 'CARD_CREATE' | 'CURRENCY_CONVERSION' | 'INTEREST' | 'LATE_PAYMENT' | 'BILL_PAYMENT' | 'PAYMENT_FEE' | 'CASH_BACK' | 'ACCOUNT_TO_ACCOUNT' | 'CARD_TO_CARD' | 'DISBURSE' | 'BILLING_ERROR' | 'LOSS_WRITE_OFF' | 'EXPIRED_CARD' | 'EARLY_DERECOGNITION' | 'ESCHEATMENT' | 'INACTIVITY_FEE_DOWN' | 'PROVISIONAL_CREDIT' | 'DISPUTE_WON' | 'SERVICE' | 'TRANSFER' | 'COLLECTION' | 'LITHIC_PROGRAM_TRANSFER' | 'BANK_PROGRAM_TRANSFER', required — Type of the book transfer - `result` 'APPROVED' | 'DECLINED', required — APPROVED financial events were successful while DECLINED financial events were declined by user, Lithic, or the network. - `created` string, date-time, required — Date and time when the financial event occurred. UTC time zone. - `token` string, uuid, required — Globally unique identifier. - `subtype` string, required — The program specific subtype code for the specified category/type. - `memo` string, required — Memo for the transfer. - `detailed_results` BookTransferDetailedResults[], required - `from_financial_account_token` string, uuid, required — Globally unique identifier for the financial account or card that will send the funds. Accepted type dependent on the program's use case - `to_financial_account_token` string, uuid, required — Globally unique identifier for the financial account or card that will receive the funds. Accepted type dependent on the program's use case - `external_id` string, nullable — External ID defined by the customer - `transaction_series` TransactionSeries - `type` string, required - `related_transaction_token` string, uuid, nullable, required - `related_transaction_event_token` string, uuid, nullable, required - `external_resource` ExternalResource — External resource associated with the management operation - `external_resource_type` 'STATEMENT' | 'COLLECTION' | 'DISPUTE' | 'UNKNOWN', required — Type of external resource associated with the management operation - `external_resource_token` string, required — Token identifying the external resource - `external_resource_sub_token` string — Token identifying the external resource sub-resource - CardTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED', required — Status of the transaction. - `token` string, uuid, required — Globally unique identifier. - `created` string, date-time, required — Date and time when the transaction first occurred. UTC time zone. - `updated` string, date-time, required — Date and time when the transaction last updated. UTC time zone. - `acquirer_fee` integer, nullable, required — Fee assessed by the merchant and paid for by the cardholder in the smallest unit of the currency. Will be zero if no fee is assessed. Rebates may be transmitted as a negative value to indicate credited fees. - `acquirer_reference_number` string, nullable, required — Unique identifier assigned to a transaction by the acquirer that can be used in dispute and chargeback filing. This field has been deprecated in favor of the `acquirer_reference_number` that resides in the event-level `network_info`. - `account_token` string, uuid, required — The token for the account associated with this transaction. - `amount` integer, required — When the transaction is pending, this represents the authorization amount of the transaction in the anticipated settlement currency. Once the transaction has settled, this field represents the settled amount in the settlement currency. - `amounts` TransactionAmounts, required - `cardholder` object, required - `amount` integer, required — The estimated settled amount of the transaction in the cardholder billing currency. - `conversion_rate` string, required — The exchange rate used to convert the merchant amount to the cardholder billing amount. - `currency` string, required — 3-character alphabetic ISO 4217 currency - `hold` object, required - `amount` integer, required — The pending amount of the transaction in the anticipated settlement currency. - `currency` string, required — 3-character alphabetic ISO 4217 currency - `merchant` object, required - `amount` integer, required — The settled amount of the transaction in the merchant currency. - `currency` string, required — 3-character alphabetic ISO 4217 currency - `settlement` object, required - `amount` integer, required — The settled amount of the transaction in the settlement currency. - `currency` string, required — 3-character alphabetic ISO 4217 currency - `authorization_amount` integer, nullable, required — The authorization amount of the transaction in the anticipated settlement currency. - `authorization_code` string, nullable, required — A fixed-width 6-digit numeric identifier that can be used to identify a transaction with networks. - `avs` Avs, required - `address` string, required — Cardholder address - `zipcode` string, required — Cardholder ZIP code - `card_token` string, uuid, required — Token for the card used in this transaction. - `cardholder_authentication` CardholderAuthentication, required - `authentication_result` 'ATTEMPTS' | 'DECLINE' | 'NONE' | 'SUCCESS', required — Indicates the outcome of the 3DS authentication process. - `authentication_method` 'FRICTIONLESS' | 'CHALLENGE' | 'NONE', required — Indicates the method used to authenticate the cardholder. - `decision_made_by` 'CUSTOMER_RULES' | 'CUSTOMER_ENDPOINT' | 'LITHIC_DEFAULT' | 'LITHIC_RULES' | 'NETWORK' | 'UNKNOWN', required — Indicates which party made the 3DS authentication decision. - `liability_shift` '3DS_AUTHENTICATED' | 'TOKEN_AUTHENTICATED' | 'NONE', required — Indicates whether chargeback liability shift applies to the transaction. Possible enum values: * `3DS_AUTHENTICATED`: The transaction was fully authenticated through a 3-D Secure flow, chargeback liability shift applies. * `NONE`: Chargeback liability shift has not shifted to the issuer, i.e. the merchant is liable. * `TOKEN_AUTHENTICATED`: The transaction was a tokenized payment with validated cryptography, possibly recurring. Chargeback liability shift to the issuer applies. - `three_ds_authentication_token` string, uuid, nullable, required — Unique identifier you can use to match a given 3DS authentication (available via the three_ds_authentication.created event webhook) and the transaction. Note that in cases where liability shift does not occur, this token is matched to the transaction on a best-effort basis. - `events` TransactionEvent[] - `account_type` 'CHECKING' | 'SAVINGS' - `amount` integer, required — Amount of the event in the settlement currency. - `amounts` TransactionEventAmounts, required - `cardholder` object, required - … - `merchant` object, required - … - `settlement` object, nullable, required - … - `created` string, date-time, required — RFC 3339 date and time this event entered the system. UTC time zone. - `network_info` NetworkInfo, nullable, required — Information provided by the card network in each event. This includes common identifiers shared between you, Lithic, the card network and in some cases the acquirer. These identifiers often link together events within the same transaction lifecycle and can be used to locate a particular transaction, such as during processing of disputes. Not all fields are available in all events, and the presence of these fields is dependent on the card network and the event type. If the field is populated by the network, we will pass it through as is unless otherwise specified. Please consult the official network documentation for more details about these fields and how to use them. - `acquirer` object, nullable, required - … - `amex` object, nullable, required - … - `mastercard` object, nullable, required - … - `visa` object, nullable, required - … - `network_specific_data` NetworkSpecificData - `mastercard` MastercardNetworkSpecificData, required - … - `visa` VisaNetworkSpecificData, required - … - `detailed_results` DetailedResult[], required - `rule_results` RuleResult[], required - `auth_rule_token` string, uuid, nullable, required — The Auth Rule Token associated with the rule from which the decline originated. If this is set to null, then the decline was not associated with a customer-configured Auth Rule. This may happen in cases where a transaction is declined due to a Lithic-configured security or compliance rule, for example. - `result` 'ACCOUNT_DAILY_SPEND_LIMIT_EXCEEDED' | 'ACCOUNT_DELINQUENT' | 'ACCOUNT_INACTIVE' | 'ACCOUNT_LIFETIME_SPEND_LIMIT_EXCEEDED' | 'ACCOUNT_MONTHLY_SPEND_LIMIT_EXCEEDED' | 'ACCOUNT_PAUSED' | 'ACCOUNT_UNDER_REVIEW' | 'ADDRESS_INCORRECT' | 'APPROVED' | 'AUTH_RULE_ALLOWED_COUNTRY' | 'AUTH_RULE_ALLOWED_MCC' | 'AUTH_RULE_BLOCKED_COUNTRY' | 'AUTH_RULE_BLOCKED_MCC' | 'AUTH_RULE' | 'CARD_CLOSED' | 'CARD_CRYPTOGRAM_VALIDATION_FAILURE' | 'CARD_EXPIRED' | 'CARD_EXPIRY_DATE_INCORRECT' | 'CARD_INVALID' | 'CARD_NOT_ACTIVATED' | 'CARD_PAUSED' | 'CARD_PIN_INCORRECT' | 'CARD_RESTRICTED' | 'CARD_SECURITY_CODE_INCORRECT' | 'CARD_SPEND_LIMIT_EXCEEDED' | 'CONTACT_CARD_ISSUER' | 'CUSTOMER_ASA_TIMEOUT' | 'CUSTOM_ASA_RESULT' | 'DECLINED' | 'DO_NOT_HONOR' | 'DRIVER_NUMBER_INVALID' | 'FORMAT_ERROR' | 'INSUFFICIENT_FUNDING_SOURCE_BALANCE' | 'INSUFFICIENT_FUNDS' | 'LITHIC_SYSTEM_ERROR' | 'LITHIC_SYSTEM_RATE_LIMIT' | 'MALFORMED_ASA_RESPONSE' | 'MERCHANT_INVALID' | 'MERCHANT_LOCKED_CARD_ATTEMPTED_ELSEWHERE' | 'MERCHANT_NOT_PERMITTED' | 'OVER_REVERSAL_ATTEMPTED' | 'PIN_BLOCKED' | 'PROGRAM_CARD_SPEND_LIMIT_EXCEEDED' | 'PROGRAM_SUSPENDED' | 'PROGRAM_USAGE_RESTRICTION' | 'REVERSAL_UNMATCHED' | 'SECURITY_VIOLATION' | 'SINGLE_USE_CARD_REATTEMPTED' | 'SUSPECTED_FRAUD' | 'TRANSACTION_INVALID' | 'TRANSACTION_NOT_PERMITTED_TO_ACQUIRER_OR_TERMINAL' | 'TRANSACTION_NOT_PERMITTED_TO_ISSUER_OR_CARDHOLDER' | 'TRANSACTION_PREVIOUSLY_COMPLETED' | 'UNAUTHORIZED_MERCHANT' | 'VEHICLE_NUMBER_INVALID' | 'CARDHOLDER_CHALLENGED' | 'CARDHOLDER_CHALLENGE_FAILED', required - `name` string, nullable, required — The name for the rule, if any was configured. - `explanation` string, nullable, required — A human-readable explanation outlining the motivation for the rule's decline. - `effective_polarity` 'CREDIT' | 'DEBIT', required — Indicates whether the transaction event is a credit or debit to the account. - `result` 'ACCOUNT_PAUSED' | 'ACCOUNT_STATE_TRANSACTION_FAIL' | 'APPROVED' | 'BANK_CONNECTION_ERROR' | 'BANK_NOT_VERIFIED' | 'CARD_CLOSED' | 'CARD_PAUSED' | 'DECLINED' | 'FRAUD_ADVICE' | 'IGNORED_TTL_EXPIRY' | 'SUSPECTED_FRAUD' | 'INACTIVE_ACCOUNT' | 'INCORRECT_PIN' | 'INVALID_CARD_DETAILS' | 'INSUFFICIENT_FUNDS' | 'INSUFFICIENT_FUNDS_PRELOAD' | 'INVALID_TRANSACTION' | 'MERCHANT_BLACKLIST' | 'ORIGINAL_NOT_FOUND' | 'PREVIOUSLY_COMPLETED' | 'SINGLE_USE_RECHARGED' | 'SWITCH_INOPERATIVE_ADVICE' | 'UNAUTHORIZED_MERCHANT' | 'UNKNOWN_HOST_TIMEOUT' | 'USER_TRANSACTION_LIMIT', required - `token` string, uuid, required — Transaction event identifier. - `type` 'AUTHORIZATION' | 'AUTHORIZATION_ADVICE' | 'AUTHORIZATION_EXPIRY' | 'AUTHORIZATION_REVERSAL' | 'BALANCE_INQUIRY' | 'CLEARING' | 'CORRECTION_CREDIT' | 'CORRECTION_DEBIT' | 'CREDIT_AUTHORIZATION' | 'CREDIT_AUTHORIZATION_ADVICE' | 'FINANCIAL_AUTHORIZATION' | 'FINANCIAL_CREDIT_AUTHORIZATION' | 'RETURN' | 'RETURN_REVERSAL', required — Type of transaction event - `financial_account_token` string, uuid, nullable, required - `merchant` TransactionMerchant, required — Merchant information including full location details. - `acceptor_id` string, required — Unique alphanumeric identifier for the payment card acceptor (merchant). - `acquiring_institution_id` string, required — Unique numeric identifier of the acquiring institution. - `city` string, required — City of card acceptor. Note that in many cases, particularly in card-not-present transactions, merchants may send through a phone number or URL in this field. - `country` string, required — Country or entity of card acceptor. Possible values are: (1) all ISO 3166-1 alpha-3 country codes, (2) QZZ for Kosovo, and (3) ANT for Netherlands Antilles. - `descriptor` string, required — Short description of card acceptor. - `mcc` string, required — Merchant category code (MCC). A four-digit number listed in ISO 18245. An MCC is used to classify a business by the types of goods or services it provides. - `state` string, required — Geographic state of card acceptor. - `postal_code` string, nullable, required — Postal code of card acceptor. - `street_address` string, nullable, required — Street address of card acceptor. - `phone_number` string, nullable, required — Phone number of card acceptor. - `service_location` ServiceLocation, required — Where the cardholder received the service, when different from the card acceptor location. This is populated from network data elements such as Mastercard DE-122 SE1 SF9-14 and Visa F34 DS02. - `street_address` string, nullable, required — Street address of service location. - `city` string, nullable, required — City of service location. - `state` string, nullable, required — State/province code of service location, ISO 3166-2. - `country` string, nullable, required — Country code of service location, ISO 3166-1 alpha-3. - `postal_code` string, nullable, required — Postal code of service location. - `merchant_amount` integer, nullable, required — Analogous to the 'amount', but in the merchant currency. - `merchant_authorization_amount` integer, nullable, required — Analogous to the 'authorization_amount', but in the merchant currency. - `merchant_currency` string, required — 3-character alphabetic ISO 4217 code for the local currency of the transaction. - `network` 'AMEX' | 'INTERLINK' | 'MAESTRO' | 'MASTERCARD' | 'UNKNOWN' | 'VISA', nullable, required — Card network of the authorization. Value is `UNKNOWN` when Lithic cannot determine the network code from the upstream provider. - `network_risk_score` integer, nullable, required — Network-provided score assessing risk level associated with a given authorization. Scores are on a range of 0-999, with 0 representing the lowest risk and 999 representing the highest risk. For Visa transactions, where the raw score has a range of 0-99, Lithic will normalize the score by multiplying the raw score by 10x. - `result` 'ACCOUNT_PAUSED' | 'ACCOUNT_STATE_TRANSACTION_FAIL' | 'APPROVED' | 'BANK_CONNECTION_ERROR' | 'BANK_NOT_VERIFIED' | 'CARD_CLOSED' | 'CARD_PAUSED' | 'DECLINED' | 'FRAUD_ADVICE' | 'IGNORED_TTL_EXPIRY' | 'SUSPECTED_FRAUD' | 'INACTIVE_ACCOUNT' | 'INCORRECT_PIN' | 'INVALID_CARD_DETAILS' | 'INSUFFICIENT_FUNDS' | 'INSUFFICIENT_FUNDS_PRELOAD' | 'INVALID_TRANSACTION' | 'MERCHANT_BLACKLIST' | 'ORIGINAL_NOT_FOUND' | 'PREVIOUSLY_COMPLETED' | 'SINGLE_USE_RECHARGED' | 'SWITCH_INOPERATIVE_ADVICE' | 'UNAUTHORIZED_MERCHANT' | 'UNKNOWN_HOST_TIMEOUT' | 'USER_TRANSACTION_LIMIT', required - `pos` Pos, required - `entry_mode` PosEntryMode, required - `card` 'NOT_PRESENT' | 'PREAUTHORIZED' | 'PRESENT' | 'UNKNOWN', required — Card presence indicator - `cardholder` 'DEFERRED_BILLING' | 'ELECTRONIC_ORDER' | 'INSTALLMENT' | 'MAIL_ORDER' | 'NOT_PRESENT' | 'PREAUTHORIZED' | 'PRESENT' | 'REOCCURRING' | 'TELEPHONE_ORDER' | 'UNKNOWN', required — Cardholder presence indicator - `pan` 'AUTO_ENTRY' | 'BAR_CODE' | 'CONTACTLESS' | 'CREDENTIAL_ON_FILE' | 'ECOMMERCE' | 'ERROR_KEYED' | 'ERROR_MAGNETIC_STRIPE' | 'ICC' | 'KEY_ENTERED' | 'MAGNETIC_STRIPE' | 'MANUAL' | 'OCR' | 'SECURE_CARDLESS' | 'UNKNOWN' | 'UNSPECIFIED', required — Method of entry for the PAN - `pin_entered` boolean, required — Indicates whether the cardholder entered the PIN. True if the PIN was entered. - `terminal` PosTerminal, required - `attended` boolean, required — True if a clerk is present at the sale. - `card_retention_capable` boolean, required — True if the terminal is capable of retaining the card. - `on_premise` boolean, required — True if the sale was made at the place of business (vs. mobile). - `operator` 'ADMINISTRATIVE' | 'CARDHOLDER' | 'CARD_ACCEPTOR' | 'UNKNOWN', required — The person that is designated to swipe the card - `partial_approval_capable` boolean, required — True if the terminal is capable of partial approval. Partial approval is when part of a transaction is approved and another payment must be used for the remainder. Example scenario: A $40 transaction is attempted on a prepaid card with a $25 balance. If partial approval is enabled, $25 can be authorized, at which point the POS will prompt the user for an additional payment of $15. - `pin_capability` 'CAPABLE' | 'INOPERATIVE' | 'NOT_CAPABLE' | 'UNSPECIFIED', required — Status of whether the POS is able to accept PINs - `acceptor_terminal_id` string, nullable — Uniquely identifies a terminal at the card acceptor location of acquiring institutions or merchant POS Systems - `type` 'ADMINISTRATIVE' | 'ATM' | 'AUTHORIZATION' | 'COUPON_MACHINE' | 'DIAL_TERMINAL' | 'ECOMMERCE' | 'ECR' | 'FUEL_MACHINE' | 'HOME_TERMINAL' | 'MICR' | 'OFF_PREMISE' | 'PAYMENT' | 'PDA' | 'PHONE' | 'POINT' | 'POS_TERMINAL' | 'PUBLIC_UTILITY' | 'SELF_SERVICE' | 'TELEVISION' | 'TELLER' | 'TRAVELERS_CHECK_MACHINE' | 'VENDING' | 'VOICE' | 'UNKNOWN', required — POS Type - `settled_amount` integer, required — The settled amount of the transaction in the settlement currency. - `token_info` TokenInfo, required - `wallet_type` 'APPLE_PAY' | 'GOOGLE_PAY' | 'MASTERPASS' | 'MERCHANT' | 'OTHER' | 'SAMSUNG_PAY', required — The wallet_type field will indicate the source of the token. Possible token sources include digital wallets (Apple, Google, or Samsung Pay), merchant tokenization, and “other” sources like in-flight commerce. Masterpass is not currently supported and is included for future use. - `tags` Tags, required — Key-value pairs for tagging resources. Tags allow you to associate arbitrary metadata with a resource for your own purposes. - `family` 'CARD', required — CARD - Card Transaction - PaymentTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'PAYMENT', required — PAYMENT - Payment Transaction - `category` 'ACH' | 'WIRE' | 'STABLECOIN' | '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' | 'PROGRAM_TRANSFER', required — Note: Inbound wire transfers are coming soon (availability varies by partner bank). The WIRE category is a preview. To learn more, contact your customer success manager. - `currency` string — Currency of the transaction in ISO 4217 format - `result` 'APPROVED' | 'DECLINED', required - `method_attributes` union, required — Method-specific attributes - AchMethodAttributes - `sec_code` 'CCD' | 'PPD' | 'WEB' | 'TEL' | 'CIE' | 'CTX', required — SEC code for ACH transaction - `return_reason_code` string, nullable — Return reason code if the transaction was returned - `ach_hold_period` integer, nullable — Number of days the ACH transaction is on hold - `retries` integer, nullable — Number of retries attempted - `company_id` string, nullable — Company ID for the ACH transaction - `receipt_routing_number` string, nullable — Receipt routing number - `recipient_name` string, nullable — Name of the recipient on ACH receipts. Reflects the originating bank's record - `trace_numbers` string[] — Trace numbers for the ACH transaction - `addenda` string, nullable — Addenda information - `override_company_name` string, nullable — Value to override the configured company name with. Can only be used if allowed to override - WireMethodAttributes - `wire_network` 'FEDWIRE' | 'SWIFT', required — Type of wire transfer - `wire_message_type` string, nullable, required — Type of wire message - `debtor` WirePartyDetails - … - `creditor` WirePartyDetails - … - `message_id` string, nullable — Point to point reference identifier, as assigned by the instructing party, used for tracking the message through the Fedwire system - `remittance_information` string, nullable — Payment details or invoice reference - `financial_account_token` string, uuid, required — Financial account token - `external_bank_account_token` string, uuid, nullable — External bank account token - `direction` 'CREDIT' | 'DEBIT', required — Transfer direction - `source` 'LITHIC' | 'EXTERNAL' | 'CUSTOMER', required — Transaction source - `method` 'ACH_NEXT_DAY' | 'ACH_SAME_DAY' | 'WIRE', required — Transfer method - `settled_amount` integer, required — Settled amount in cents - `pending_amount` integer, required — Pending amount in cents - `events` PaymentEvent[], required — List of transaction events - `amount` integer, required — Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents). - `created` string, date-time, required — Date and time when the financial event occurred. UTC time zone. - `detailed_results` string[] — More detailed reasons for the event - `result` 'APPROVED' | 'DECLINED', required — APPROVED financial events were successful while DECLINED financial events were declined by user, Lithic, or the network. - `token` string, uuid, required — Globally unique identifier. - `type` 'ACH_ORIGINATION_CANCELLED' | 'ACH_ORIGINATION_INITIATED' | 'ACH_ORIGINATION_PROCESSED' | 'ACH_ORIGINATION_REJECTED' | 'ACH_ORIGINATION_RELEASED' | 'ACH_ORIGINATION_REVIEWED' | 'ACH_ORIGINATION_SETTLED' | 'ACH_RECEIPT_PROCESSED' | 'ACH_RECEIPT_RELEASED' | 'ACH_RECEIPT_RELEASED_EARLY' | 'ACH_RECEIPT_SETTLED' | 'ACH_RETURN_INITIATED' | 'ACH_RETURN_PROCESSED' | 'ACH_RETURN_REJECTED' | 'ACH_RETURN_SETTLED' | 'WIRE_TRANSFER_INBOUND_RECEIVED' | 'WIRE_TRANSFER_INBOUND_SETTLED' | 'WIRE_TRANSFER_INBOUND_BLOCKED' | 'WIRE_RETURN_OUTBOUND_INITIATED' | 'WIRE_RETURN_OUTBOUND_SENT' | 'WIRE_RETURN_OUTBOUND_SETTLED' | 'WIRE_RETURN_OUTBOUND_REJECTED' | 'STABLECOIN_RECEIVED' | 'STABLECOIN_REVIEWED' | 'STABLECOIN_SETTLED', required — Note: Inbound wire transfers are coming soon (availability varies by partner bank). Wire-related event types below are a preview. To learn more, contact your customer success manager. Event types: ACH events: * `ACH_ORIGINATION_INITIATED` - ACH origination received and pending approval/release from an ACH hold. * `ACH_ORIGINATION_REVIEWED` - ACH origination has completed the review process. * `ACH_ORIGINATION_CANCELLED` - ACH origination has been cancelled. * `ACH_ORIGINATION_PROCESSED` - ACH origination has been processed and sent to the Federal Reserve. * `ACH_ORIGINATION_SETTLED` - ACH origination has settled. * `ACH_ORIGINATION_RELEASED` - ACH origination released from pending to available balance. * `ACH_ORIGINATION_REJECTED` - ACH origination was rejected and not sent to the Federal Reserve. * `ACH_RECEIPT_PROCESSED` - ACH receipt pending release from an ACH holder. * `ACH_RECEIPT_SETTLED` - ACH receipt funds have settled. * `ACH_RECEIPT_RELEASED` - ACH receipt released from pending to available balance. * `ACH_RECEIPT_RELEASED_EARLY` - ACH receipt released early from pending to available balance. * `ACH_RETURN_INITIATED` - ACH initiated return for an ACH receipt. * `ACH_RETURN_PROCESSED` - ACH receipt returned by the Receiving Depository Financial Institution. * `ACH_RETURN_SETTLED` - ACH return settled by the Receiving Depository Financial Institution. * `ACH_RETURN_REJECTED` - ACH return was rejected by the Receiving Depository Financial Institution. Wire transfer events: * `WIRE_TRANSFER_INBOUND_RECEIVED` - Inbound wire transfer received from the Federal Reserve and pending release to available balance. * `WIRE_TRANSFER_INBOUND_SETTLED` - Inbound wire transfer funds released from pending to available balance. * `WIRE_TRANSFER_INBOUND_BLOCKED` - Inbound wire transfer blocked and funds frozen for regulatory review. Wire return events: * `WIRE_RETURN_OUTBOUND_INITIATED` - Outbound wire return initiated to return funds from an inbound wire transfer. * `WIRE_RETURN_OUTBOUND_SENT` - Outbound wire return sent to the Federal Reserve and pending acceptance. * `WIRE_RETURN_OUTBOUND_SETTLED` - Outbound wire return accepted by the Federal Reserve and funds returned to sender. * `WIRE_RETURN_OUTBOUND_REJECTED` - Outbound wire return rejected by the Federal Reserve. Stablecoin events: * `STABLECOIN_RECEIVED` - Stablecoin pay-in received on-chain and pending release to available balance. * `STABLECOIN_REVIEWED` - Stablecoin pay-in has completed the review process. * `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance. - `external_id` string, nullable — Payment event external ID. For ACH transactions, this is the ACH trace number. For inbound wire transfers, this is the IMAD (Input Message Accountability Data). - `descriptor` string, required — Transaction descriptor - `user_defined_id` string, nullable — User-defined identifier - `expected_release_date` string, date, nullable — Expected release date for the transaction - `related_account_tokens` RelatedAccountTokens, required — Account tokens related to a payment transaction - `business_account_token` string, uuid, nullable, required — Globally unique identifier for the business account - `account_token` string, uuid, nullable, required — Globally unique identifier for the account - `type` 'ORIGINATION_CREDIT' | 'ORIGINATION_DEBIT' | 'RECEIPT_CREDIT' | 'RECEIPT_DEBIT' | 'WIRE_INBOUND_PAYMENT' | 'WIRE_INBOUND_ADMIN' | 'WIRE_OUTBOUND_PAYMENT' | 'WIRE_OUTBOUND_ADMIN' | 'WIRE_INBOUND_DRAWDOWN_REQUEST' - `tags` Tags — Key-value pairs for tagging resources. Tags allow you to associate arbitrary metadata with a resource for your own purposes. - ExternalPaymentResponse — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'EXTERNAL_PAYMENT', required — EXTERNAL_PAYMENT - External Payment Response - `result` 'APPROVED' | 'DECLINED', required - `category` 'EXTERNAL_WIRE' | 'EXTERNAL_ACH' | 'EXTERNAL_CHECK' | 'EXTERNAL_FEDNOW' | 'EXTERNAL_RTP' | 'EXTERNAL_TRANSFER', required - `settled_amount` integer, required - `pending_amount` integer, required - `currency` string, required - `events` ExternalPaymentEvent[], required - `amount` integer, required - `type` 'EXTERNAL_WIRE_INITIATED' | 'EXTERNAL_WIRE_CANCELED' | 'EXTERNAL_WIRE_SETTLED' | 'EXTERNAL_WIRE_REVERSED' | 'EXTERNAL_WIRE_RELEASED' | 'EXTERNAL_ACH_INITIATED' | 'EXTERNAL_ACH_CANCELED' | 'EXTERNAL_ACH_SETTLED' | 'EXTERNAL_ACH_REVERSED' | 'EXTERNAL_ACH_RELEASED' | 'EXTERNAL_TRANSFER_INITIATED' | 'EXTERNAL_TRANSFER_CANCELED' | 'EXTERNAL_TRANSFER_SETTLED' | 'EXTERNAL_TRANSFER_REVERSED' | 'EXTERNAL_TRANSFER_RELEASED' | 'EXTERNAL_CHECK_INITIATED' | 'EXTERNAL_CHECK_CANCELED' | 'EXTERNAL_CHECK_SETTLED' | 'EXTERNAL_CHECK_REVERSED' | 'EXTERNAL_CHECK_RELEASED' | 'EXTERNAL_FEDNOW_INITIATED' | 'EXTERNAL_FEDNOW_CANCELED' | 'EXTERNAL_FEDNOW_SETTLED' | 'EXTERNAL_FEDNOW_REVERSED' | 'EXTERNAL_FEDNOW_RELEASED' | 'EXTERNAL_RTP_INITIATED' | 'EXTERNAL_RTP_CANCELED' | 'EXTERNAL_RTP_SETTLED' | 'EXTERNAL_RTP_REVERSED' | 'EXTERNAL_RTP_RELEASED', required - `result` 'APPROVED' | 'DECLINED', required - `detailed_results` DetailedResults[], required - `created` string, date-time, required - `token` string, uuid, required - `memo` string, required - `effective_date` string, date, required - `user_defined_id` string, nullable - `financial_account_token` string, uuid, required - `payment_type` 'DEPOSIT' | 'WITHDRAWAL', required - ManagementOperationTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'MANAGEMENT_OPERATION', required — MANAGEMENT_OPERATION - Management Operation Transaction - `result` 'APPROVED' | 'DECLINED', required - `category` 'MANAGEMENT_FEE' | 'MANAGEMENT_DISPUTE' | 'MANAGEMENT_REWARD' | 'MANAGEMENT_ADJUSTMENT' | 'MANAGEMENT_DISBURSEMENT', required - `settled_amount` integer, required - `pending_amount` integer, required - `currency` string, required - `events` ManagementOperationEvent[], required - `amount` integer, required - `type` 'LOSS_WRITE_OFF' | 'CASH_BACK' | 'CASH_BACK_REVERSAL' | 'CURRENCY_CONVERSION' | 'CURRENCY_CONVERSION_REVERSAL' | 'INTEREST' | 'INTEREST_REVERSAL' | 'LATE_PAYMENT' | 'LATE_PAYMENT_REVERSAL' | 'BILLING_ERROR' | 'BILLING_ERROR_REVERSAL' | 'PROVISIONAL_CREDIT' | 'PROVISIONAL_CREDIT_REVERSAL' | 'RETURNED_PAYMENT' | 'RETURNED_PAYMENT_REVERSAL' | 'DISPUTE_WON' | 'DISPUTE_WON_REVERSAL' | 'DISBURSE' | 'DISBURSE_REVERSAL' | 'ANNUAL' | 'ANNUAL_REVERSAL' | 'QUARTERLY' | 'QUARTERLY_REVERSAL' | 'MONTHLY' | 'MONTHLY_REVERSAL', required - `subtype` string, nullable - `result` 'APPROVED' | 'DECLINED', required - `detailed_results` DetailedResults[], required - `created` string, date-time, required - `token` string, uuid, required - `memo` string, required - `effective_date` string, date, required - `user_defined_id` string, nullable - `financial_account_token` string, uuid, required - `direction` 'CREDIT' | 'DEBIT', required - `transaction_series` TransactionSeries, required - `type` string, required - `related_transaction_token` string, uuid, nullable, required - `related_transaction_event_token` string, uuid, nullable, required - `external_resource` ExternalResource — External resource associated with the management operation - `external_resource_type` 'STATEMENT' | 'COLLECTION' | 'DISPUTE' | 'UNKNOWN', required — Type of external resource associated with the management operation - `external_resource_token` string, required — Token identifying the external resource - `external_resource_sub_token` string — Token identifying the external resource sub-resource - HoldTransaction — Base class for all transaction types in the ledger service - `status` 'PENDING' | 'SETTLED', required — Status of a hold transaction - `token` string, uuid, required — Unique identifier for the transaction - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated - `family` 'HOLD', required — HOLD - Hold Transaction - `result` 'APPROVED' | 'DECLINED', required - `financial_account_token` string, uuid, required - `pending_amount` integer, required — Current pending amount (0 when resolved) - `currency` string, required - `events` HoldEvent[], required - `token` string, uuid, required - `type` 'HOLD_INITIATED' | 'HOLD_VOIDED' | 'HOLD_EXPIRED' | 'HOLD_SETTLED', required — Type of hold lifecycle event - `result` 'APPROVED' | 'DECLINED', required - `detailed_results` DetailedResults[], required - `amount` integer, required — Amount in cents - `created` string, date-time, required - `memo` string, nullable, required - `settling_transaction_token` string, uuid, nullable, required — Transaction token of the payment that settled this hold (only populated for HOLD_SETTLED events) - `user_defined_id` string, nullable, required - `expiration_datetime` string, date-time, nullable, required — When the hold will auto-expire if not resolved ## Other responses - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `500` — Internal server error --- [API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)