Required Minimum Distributions
Required Minimum Distribution (RMD) tools for retirement planning.
Provides tools for calculating RMDs, projecting RMD schedules, and understanding RMD tax implications.
calculate_required_minimum_distribution
Section titled “calculate_required_minimum_distribution”Calculate the Required Minimum Distribution for a retirement account.
| Parameter | Type | Default | Description |
|---|---|---|---|
prior_year_balance_cents |
int | required | Account balance as of December 31 of prior year, in cents (in SEPP mode, the balance on a date permitted by Notice 2022-6 § 3.02(d); see sepp_interest_rate) |
age |
int | required | Account owner’s age at end of current year |
table_type |
string | "uniform_lifetime" |
IRS table to use: ‘uniform_lifetime’ (default, for most owners), ‘joint_life’ (owner whose sole beneficiary is a spouse more than 10 years younger; requires beneficiary_age), or ‘single_life’ (for beneficiaries). In SEPP mode (sepp_interest_rate given), ‘joint_life’ may be used with any designated beneficiary |
beneficiary_age |
int | null | Spouse beneficiary’s age at end of current year (in SEPP mode, any designated beneficiary’s age). Required for, and only accepted with, table_type ‘joint_life’ |
sepp_interest_rate |
float | null | Annual interest rate (0.05 = 5%) for the 72(t) SEPP fixed amortization and fixed annuitization methods. Giving it adds a ‘sepp’ block with all three IRS Notice 2022-6 payments; omit it for a plain RMD. In SEPP mode age is the owner’s age on their birthday in the first distribution year, any age from the table’s first row is accepted (10 for Uniform Lifetime, 0 for Single Life and Joint Life), and the top-level RMD fields use the same life-expectancy table. In SEPP mode, pass as prior_year_balance_cents the account balance on a date permitted by Notice 2022-6 § 3.02(d), which need not be December 31 of the prior year |
sepp_midterm_rate_120_percent |
float | null | 120% of the federal mid-term rate (annual, e.g. 0.0612) for either of the two months before payments begin. When given, sepp_interest_rate is checked against the Notice 2022-6 cap, the greater of 5% and this figure. Only with sepp_interest_rate |
sepp_first_payment_date |
string | null | Date of the first SEPP payment (YYYY-MM-DD). With sepp_birth_date, adds the modification-period end date. Only with sepp_interest_rate |
sepp_birth_date |
string | null | Owner’s date of birth (YYYY-MM-DD), for the modification-period end date. Only with sepp_interest_rate |
Returns: rmd_amount_cents, rmd_amount_dollars, prior_year_balance_cents, prior_year_balance_dollars, distribution_period, age, beneficiary_age, table_type, and explanation.
check_rmd_required
Section titled “check_rmd_required”Check if RMDs are required for a specific tax year based on birth year.
| Parameter | Type | Default | Description |
|---|---|---|---|
birth_year |
int | required | Account owner’s birth year |
tax_year |
int | required | Tax year to check |
Returns whether RMDs are required and provides context about the requirement.
calculate_rmd_shortfall_penalty
Section titled “calculate_rmd_shortfall_penalty”Calculate the penalty for failing to take the full RMD.
| Parameter | Type | Default | Description |
|---|---|---|---|
required_rmd_cents |
int | required | Required RMD amount in cents |
actual_withdrawn_cents |
int | required | Amount actually withdrawn in cents |
corrected_within_two_years |
bool | false |
Whether the shortfall was corrected within the 2-year window |
Returns the shortfall amount and applicable penalty.
project_rmd_schedule
Section titled “project_rmd_schedule”Project future RMD requirements over multiple years.
| Parameter | Type | Default | Description |
|---|---|---|---|
birth_year |
int | required | Account owner’s birth year |
current_year |
int | required | Current tax year |
current_balance_cents |
int | required | Current account balance in cents |
years_to_project |
int | 20 |
Number of years to project |
annual_growth_rate |
float | 0.05 |
Expected annual growth rate (e.g., 0.05 = 5%) |
Returns yearly RMD amounts and cumulative totals.
calculate_aggregated_ira_rmds
Section titled “calculate_aggregated_ira_rmds”Calculate RMDs for multiple IRAs with aggregation.
| Parameter | Type | Default | Description |
|---|---|---|---|
ira_balances |
list | required | List of IRA accounts with balances. Each entry must have: ‘account_id’ (string identifier), ‘balance_cents’ (prior year-end balance). Example: [{‘account_id’: ‘ira1’, ‘balance_cents’: 50000000}] |
age |
int | required | Account owner’s age at end of current year |
Returns individual and total RMD amounts.