# Financial Account Token

- **uuid**  
  - **Required**  
  - Globally unique identifier for financial account

- **tier_name**  
  - **string**  
  - Name of a tier contained in the credit product. Mutually exclusive with tier_rates

- **effective_date**  
  - **date**  
  - **Required**  
  - Date the tier should be effective in YYYY-MM-DD format

- **tier_rates**  
  - **object**  
  - Custom rates per category. Mutually exclusive with tier_name

- **penalty_rates**  
  - **object**  
  - Custom rates per category for penalties

- **credit_product_token**  
  - **string**  
  - **Required**  
  - Globally unique identifier for a credit product

# Response Codes

- **201 Created**  
  - Entry in the Tier Schedule of an account  
- **400 Bad Request**  
  - A parameter in the query given in the request does not match the valid queries for the endpoint.  
- **401 Unauthorized**  
  - 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 Not Found**  
  - The specified resource was not found.  
- **422 Unprocessable Entity**  
- **429 Too Many Requests**  
  - Client has exceeded the number of allowed requests in a given time period  
  - Rate limited, too many requests per second  
  - Rate limited, reached daily limit  
  - Rate limited, too many keys tried

# Sample Request

```shell  
curl --request POST \  
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token/interest_tier_schedule \  
     --header 'accept: application/json' \  
     --header 'content-type: application/json' \  
     --data '{  
  "tier_name": "string",  
  "effective_date": "2026-07-18",  
  "credit_product_token": "string"  
}'  
```

# Sample Response

```json  
{  
  "tier_name": "string",  
  "effective_date": "2026-07-18",  
  "tier_rates": {},  
  "penalty_rates": {},  
  "credit_product_token": "string"  
}  
```
