Skip to content

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 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 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 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 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 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.