Financial Account

Update financial account status

Changed on

Update financial account status

post/v1/financial_accounts/{financial_account_token}/update_status

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/financial_accounts/{financial_account_token}/update_status
  • Auth
    API key in header Authorization

Path parameters

financial_account_tokenstring uuid required

Globally unique identifier for financial account.

Request body

status'OPEN' | 'CLOSED' | 'SUSPENDED' | 'PENDING' required

Status of the financial account

substatus'CHARGED_OFF_FRAUD' | 'END_USER_REQUEST' | 'BANK_REQUEST' | 'CHARGED_OFF_DELINQUENT' | 'INTEREST_AND_FEES_PAUSED' | 'DELINQUENT' required

Substatus for the financial account

user_defined_statusstring

User-defined status for the financial account

Example request

{
  "status": "CLOSED",
  "substatus": "END_USER_REQUEST"
}

Response

OK

tokenstring uuid required

Globally unique identifier for the account

createdstring date-time required
updatedstring date-time required
routing_numberstring nullable
account_numberstring nullable
blockchain_addressesobject nullable

Provisioned blockchain deposit addresses for this financial account, keyed by the full name of the blockchain network that each address belongs to (e.g. ETHEREUM)

nicknamestring nullable required
account_tokenstring uuid nullable required
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' required

Substatus for the financial account

user_defined_statusstring nullable required

User-defined status for the financial account

is_for_benefit_ofboolean required

Whether financial account is for the benefit of another entity

Example response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "blockchain_addresses": {
    "ETHEREUM": "0x5f2b9e8a1c4d7f0e3a6b9c2d5e8f1a4b7c0d3e6f"
  }
}

Changes

  • 50e7b2488836Revision changes
    • info

      added the optional property to the response with the status

  • fd53f07a8b1fRevision changes
    • info

      added the new DELINQUENT enum value to the request property /