# Tier Schedule API

## Definitions

### effective_date
- **type**: date  
- **required**: true  
- **description**: Effective date in ISO format (YYYY-MM-DD)

### financial_account_token
- **type**: uuid  
- **required**: true  
- **description**: Globally unique identifier for financial account

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

### tier_rates
- **type**: object  
- **description**: Custom rates per category. Mutually exclusive with tier_name

### penalty_rates
- **type**: object  
- **description**: Custom rates per category for penalties

## Example Responses

### Successful Response

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

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

## cURL Example

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