# API Documentation

### Account Token

- **uuid**: The unique identifier for the account. (required)
- **nickname**: A string (length ≤ 256) used to identify the account. (required)
- **type**: Specifies the account type. (required)
  - Enum: `OPERATING`
- **is_for_benefit_of**: A boolean indicating if the account is for the benefit of another entity. (required)

### Idempotency-Key
- **uuid**: Idempotency key for the request.

## Response: 200 OK

- **object**: Response object containing account details.
  - **token**: (uuid) Globally unique identifier for the account. (required)
  - **created**: (date-time) Date when the account was created. (required)
  - **updated**: (date-time) Date when the account was last updated. (required)
  - **type**: Type of financial account. (required)
  - **routing_number**: (string | null)
  - **account_number**: (string | null)
  - **nickname**: (string | null) (required)
  - **account_token**: (uuid | null) (required)
  - **status**: (string) Current status of the financial account. (required)
    - Enum: `OPEN`, `CLOSED`, `SUSPENDED`, `PENDING`
  - **substatus**: (null) Financial Account Substatus (required)
  - **user_defined_status**: (string | null) (required)
  - **is_for_benefit_of**: (boolean) (required)
  - **credit_configuration**: (object | null) (required)
    - **credit_limit**: (integer | null) (required)
    - **external_bank_account_token**: (uuid | null) (required)
    - **credit_product_token**: (string | null) (required)
    - **tier**: (string | null) (required)
    - **auto_collection_configuration**: (null) Auto Collection Configuration Response (required)

## 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.
- **404**: The specified resource was not found.
- **429**: Client has exceeded the number of allowed requests in a given time period.

## Example Request

```shell
curl --request POST \
     --url https://sandbox.lithic.com/v1/financial_accounts \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data ' {
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "nickname": "string",
  "type": "OPERATING",
  "is_for_benefit_of": true
}
' 
```

## Example Response

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