PUT//////
Adds a single account to the specified interest tier.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the account, as returned by the POST /v4/depositaccounts endpoint.Allowable Values: Existing account token |
| 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 |
Response body
| Fields | Description |
|---|---|
| account_token string Returned | Unique identifier of the account, as returned by the POST /v4/depositaccounts endpoint.Allowable Values: Example: a1b2c3d4-e5f6-7890-abcd-ef123456789036 char max |
| interest_tier object Returned | The interest tier currently assigned to the account. Allowable Values: token, description, name, type, current_rate, default, created_time, updated_time |
| interest_tier.token string Conditionally returned | Unique identifier of the interest tier. Allowable Values: Example: 3f5e1b2a-8d4c-4e9b-a1f6-2c7d0e3b9a4536 char max |
| interest_tier.description string Conditionally returned | Human-readable description of the interest tier. Allowable Values: Example: Premium savings tier with higher interest rates. 255 char max |
| interest_tier.name string Conditionally returned | Display name of the interest tier. Allowable Values: Example: Premium Savings 255 char max |
| interest_tier.type string Conditionally returned | Account type associated with the interest tier. Allowable Values: CHECKING, SAVINGS |
| interest_tier.current_rate object Conditionally returned | The most recent rate with an effective date on or before today. Not included in responses from the create interest tier endpoint. Always present in retrieve and list responses. Allowable Values: note, account_rate, effective_rate, effective_date, created_time, updated_time |
| interest_tier.current_rate.note string Conditionally returned | Optional note describing the reason for the rate change. Allowable Values: Example: Q3 2026 rate adjustment. 255 char max |
| interest_tier.current_rate.account_rate decimal Conditionally returned | The gross interest rate, also known as the nominal interest rate. This is the base rate, calculated without compounding. Allowable Values: 0–100 |
| interest_tier.current_rate.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 |
| interest_tier.current_rate.effective_date string Conditionally returned | Date the rate takes effect. Allowable Values: Format: yyyy-MM-dd |
| interest_tier.current_rate.created_time datetime Conditionally 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 |
| interest_tier.current_rate.updated_time datetime Conditionally 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 |
| interest_tier.default boolean Conditionally returned | A value of true indicates this is the default tier for its account type.Allowable Values: Example: truetrue, false |
| interest_tier.created_time datetime Conditionally returned | Date and time when the interest tier was created, in UTC. Allowable Values: Example: 2026-01-15T09:00:00Z Format: yyyy-MM-ddThh:mm:ssZ |
| interest_tier.updated_time datetime Conditionally returned | Date and time when the interest tier was last updated, in UTC. Allowable Values: Example: 2026-06-01T12:00:00Z Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"account_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"interest_tier": {
"token": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "Standard Checking",
"description": "Standard interest tier for checking accounts.",
"type": "CHECKING",
"default": true,
"created_time": "2026-01-15T09:00:00Z",
"updated_time": "2026-06-01T12:00:00Z",
"current_rate": {
"account_rate": 3.75,
"effective_rate": 3.82,
"effective_date": "2026-07-01",
"created_time": "2026-06-01T12:00:00Z",
"updated_time": "2026-06-01T12:00:00Z"
}
}
}
Error codes
| Error Code | Error Message |
|---|---|
404000 | Resource not found |
404004 | Cardholder not found by token |
404917 | Program not configured for interest. |
500000 | Internal server error |