# Financial Account Token

## Parameters

### `financial_account_token`
- **Type**: uuid  
- **Requirement**: required  
- **Description**: Globally unique identifier for financial account.
  
### `statement_token`
- **Type**: string  
- **Requirement**: required  
- **Description**: Globally unique identifier for statements.

# Response Structure

## ``200 OK``

### Object

- **token**: string  
  - **Requirement**: required  
  - **Description**: Globally unique identifier for a statement

- **financial_account_token**: uuid  
  - **Requirement**: required  
  - **Description**: Globally unique identifier for a financial account

- **statement_start_date**: date  
  - **Requirement**: required  
  - **Description**: Date when the billing period began

- **statement_end_date**: date  
  - **Requirement**: required  
  - **Description**: Date when the billing period ended

- **next_statement_end_date**: date | null  
  - **Description**: Date when the next billing period will end

- **payment_due_date**: string  
  - **Requirement**: required

- **next_payment_due_date**: date | null  
  - **Description**: Date when the next payment is due

- **days_in_billing_cycle**: integer  
  - **Requirement**: required  
  - **Description**: Number of days in the billing cycle

- **credit_limit**: integer  
  - **Requirement**: required  
  - **Description**: This is the maximum credit balance extended by the lender in cents

- **available_credit**: integer  
  - **Requirement**: required  
  - **Description**: Amount of credit available to spend in cents

- **starting_balance**: integer  
  - **Requirement**: required  
  - **Description**: Balance at the start of the billing period

- **ending_balance**: integer  
  - **Requirement**: required  
  - **Description**: 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
- **object**
  - **payments**: integer  
    - **Requirement**: required  
    - **Description**: Any funds transfers which affect the balance in cents

- **payment_details**: null  
    - **Description**: Payment Details

- **purchases**: integer  
    - **Requirement**: required  
    - **Description**: Net card transaction volume less any cash advances in cents

- **fees**: integer  
    - **Requirement**: required  
    - **Description**: Volume of debit management operation transactions less any interest in cents

- **debits**: integer  
    - **Requirement**: required  
    - **Description**: Volume of debit management operation transactions less any interest in cents

- **debit_details**: null  
    - **Description**: Debit Details

- **credits**: integer  
    - **Requirement**: required  
    - **Description**: Volume of credit management operation transactions less any balance transfers in cents

- **credit_details**: null  
    - **Description**: Credit Details

- **interest**: integer  
    - **Requirement**: required  
    - **Description**: Interest accrued in cents

- **cash_advances**: integer  
    - **Requirement**: required  
    - **Description**: ATM and cashback transactions in cents

- **balance_transfers**: integer  
    - **Requirement**: required  
    - **Description**: Opening balance transferred from previous account in cents

### ytd_totals
- **object**
  - **payments**: integer  
  - **payment_details**: null  
  - **purchases**: integer  
  - **fees**: integer  
  - **debits**: integer  
  - **debit_details**: null  
  - **credits**: integer  
  - **credit_details**: null  
  - **interest**: integer  
  - **cash_advances**: integer  
  - **balance_transfers**: integer

### statement_totals
- **object**
  - **payments**: integer  
  - **payment_details**: null  
  - **purchases**: integer  
  - **fees**: integer  
  - **debits**: integer  
  - **debit_details**: null  
  - **credits**: integer  
  - **credit_details**: null  
  - **interest**: integer  
  - **cash_advances**: integer  
  - **balance_transfers**: integer

- **created**: date-time  
  - **Requirement**: required  
  - **Description**: Timestamp of when the statement was created

- **updated**: date-time  
  - **Requirement**: required  
  - **Description**: Timestamp of when the statement was updated

- **credit_product_token**: null  
  - **Requirement**: required  
  - **Description**: Globally unique identifier for a credit product

### account_standing
- **object**
  - **period_state**: string  
    - **enum**: required  
    - **Options**: `STANDARD`, `PROMO`, `PENALTY`

