Classify one captured beneficiary and fix the inherited distribution schedule for independent review
/accounts/{id}/retirement-inheritancesFresh dedicated retirement writer, then a different retirement approver. Classifies one captured beneficiary of a deceased holder's traditional cash IRA or HSA: the confirmed death report/revision, an active independently approved death restriction retaining the original title, the reviewed contract and jurisdiction recipient-age policy, and category evidence (marriage or parentage; dated disability or chronic-illness documentation already received, which 26 CFR 1.408-8(b)(4)(i) does not hold to the plan-administrator October 31 deadline for an IRA). Verified dates of birth decide whether the beneficiary is not more than ten years younger, a minor child, or a designated beneficiary who is not eligible; a classification that disagrees with them refuses. The schedule is fixed here: life expectancy (a spouse's recalculated, with the owner's applicable-age delay), the 10-year rule with annual amounts where the owner died on or after the required beginning date, the 5-year rule or the owner's remaining life expectancy for an estate or a trust the reviewer determined is not a see-through trust (retaining the trust instrument, the determination and the trust entity's own cash account), a spouse's treat-as-own election, HSA spouse succession or an HSA that ceased at death. Death on or after the required beginning date names the owner's approved RMD review for the year of death (which may be made after death is confirmed) and allocates what the owner had not taken to this beneficiary as death_year_required_minor, by the IRA's share of the owner's requirement and the captured beneficiary shares; a successor takes the predecessor's unpaid inherited requirement the same way, or the entire interest when it was due that year. A sole spouse of an owner who died before the required beginning date who dies before distributions were required to commence refuses as the owner's case. Inherited Roth IRAs, see-through trusts, charities, foreign and under-age recipients, contract default beneficiaries and establishment after the year following death refuse.
Path parameters
idstringRequiredHeaders
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
beneficiary_indexintegerRequiredcategorystringRequiredcontract_default_methodstringOptionalcontract_permits_electionbooleanOptionalcontract_refstringRequiredcontract_sha256stringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
death_report_idstringRequiredExample strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm
death_revisionintegerRequireddestination_account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
documentation_receivedstring · dateRequiredA business date, YYYY-MM-DD
documentation_refstringOptionaldocumentation_sha256stringOptionalelectionstringOptionalelection_datestring · dateRequiredA business date, YYYY-MM-DD
election_refstringOptionalelection_sha256stringOptionalestate_account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
evidence_refstringRequiredevidence_sha256stringRequiredexpected_versionintegerRequiredjurisdictionstringRequiredminimum_recipient_ageintegerRequiredowner_rmd_review_idstringOptionalpolicy_refstringRequiredpolicy_sha256stringRequiredpredecessor_rmd_review_idstringOptionalreasonstringRequiredrelationship_refstringOptionalrelationship_sha256stringOptionalrestriction_idstringRequiredrmd_policy_idstringOptionaltrust_account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
trust_determination_refstringOptionaltrust_determination_sha256stringOptionaltrust_instrument_refstringOptionaltrust_instrument_sha256stringOptionalReturns
200 OK
account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
beneficiary_typestringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
decedent_customer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
decided_atstring · date-time or nullOptionaldecided_bystringOptionaldestination_ownership_revisionintegerRequiredidstringRequiredira_typestringOptionaloriginal_owner_customer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
ownership_revisionintegerRequiredpredecessor_inheritance_idstringOptionalproposed_atstring · date-timeRequiredproposed_bystringRequiredrequestobjectRequiredInheritanceRequest classifies one beneficiary interest captured in the original title of a deceased holder's cash IRA or HSA.
37 child attributes
beneficiary_indexintegerRequiredcategorystringRequiredcontract_default_methodstringOptionalcontract_permits_electionbooleanOptionalcontract_refstringRequiredcontract_sha256stringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
death_report_idstringRequiredExample strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm
death_revisionintegerRequireddestination_account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
documentation_receivedstring · dateRequiredA business date, YYYY-MM-DD
documentation_refstringOptionaldocumentation_sha256stringOptionalelectionstringOptionalelection_datestring · dateRequiredA business date, YYYY-MM-DD
election_refstringOptionalelection_sha256stringOptionalestate_account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
evidence_refstringRequiredevidence_sha256stringRequiredexpected_versionintegerRequiredjurisdictionstringRequiredminimum_recipient_ageintegerRequiredowner_rmd_review_idstringOptionalpolicy_refstringRequiredpolicy_sha256stringRequiredpredecessor_rmd_review_idstringOptionalreasonstringRequiredrelationship_refstringOptionalrelationship_sha256stringOptionalrestriction_idstringRequiredrmd_policy_idstringOptionaltrust_account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
trust_determination_refstringOptionaltrust_determination_sha256stringOptionaltrust_instrument_refstringOptionaltrust_instrument_sha256stringOptionalscheduleobjectRequiredInheritanceSchedule is the distribution rule fixed at classification. Life expectancies are read from the reviewed Single Life Table for each year.
21 child attributes
annual_distributionsbooleanRequiredbeneficiary_base_yearintegerOptionalbeneficiary_birth_datestring · dateRequiredA business date, YYYY-MM-DD
beneficiary_lifestringOptionalFixed or recalculated
date_of_deathstring · dateRequiredA business date, YYYY-MM-DD
death_year_entire_balancebooleanOptionaldeath_year_required_minorintegerOptionalDeathYearRequiredMinor is this beneficiary's allocated share of the requirement for the year of death that the deceased holder had not taken; DeathYearEntireBalance marks a successor whose predecessor's entire interest was due in that year.
died_before_required_beginning_datebooleanRequiredelection_deadlinestring · dateRequiredA business date, YYYY-MM-DD
eligible_designatedbooleanRequiredfinal_distribution_yearintegerOptionalfirst_distribution_yearintegerOptionalmajority_datestring · dateRequiredA business date, YYYY-MM-DD
methodstringRequiredowner_birth_datestring · dateRequiredA business date, YYYY-MM-DD
owner_date_of_deathstring · dateRequiredA business date, YYYY-MM-DD
owner_lifebooleanOptionalowner_required_ageintegerOptionalpredecessor_date_of_deathstring · dateRequiredA business date, YYYY-MM-DD
required_beginning_datestring · dateRequiredA business date, YYYY-MM-DD
transfer_deadlinestring · dateRequiredA business date, YYYY-MM-DD
share_bpsintegerRequiredstatusstringRequiredtitle_sharesarray of integersRequiredversionintegerRequiredwrapperstringRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503