GET//////
Retrieves the interest rate for a specific tier on the given effective date.
URL path parameters
| Fields | Description |
|---|---|
| interest_tier_token string Required | Unique identifier of the interest tier, as returned by the POST /v3/interestaccounts/interesttiers endpoint.Allowable Values: Existing interest tier token |
| rate_effective_date string Required | Date on which the interest rate takes effect. Allowable Values: Format: yyyy-MM-dd |
Response body
| Fields | Description |
|---|---|
| note string Conditionally returned | Optional note describing the reason for the rate change. Allowable Values: Example: Q3 2026 rate adjustment. 255 char max |
| account_rate decimal Returned | The gross interest rate, also known as the nominal interest rate. This is the base rate, calculated without compounding. Allowable Values: 0–100 |
| effective_rate decimal Conditionally returned | The effective interest rate, also known as the annual percentage yield (APY) or annual equivalent rate (AER) — the daily compounding rate applied to the account’s balance. Allowable Values: 0–100 |
| effective_date string Returned | Date the rate takes effect. Allowable Values: Format: yyyy-MM-dd |
| created_time datetime Returned | Date and time when the rate was created, in UTC. Allowable Values: Example: 2026-01-15T09:00:00Z Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Returned | Date and time when the rate was last updated, in UTC. Allowable Values: Example: 2026-06-01T12:00:00Z Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"account_rate": 3.75,
"effective_rate": 3.82,
"effective_date": "2026-07-01",
"note": "Q3 2026 rate adjustment.",
"created_time": "2026-06-01T12:00:00Z",
"updated_time": "2026-06-01T12:00:00Z"
}
Error codes
| Error Code | Error Message |
|---|---|
400001 | Invalid input(s) detected |