--- title: "List loan tapes" method: GET path: "/v1/financial_accounts/{financial_account_token}/loan_tapes" tags: ["Statements"] --- # List loan tapes `GET /v1/financial_accounts/{financial_account_token}/loan_tapes` List the loan tapes for a given financial account. ## Path parameters - `financial_account_token` string, uuid, required — Globally unique identifier for financial account. ## Query parameters - `begin` string, date — Date string in RFC 3339 format. Only entries created after the specified date will be included. - `end` string, date — Date string in RFC 3339 format. Only entries created before the specified date will be included. - `ending_before` string — A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item. - `page_size` integer — Page size (for pagination). - `starting_after` string — A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. ## Response `200` OK - LoanTapesResponse - `data` LoanTapeResponse[], required - `token` string, required — Globally unique identifier for a loan tape - `financial_account_token` string, uuid, required — Globally unique identifier for a financial account - `date` string, date, required — Date of transactions that this loan tape covers - `day_of_period` integer, nullable — Day of the billing period that this loan tape covers, starting at 1 - `created` string, date-time, required — Timestamp of when the loan tape was created - `updated` string, date-time, required — Timestamp of when the loan tape was updated - `version` integer, required — Version number of the loan tape. This starts at 1 - `ytd_totals` StatementTotals, required - `payments` integer, required — Any funds transfers which affective the balance in cents - `payment_details` PaymentDetails — Breakdown of payments - `purchases` integer, required — Net card transaction volume less any cash advances in cents - `fees` integer, required — Volume of debit management operation transactions less any interest in cents - `debits` integer, required — Volume of debit management operation transactions less any interest in cents - `debit_details` DebitDetails — Breakdown of debits - `credits` integer, required — Volume of credit management operation transactions less any balance transfers in cents - `credit_details` CreditDetails — Breakdown of credits - `interest` integer, required — Interest accrued in cents - `cash_advances` integer, required — ATM and cashback transactions in cents - `balance_transfers` integer, required — Opening balance transferred from previous account in cents - `period_totals` StatementTotals, required - `payments` integer, required — Any funds transfers which affective the balance in cents - `payment_details` PaymentDetails — Breakdown of payments - `purchases` integer, required — Net card transaction volume less any cash advances in cents - `fees` integer, required — Volume of debit management operation transactions less any interest in cents - `debits` integer, required — Volume of debit management operation transactions less any interest in cents - `debit_details` DebitDetails — Breakdown of debits - `credits` integer, required — Volume of credit management operation transactions less any balance transfers in cents - `credit_details` CreditDetails — Breakdown of credits - `interest` integer, required — Interest accrued in cents - `cash_advances` integer, required — ATM and cashback transactions in cents - `balance_transfers` integer, required — Opening balance transferred from previous account in cents - `day_totals` StatementTotals, required - `payments` integer, required — Any funds transfers which affective the balance in cents - `payment_details` PaymentDetails — Breakdown of payments - `purchases` integer, required — Net card transaction volume less any cash advances in cents - `fees` integer, required — Volume of debit management operation transactions less any interest in cents - `debits` integer, required — Volume of debit management operation transactions less any interest in cents - `debit_details` DebitDetails — Breakdown of debits - `credits` integer, required — Volume of credit management operation transactions less any balance transfers in cents - `credit_details` CreditDetails — Breakdown of credits - `interest` integer, required — Interest accrued in cents - `cash_advances` integer, required — ATM and cashback transactions in cents - `balance_transfers` integer, required — Opening balance transferred from previous account in cents - `balances` Balances, required - `past_due` CategoryBalances, required - `interest` integer, required - `principal` integer, required - `fees` integer, required - `due` CategoryBalances, required - `interest` integer, required - `principal` integer, required - `fees` integer, required - `past_statements_due` CategoryBalances, required - `interest` integer, required - `principal` integer, required - `fees` integer, required - `next_statement_due` CategoryBalances, required - `interest` integer, required - `principal` integer, required - `fees` integer, required - `starting_balance` integer, required — Balance at the start of the day - `ending_balance` integer, required — Balance at the end of the day - `credit_limit` integer, required — For prepay accounts, this is the minimum prepay balance that must be maintained. For charge card accounts, this is the maximum credit balance extended by a lender - `available_credit` integer, required — Amount of credit available to spend in cents - `excess_credits` integer, required — Excess credits in the form of provisional credits, payments, or purchase refunds. If positive, the account is in net credit state with no outstanding balances. An overpayment could land an account in this state - `account_standing` AccountStanding, required - `period_state` 'STANDARD' | 'PROMO' | 'PENALTY', required - `period_number` integer, required — Current overall period number - `consecutive_minimum_payments_made` integer, required — Number of consecutive minimum payments made - `consecutive_minimum_payments_missed` integer, required — Number of consecutive minimum payments missed - `consecutive_full_payments_made` integer, required — Number of consecutive full payments made - `days_past_due` integer, required — Number of days past due - `has_grace` boolean, required — Whether the account currently has grace or not - `financial_account_state` FinancialAccountState, required — Information about the financial account state - `status` 'OPEN' | 'CLOSED' | 'SUSPENDED' | 'PENDING', required — Status of the financial account - `substatus` 'CHARGED_OFF_DELINQUENT' | 'CHARGED_OFF_FRAUD' | 'END_USER_REQUEST' | 'BANK_REQUEST' | 'DELINQUENT' | 'INTEREST_AND_FEES_PAUSED' — Substatus for the financial account - `credit_product_token` string, required — Globally unique identifier for a credit product - `tier` string, nullable — Interest tier to which this account belongs to - `payment_allocation` PaymentAllocation, required - `interest` integer, required — Amount allocated to interest in cents - `principal` integer, required — Amount allocated to principal in cents - `fees` integer, required — Amount allocated to fees in cents - `interest_details` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `principal_details` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `fee_details` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `minimum_payment_balance` BalanceDetails, required - `amount` integer, required - `remaining` integer, required - `previous_statement_balance` BalanceDetails, required - `amount` integer, required - `remaining` integer, required - `interest_details` InterestDetails, required - `prime_rate` string, nullable, required - `interest_calculation_method` 'DAILY' | 'AVERAGE_DAILY', required - `effective_apr` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `interest_for_period` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `daily_balance_amounts` CategoryDetails, required - `purchases` string, required - `cash_advances` string, required - `balance_transfers` string, required - `minimum_interest_charged` integer, nullable - `actual_interest_charged` integer, nullable, required - `has_more` boolean, required ## Other responses - `400` — A parameter in the query given in the request does not match the valid queries for the endpoint. - `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) | - `404` — The specified resource was not found. - `422` — Unprocessable entity. - `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys | --- [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/versions/53ab5d4e2adb/schema)