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

{
  "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

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"
}'