# financial_account_token

## uuid

**required**

## 200 OK

### 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
  - **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**

## 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 | The API key used is no longer active |  
| Could not find API key | The API key provided is not associated with any user |  
| Please provide API key in Authorization header | The Authorization header is not in the request |  
| Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly |  
| Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](/content/contact/index.html) |  
| Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |

## 404 The specified resource was not found.

## 422 Unprocessable entity.

## 429 Client has exceeded the number of allowed requests in a given time period.
| | |  |
| --- | --- |
| Rate limited, too many requests per second | User has exceeded their per second rate limit |  
| Rate limited, reached daily limit | User has exceeded their daily rate limit |  
| Rate limited, too many keys tried | One IP has queried too many different API keys |

### Updated 3 months ago

## Shell

```shell
curl --request GET \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token \
     --header 'accept: application/json'
```

## Response

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

### Updated 3 months ago