- **period_number**: integer  
    - **Requirement**: required

- **consecutive_minimum_payments_made**: integer  
    - **Requirement**: required

- **consecutive_minimum_payments_missed**: integer  
    - **Requirement**: required

- **consecutive_full_payments_made**: integer  
    - **Requirement**: required

- **days_past_due**: integer  
    - **Requirement**: required

- **has_grace**: boolean  
    - **Requirement**: required

- **financial_account_state**: object  
    - **Description**: Information about the financial account state

### Financial Account State Object

- **amount_due**: object  
  - **amount**: integer  
    - **Requirement**: required  
    - **Description**: 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  
    - **Requirement**: required  
    - **Description**: Amount past due for statement in cents

- **payoff_details**: null  
  - **Description**: Payoff Details

- **interest_details**: null | object  
  - **Description**: Interest Details

### Interest Details

- **statement_type**: string  
  - **enum**: required  
  - **Options**: `INITIAL`, `PERIOD_END`, `FINAL`

# Example Request

```bash
curl --request GET \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token/statements/statement_token \
     --header 'accept: application/json'
```

### Example Response

```json
{
  "token": "string",
  "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "statement_start_date": "2026-07-18",
  "statement_end_date": "2026-07-18",
  "next_statement_end_date": "2026-07-18",
  "payment_due_date": "2026-07-18",
  "next_payment_due_date": "2026-07-18",
  "days_in_billing_cycle": 0,
  "credit_limit": 0,
  "available_credit": 0,
  "starting_balance": 0,
  "ending_balance": 0,
  "period_totals": {
    "payments": 0,
    "payment_details": {},
    "purchases": 0,
    "fees": 0,
    "debits": 0,
    "debit_details": {},
    "credits": 0,
    "credit_details": {},
    "interest": 0,
    "cash_advances": 0,
    "balance_transfers": 0
  },
  "ytd_totals": {
    "payments": 0,
    "payment_details": {},
    "purchases": 0,
    "fees": 0,
    "debits": 0,
    "debit_details": {},
    "credits": 0,
    "credit_details": {},
    "interest": 0,
    "cash_advances": 0,
    "balance_transfers": 0
  },
  "statement_totals": {
    "payments": 0,
    "payment_details": {},
    "purchases": 0,
    "fees": 0,
    "debits": 0,
    "debit_details": {},
    "credits": 0,
    "credit_details": {},
    "interest": 0,
    "cash_advances": 0,
    "balance_transfers": 0
  },
  "created": "2026-07-18T00:25:42.533Z",
  "updated": "2026-07-18T00:25:42.533Z",
  "credit_product_token": "string",
  "account_standing": {
    "period_state": "STANDARD",
    "period_number": 0,
    "consecutive_minimum_payments_made": 0,
    "consecutive_minimum_payments_missed": 0,
    "consecutive_full_payments_made": 0,
    "days_past_due": 0,
    "has_grace": true,
    "financial_account_state": {
      "status": "OPEN",
      "substatus": "CHARGED_OFF_DELINQUENT"
    }
  },
  "amount_due": {
    "amount": 0,
    "past_due": 0
  },
  "payoff_details": {
    "minimum_payment_months": "string",
    "minimum_payment_total": "string",
    "payoff_period_length_months": 0,
    "payoff_period_monthly_payment_amount": 0,
    "payoff_period_payment_total": 0
  },
  "interest_details": {
    "prime_rate": "string",
    "interest_calculation_method": "DAILY",
    "effective_apr": {
      "purchases": "string",
      "cash_advances": "string",
      "balance_transfers": "string"
    },
    "interest_for_period": {
      "purchases": "string",
      "cash_advances": "string",
      "balance_transfers": "string"
    },
    "daily_balance_amounts": {
      "purchases": "string",
      "cash_advances": "string",
      "balance_transfers": "string"
    },
    "minimum_interest_charged": 0,
    "actual_interest_charged": 0
  },
  "statement_type": "INITIAL"
}
```
