# 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
```bash
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
```json
{
  "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
    }
  }
}
```