# Financial Account Token

## Schema

- **financial_account_token**:  
  - **uuid**: required
  - **nickname**: string (length ≤ 256)

## Response Codes

- 200 OK
  - object
    - **token**: uuid, required and a 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 (required)
    - **account_token**: uuid | null (required)
    - **status**: string, enum (required)
      - Status of the financial account: `OPEN`, `CLOSED`, `SUSPENDED`, `PENDING`
    - **substatus**: null (Financial Account Substatus, required)
    - **user_defined_status**: string | null (required)
      - User-defined status for the financial account
    - **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)
        - Tier assigned to the financial account
      - **auto_collection_configuration**: null (Auto Collection Configuration Response, required)

## Error Responses

- 400 A parameter in the query does not match valid queries for the endpoint.
- 401  User has not been authenticated.
- 404  The specified resource was not found.
- 422  Unprocessable entity.
- 429  Client has exceeded the number of allowed requests.

## Example Request

```bash
curl --request PATCH \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{\n  "nickname": "string"\n}'
```

## Example Response

```json
{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2026-07-18T00:25:32.840Z",
  "updated": "2026-07-18T00:25:32.840Z",
  "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
    }
  }
}
```