List interest tier schedules

financial_account_token

• uuid
  required
  Globally unique identifier for financial account

• after_date
  date
  Return schedules with effective_date >= after_date (ISO format YYYY-MM-DD)

• before_date
  date
  Return schedules with effective_date <= before_date (ISO format YYYY-MM-DD)

• for_date
  date
  Return schedule with effective_date == for_date (ISO format YYYY-MM-DD)

Response

``200 OK

object Tier Schedule of the given account. Only applicable for credit products with v2 configuration

• data
  array of objects
  required
  • data*
    object
    Entry in the Tier Schedule of an 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
    • tier_rates object
      • penalty_rates
        object
        Custom rates per category for penalties
      • penalty_rates object
      • credit_product_token
        string
        required
        Globally unique identifier for a credit product
    • has_more
      boolean
      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 | 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
  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

Example Request

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

Example Response

{
  "data": [
    {
      "tier_name": "string",
      "effective_date": "2026-07-18",
      "tier_rates": {},
      "penalty_rates": {},
      "credit_product_token": "string"
    }
  ],
  "has_more": true
}