GET/////
Returns a paginated list of interest rates for a specific tier.
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 |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of interest tier rates to retrieve. Allowable Values: 0 min Default value: 5 |
| start_index integer Optional | Index of the first result in the returned array. Use for pagination. Allowable Values: 0 min Default value: 0 |
| sort_by string Optional | Field on which to sort. Prefix with - for descending order.Allowable Values: created_time, -created_time, last_modified_time, or -last_modified_timeDefault value: -created_time |
Response body
| Fields | Description |
|---|---|
| count integer Returned | Number of interest tier rate resources returned. Allowable Values: Example: 1 Any integer |
| start_index integer Returned | Sort order index of the first resource in the returned array. Allowable Values: Example: 0 Any integer |
| is_more boolean Returned | A value of true indicates that more unreturned resources exist.Allowable Values: Example: falsetrue, false |
| data array of objects Returned | Array of interest tier rate objects. Allowable Values: Valid array of one or more interest tier rate objects |
| data[].note string Conditionally returned | Optional note describing the reason for the rate change. Allowable Values: Example: Q3 2026 rate adjustment. 255 char max |
| data[].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 |
| data[].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 |
| data[].effective_date string Returned | Date the rate takes effect. Allowable Values: Format: yyyy-MM-dd |
| data[].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 |
| data[].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
{
"count": 2,
"start_index": 0,
"is_more": false,
"data": [
{
"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"
},
{
"account_rate": 3.5,
"effective_rate": 3.57,
"effective_date": "2026-04-01",
"note": "Q2 2026 rate.",
"created_time": "2026-03-01T09:00:00Z",
"updated_time": "2026-03-01T09:00:00Z"
}
]
}
Error codes
| Error Code | Error Message |
|---|---|
400001 | Invalid input(s) detected |