Propose evidenced annual IRA/HSA limits and tax treatment for independent review

POST/retirement/rules

Fresh dedicated accounts:retirement:write staff authority. Reviewed authority/evidence hashes, annual limits, phaseout brackets and deadlines are explicit bank configuration; no legally approved values are seeded. expected_version orders proposals. Independent accounts:retirement:approve reviewer activates the immutable version at its effective date.

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

authority_refstringRequired

contribution_deadlinestring · dateRequired

A business date, YYYY-MM-DD

effective_atstring · date-timeRequired

evidence_refstringRequired

evidence_sha256stringRequired

excess_return_deadlinestring · dateRequired

A business date, YYYY-MM-DD

expected_versionintegerRequired

hsa_catchup_ageintegerRequired

hsa_catchup_minorintegerRequired

hsa_family_minorintegerRequired

hsa_self_minorintegerRequired

ira_annual_minorintegerRequired

ira_catchup_ageintegerRequired

ira_catchup_minorintegerRequired

ira_default_withholding_bpsintegerRequired

reasonstringRequired

roth_phaseoutsarray of objectsRequired

3 child attributes

end_minorintegerRequired

filing_statusstringRequired

start_minorintegerRequired

tax_yearintegerRequired

Returns

200 OK

decided_atstring · date-time or nullOptional

decided_bystringOptional

idstringRequired

proposed_atstring · date-timeRequired

proposed_bystringRequired

requestobjectRequired

18 child attributes

authority_refstringRequired

contribution_deadlinestring · dateRequired

A business date, YYYY-MM-DD

effective_atstring · date-timeRequired

evidence_refstringRequired

evidence_sha256stringRequired

excess_return_deadlinestring · dateRequired

A business date, YYYY-MM-DD

expected_versionintegerRequired

hsa_catchup_ageintegerRequired

hsa_catchup_minorintegerRequired

hsa_family_minorintegerRequired

hsa_self_minorintegerRequired

ira_annual_minorintegerRequired

ira_catchup_ageintegerRequired

ira_catchup_minorintegerRequired

ira_default_withholding_bpsintegerRequired

reasonstringRequired

roth_phaseoutsarray of objectsRequired

3 child attributes

end_minorintegerRequired

filing_statusstringRequired

start_minorintegerRequired

tax_yearintegerRequired

statusstringRequired

versionintegerRequired

Errors

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

400401403404409412413422424429500503