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

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

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