Allocate an executed IRA distribution to an RMD obligation without cross-year double counting

POST/retirement/rmd-allocations

Independently reviewed gross allocation from an actually executed traditional IRA distribution, bound to its ledger receipt and paid date. All approved obligation years share the distribution gross cap, preventing first-year deferral double counting. Late payments can remedy a shortfall while status retains missed-deadline evidence.

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

amount_minorintegerRequired

command_idstringRequired

evidence_refstringRequired

evidence_sha256stringRequired

reasonstringRequired

review_idstringRequired

Returns

200 OK

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decided_atstring · date-time or nullOptional

decided_bystringOptional

idstringRequired

journal_idstringRequired

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

paid_onstring · dateRequired

A business date, YYYY-MM-DD

proposed_atstring · date-timeRequired

proposed_bystringRequired

requestobjectRequired

6 child attributes

amount_minorintegerRequired

command_idstringRequired

evidence_refstringRequired

evidence_sha256stringRequired

reasonstringRequired

review_idstringRequired

statusstringRequired

tax_yearintegerRequired

Errors

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

400401403404409412413422424429500503