Financial Account Token

uuid

• required: Globally unique identifier for financial account.

status

• type: string
• enum
• required: Status of the financial account
  • Allowed: OPEN, CLOSED, SUSPENDED, PENDING

substatus

• null: Update Financial Account Substatus

user_defined_status

• type: string
• length: ≤ 100
• pattern: ^[A-Z0-9_ ]*$
• required: User-defined status for the financial account

Response 200 OK

• type: object
  • token: uuid
    • required: Globally unique identifier for the account
  • created: date-time
    • required
  • updated: date-time
    • required
  • type: Instance Financial Account Type | Account Financial Account Type
    • required
  • routing_number: string | null
  • account_number: string | null
  • nickname: string | null
  • account_token: uuid | null
    • required
  • status: string
    • enum
    • required: Status of the financial account
  • substatus: null
  • user_defined_status: string | null
    • required
  • is_for_benefit_of: boolean
    • required: Whether financial account is for the benefit of another entity
  • credit_configuration: object | null
    • required
      • credit_limit: integer | null
        • required
      • external_bank_account_token: uuid | null
        • required
      • credit_product_token: string | null
        • required: Globally unique identifier for the credit product
      • tier: string | null
        • required
      • auto_collection_configuration: null
        • Auto Collection Configuration Response

Error 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
  • Could not find API key
  • Please provide API key in Authorization header
  • Please provide API key in the form Authorization: [api-key]
  • Insufficient privileges. Issuing API key required
  • Insufficient privileges to create virtual cards.
• 404: The specified resource was not found.
• 429: Client has exceeded the number of allowed requests in a given time period.

Example CURL Request

curl --request POST \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token/update_status \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "status": "OPEN",
  "substatus": "CHARGED_OFF_FRAUD",
  "user_defined_status": "string"
}'

Example Response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2026-07-18T00:25:34.098Z",
  "updated": "2026-07-18T00:25:34.098Z",
  "type": "ISSUING",
  "routing_number": "string",
  "account_number": "string",
  "nickname": "string",
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "OPEN",
  "substatus": "CHARGED_OFF_DELINQUENT",
  "user_defined_status": "string",
  "is_for_benefit_of": true,
  "credit_configuration": {
    "credit_limit": 0,
    "external_bank_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "credit_product_token": "string",
    "tier": "string",
    "auto_collection_configuration": {
      "auto_collection_enabled": true
    }
  }
}