---
title: "List statements"
method: GET
path: "/v1/financial_accounts/{financial_account_token}/statements"
tags: ["Statements"]
---

# List statements

`GET /v1/financial_accounts/{financial_account_token}/statements`

List the statements 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.
- `include_initial_statements` boolean — Whether to include the initial statement. It is not included by default.

## Response `200`

OK

- StatementsResponse
  - `data` StatementResponse[], required
    - `token` string, required — Globally unique identifier for a statement
    - `financial_account_token` string, uuid, required — Globally unique identifier for a financial account
    - `statement_start_date` string, date, required — Date when the billing period began
    - `statement_end_date` string, date, required — Date when the billing period ended
    - `next_statement_end_date` string, date, nullable — Date when the next billing period will end
    - `payment_due_date` string, date, nullable, required — Date when the payment is due
    - `next_payment_due_date` string, date, nullable — Date when the next payment is due
    - `days_in_billing_cycle` integer, required — Number of days in the billing cycle
    - `credit_limit` integer, required — This is the maximum credit balance extended by the lender in cents
    - `available_credit` integer, required — Amount of credit available to spend in cents
    - `starting_balance` integer, required — Balance at the start of the billing period
    - `ending_balance` integer, required — Balance at the end of the billing period. For charge cards, this should be the same at the statement amount due 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
    - `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
    - `statement_totals` StatementTotals
      - `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
    - `created` string, date-time, required — Timestamp of when the statement was created
    - `updated` string, date-time, required — Timestamp of when the statement was updated
    - `credit_product_token` string, nullable, required — Globally unique identifier for a credit product
    - `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
    - `amount_due` AmountDue, required
      - `amount` integer, required — Payment due at the end of the billing period in cents. Negative amount indicates something is owed. If the amount owed is positive there was a net credit. If auto-collections are enabled this is the amount that will be requested on the payment due date
      - `past_due` integer, required — Amount past due for statement in cents
    - `payoff_details` PayoffDetails — Details on number and size of payments to pay off balance
      - `minimum_payment_months` string, required — The number of months it would take to pay off the balance in full by only paying the minimum payment. "NA" will signal negative or zero amortization
      - `minimum_payment_total` string, required — The sum of all interest and principal paid, in cents, when only paying minimum monthly payment. "NA" will signal negative or zero amortization
      - `payoff_period_length_months` integer, nullable, required — Number of months to full pay off
      - `payoff_period_monthly_payment_amount` integer, nullable, required — The amount needed to be paid, in cents, each month in order to pay off current balance in the payoff period
      - `payoff_period_payment_total` integer, nullable, required — The sum of all interest and principal paid, in cents, when paying off in the payoff period
    - `interest_details` InterestDetails
      - `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
    - `statement_type` 'INITIAL' | 'PERIOD_END' | 'FINAL', 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)