Skip to content

Update Status

Update financial account status
post/v1/financial_accounts/{financial_account_token}/update_status

Update financial account status

Path Parameters
financial_account_tokenstring
formatuuid
Body Parameters
statusenum
Accepts one of the following: "OPEN", "CLOSED", "SUSPENDED", "PENDING"

Status of the financial account

Hide ParametersShow Parameters
"OPEN"
"CLOSED"
"SUSPENDED"
"PENDING"
substatusenum
Accepts one of the following: "CHARGED_OFF_FRAUD", "END_USER_REQUEST", "BANK_REQUEST", "CHARGED_OFF_DELINQUENT"

Substatus for the financial account

Hide ParametersShow Parameters
"CHARGED_OFF_FRAUD"
"END_USER_REQUEST"
"BANK_REQUEST"
"CHARGED_OFF_DELINQUENT"
Returns
tokenstringaccount_tokenstringcreatedstringcredit_configurationobjectis_for_benefit_ofbooleannicknamestringstatusenumtypeenumupdatedstringaccount_numberstringrouting_numberstringsubstatusenumFinancialAccount
Request example Request
curl https://api.lithic.com/v1/financial_accounts/$FINANCIAL_ACCOUNT_TOKEN/update_status \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "status": "OPEN",
      "substatus": "CHARGED_OFF_FRAUD"
    }'
200 Example
{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "created": "2019-12-27T18:11:19.117Z",
  "credit_configuration": {
    "charged_off_reason": "DELINQUENT",
    "credit_limit": 0,
    "credit_product_token": "credit_product_token",
    "external_bank_account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "financial_account_state": "PENDING",
    "is_spend_blocked": true,
    "tier": "tier"
  },
  "is_for_benefit_of": true,
  "nickname": "nickname",
  "status": "OPEN",
  "type": "ISSUING",
  "updated": "2019-12-27T18:11:19.117Z",
  "account_number": "account_number",
  "routing_number": "routing_number",
  "substatus": "CHARGED_OFF_DELINQUENT"
}