Propose annual RMD age cohorts and uniform-lifetime divisors for independent review

POST/retirement/rmd-policies

Fresh retirement writer then independent retirement approver. Explicit reviewed annual birth cohorts, commencement ages and uniform-lifetime divisors; no production legally approved table is seeded. Inherited/joint-life and statutory relief cases require separate workflows.

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

annual_deadlinestring · dateRequired

A business date, YYYY-MM-DD

authority_refstringRequired

cohortsarray of objectsRequired

3 child attributes

birth_year_fromintegerRequired

birth_year_throughintegerRequired

required_ageintegerRequired

effective_atstring · date-timeRequired

evidence_refstringRequired

evidence_sha256stringRequired

expected_versionintegerRequired

first_year_deadlinestring · dateRequired

A business date, YYYY-MM-DD

reasonstringRequired

single_lifearray of objectsOptional

2 child attributes

ageintegerRequired

tenthsintegerRequired

tax_yearintegerRequired

uniform_lifetimearray of objectsRequired

2 child attributes

ageintegerRequired

tenthsintegerRequired

Returns

200 OK

decided_atstring · date-time or nullOptional

decided_bystringOptional

idstringRequired

proposed_atstring · date-timeRequired

proposed_bystringRequired

requestobjectRequired

12 child attributes

annual_deadlinestring · dateRequired

A business date, YYYY-MM-DD

authority_refstringRequired

cohortsarray of objectsRequired

3 child attributes

birth_year_fromintegerRequired

birth_year_throughintegerRequired

required_ageintegerRequired

effective_atstring · date-timeRequired

evidence_refstringRequired

evidence_sha256stringRequired

expected_versionintegerRequired

first_year_deadlinestring · dateRequired

A business date, YYYY-MM-DD

reasonstringRequired

single_lifearray of objectsOptional

2 child attributes

ageintegerRequired

tenthsintegerRequired

tax_yearintegerRequired

uniform_lifetimearray of objectsRequired

2 child attributes

ageintegerRequired

tenthsintegerRequired

statusstringRequired

versionintegerRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503