Retirement

Compute a Required Minimum Distribution

Computes the Required Minimum Distribution from tax-deferred retirement accounts: the prior-year-end balance divided by the IRS Uniform Lifetime Table distribution period for the owner's age. The beginning age follows SECURE 2.0 (73, or 75 for those born 1960 or later). Uses the Uniform Lifetime Table only; the Joint Life and Single Life tables are not modeled. Calculation engine output, not tax advice. Deterministic.

post/v1/retirement/rmd

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/retirement/rmd
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

ageinteger required

Owner's age at the end of the distribution year.

account_balancenumber required

Prior-year-end balance of tax-deferred accounts.

birth_yearinteger

Optional. Sets the SECURE 2.0 beginning age (73, or 75 if born 1960+). Defaults to a beginning age of 73 if omitted.

table'uniform' | 'single' | 'joint'

Optional distribution-period table. "uniform" (default) is the owner's own RMD; "single" is the Single Life Table for beneficiary/inherited accounts (not gated by the SECURE 2.0 beginning age); "joint" is the Joint and Last Survivor Table for an owner whose sole beneficiary is a spouse more than 10 years younger (requires second_age).

second_ageinteger

The sole spousal beneficiary's age. Required when table=joint.

Example request

{
  "age": 73,
  "account_balance": 1000000,
  "birth_year": 1953
}

Response

RMD result

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "rmd_1a2b3c4d5e6f7a8b",
  "engine_version": "rmd-1.0.0",
  "inputs": {
    "age": 73,
    "account_balance": 1000000,
    "birth_year": 1953
  },
  "result": {
    "beginning_age": 73,
    "distribution_period": 26.5
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.