Remove Duplicate Credit Account State Fields

Release Date

November 3, 2025

Products Affected

Credit Ledger Financial Accounts

Impact

Three fields are being removed from Financial_Account.Credit_Configuration. All existing customers have been successfully migrated

Audience

Customers using Credit Ledger Financial Accounts

Action Required

New customers should begin using status and substatus fields.

Overview

As part of simplifying and consolidating statuses on accounts, Lithic is removing the following fields from the Credit Configuration object on our Financial Accounts

financial_account_state
is_spend_blocked
charged_off_reason

Customers should instead use status and substatus fields on the financial account object to view and indicate the status of Credit Financial Accounts

status and substatus fields will also be seen in the Statements and Loan Tape endpoints.

Details

Logic and behavior for each of the fields being removed has been built into status and substatus fields on the Financial Account object as follows:

Lithic will automatically set substatus = DELINQUENT upon detection of a missed payment
Customers should use status = SUSPENDED to block spend
substatus can later be set to CHARGED_OFF_DELINQUENT or CHARGED_OFF_FRAUD. Once you set a CHARGED_OFF_* substatus, the account cannot return to open and interest will stop accruing

In addition, status and substatus is now what you will see in the Statements and Loan Tape endpoints. Within the body of the Statement and Loan Tape, in the account_standing object:

  "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": "SUSPENDED",
      "substatus": "CHARGED_OFF_DELINQUENT"
    }
  }

Release Timeline

Production change: November 3, 2025

User Impact

While this change does remove fields from our endpoints, we have worked with each live and implementing customer to migrate them to our new logic with status and substatus.

Updated Documentation

For detailed specifications, visit our API Reference:

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.