Corgi BankDocumentation
OpenAPI

Propose a classified cash contribution, distribution, excess return, original-receipt rollover or same-wrapper trustee transfer

POST/accounts/{id}/retirement-commands

Fresh dedicated retirement writer, then different retirement approver. Single-owner USD traditional/Roth IRA or HSA cash deposits only. Contribution, distribution, timely return_excess and rollover use the same consumer's ordinary bank account. trustee_transfer instead names a same-owner retirement destination with the identical wrapper/IRA type. Exact current eligibility/rule, owner instruction/policy evidence, account ownership and tax classification are rechecked. Rollovers name the actually executed original distribution, preserve its calendar receipt date, require current complete outside inventory, conserve original gross cash across bank/outside portions, and enforce the 60-day and one-year receipt windows. All IRAs share the IRA count. The bounded HSA flow accepts one complete return; traditional RMD-age sources, split HSA returns, waivers, inherited and external-custody cases refuse. A conversion instead requires a same-owner traditional-to-Roth cash pair, reviewed exact owner instruction/policy and zero-withholding election. Verified DOB and a reviewed effective RMD policy determine age; every supported required year needs current approved source-complete RMD clearance before conversion, even when the first-year deadline is deferred. Pre-2026 required-year history refuses until reconciled. Direct trustee transfers do not count as paid distributions or regular contributions. beneficiary_distribution uses separate death/contract/election/tax evidence: original pre-death traditional cash IRA title, one verified adult 100-percent beneficiary, death before RBD, and full cash settlement by the end of the following year. Current sole beneficiary destination ownership and active reviewed death restriction are required; native ledger locks enforce the entire actual source balance, with optional withholding. death_transfer, death_distribution and inherited_distribution instead move a deceased holder's cash under approved beneficiary classifications (see the classification route): a transfer moves the entire protected balance into same-wrapper separate accounts pro rata and reports nothing, an HSA that ceased at death is distributed with Form 1099-SA codes 4 or 6 and the date-of-death value, and an inherited distribution pays a beneficiary with Form 1099-R code 4. recharacterization moves an executed contribution and its reviewed net income to the owner's IRA of the other type by the reviewed return due date, reporting box 1, zero in box 2a and code N or R, with the receiving IRA's Form 5498 box 4 for the year it received the amount (Notice 2000-30, Example 2). custodian_transfer sends cash directly to a receiving trustee into the source's own plan type (receiving_plan_type; a conversion or another plan type refuses), credits the payments-in-transit liability and registers a payable for the payments remittance, reporting nothing; an inherited account may only move to an inherited title, an owner at the applicable age needs paid RMD clearance, and a final distribution year refuses. rollover may instead repay another custodian's evidenced distribution the owner received (outside_original), reported as a rollover receipt. custodian_transfer_in applies one actual wire or ACH receipt payments parked on transit for this protected account to an approved inbound transfer instruction the delivering custodian accepted: the receipt must come from the confirmed sending institution on the confirmed rail, quote the instruction's match reference, arrive on or after the custodian's distribution date and fit the reviewed maximum with the instruction's other receipts. It carries no eligibility, withholding or contribution attributes, claims the receipt at payments before posting, debits GL 2320 and credits the protected account, and reports nothing on Form 5498 or 5498-SA. Cash a traditional IRA custodian released in an earlier year needs the December 31 balance adjustment of 26 CFR 1.408-8(d), which is not serviced: such a transfer refuses when that year's requirement is already approved, and later requirement reviews for the year refuse while it stands.

Path parameters

idstringRequired

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

beneficiary_paymentobject or nullOptional

BeneficiaryPaymentEvidence supports full cash settlement to the sole adult individual named in the original IRA title, with death before the owner's RBD.

15 child attributes
authority_refstringRequired
authority_sha256stringRequired
authority_valid_untilstring · date-timeRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

death_report_idstringRequired

Example strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm

death_revisionintegerRequired
election_refstringRequired
election_sha256stringRequired
jurisdictionstringRequired
minimum_recipient_ageintegerRequired
policy_refstringRequired
policy_sha256stringRequired
restriction_idstringRequired
rmd_policy_idstringRequired
tax_rule_idstringRequired
conversionobject or nullOptional

ConversionEvidence authorizes only an immediate same-bank cash conversion. It does not authorize a recharacterization, inherited transfer or 60-day deposit.

7 child attributes
as_of_datestring · dateRequired

A business date, YYYY-MM-DD

authority_refstringRequired
instruction_refstringRequired
instruction_sha256stringRequired
policy_sha256stringRequired
rmd_policy_idstringRequired
rmd_review_idsarray of stringsOptional
custodianobject or nullOptional

CustodianTransferEvidence retains the successor trustee's acceptance of a direct transfer that involves no payment to the owner or beneficiary. ReceivingPlanType is the plan the successor trustee accepted into, which must be the source's own plan type.

14 child attributes
acceptance_refstringRequired
acceptance_sha256stringRequired
inheritance_idstringOptional
inherited_rmd_review_idstringOptional
inherited_titlebooleanRequired
instruction_refstringRequired
instruction_sha256stringRequired
payee_referencestringRequired
receiving_account_referencestringRequired
receiving_custodianstringRequired
receiving_plan_typestringRequired
receiving_title_sha256stringRequired
rmd_policy_idstringOptional
rmd_review_idsarray of stringsOptional
earnings_minorintegerOptional

Evidenced signed net income attributable, return_excess only

eligibility_idstringRequired
evidence_refstringRequired
evidence_sha256stringRequired
inbound_transferobject or nullOptional

InboundReceiptEvidence names the payments receipt a custodian_transfer_in applies.

3 child attributes
railstringRequired

Wire or ach

receipt_idstringRequired

Example achr_2tVh8nqLxq4GbDe0K1F6S9zRcWm

transfer_idstringRequired

Example acht_2tVh8nqLxq4GbDe0K1F6S9zRcWm

income_tax_yearintegerOptional

Return_excess income attribution, reviewed against tax code

inheritanceobject or nullOptional

InheritanceCommandEvidence authorizes death_transfer and death_distribution (every captured beneficiary in title order) and inherited_distribution (one).

8 child attributes
account_idsarray of stringsOptional
authority_refstringOptional
authority_sha256stringOptional
authority_valid_untilstring · date-timeRequired
inheritance_idsarray of stringsRequired
instruction_refstringRequired
instruction_sha256stringRequired
tax_rule_idstringOptional
kindstringRequired

Contribution, distribution, return_excess, rollover, trustee_transfer, conversion, beneficiary_distribution, death_transfer, death_distribution, inherited_distribution, recharacterization, custodian_transfer, custodian_transfer_in

medical_use_attestedbooleanOptional

Evidence only: trustee does not determine HSA expense deductibility

movementobject or nullOptional
10 child attributes
authority_refstringRequired
instruction_refstringRequired
instruction_sha256stringRequired
ordinary_owner_cash_onlybooleanRequired
outside_inventory_as_ofstring · dateOptional

A business date, YYYY-MM-DD

outside_inventory_completebooleanRequired
outside_originalobject or nullOptional

OutsideDistribution is another custodian's actual distribution that the owner received and is redepositing here, evidenced by that custodian's own statement.

8 child attributes
custodianstringRequired
distribution_datestring · dateRequired

A business date, YYYY-MM-DD

gross_minorintegerRequired
ira_typestringOptional
referencestringRequired
statement_refstringRequired
statement_sha256stringRequired
wrapperstringRequired
outside_rolloversarray of objectsOptional
6 child attributes
amount_minorintegerRequired
contribution_datestring · dateRequired

A business date, YYYY-MM-DD

distribution_datestring · dateRequired

A business date, YYYY-MM-DD

original_bank_command_idstringOptional
referencestringRequired
wrapperstringRequired
policy_sha256stringRequired
rmd_policy_idstringOptional
original_command_idstringOptional

The bank's original regular contribution

other_account_idstringRequired

Same-owner ordinary account; trustee_transfer/conversion name the protected destination

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

principal_minorintegerRequired
reasonstringRequired
recharacterizationobject or nullOptional

RecharacterizationEvidence retains the owner's election and the reviewed net income attributable; the trustee does not calculate that income here.

6 child attributes
authority_refstringRequired
earnings_refstringRequired
earnings_sha256stringRequired
instruction_refstringRequired
instruction_sha256stringRequired
policy_sha256stringRequired
tax_yearintegerRequired
withholding_bpsinteger or nullOptional

Nil uses reviewed traditional-IRA nonperiodic default

withholding_election_refstringOptional
withholding_election_sha256stringOptional

Returns

200 OK

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

cash_datestring · dateOptional

A business date, YYYY-MM-DD

conversion_rmdarray of objectsOptional
7 child attributes
bank_command_idsarray of stringsRequired
bank_paid_minorintegerRequired
outside_paid_minorintegerRequired
required_minorintegerRequired
review_idstringRequired
review_sha256stringRequired
tax_yearintegerRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decedent_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decided_atstring · date-time or nullOptional
decided_bystringOptional
distribution_codestringOptional
executed_atstring · date-time or nullOptional
gross_minorintegerRequired
idstringRequired
inbound_receiptobject or nullOptional

InboundReceipt is the matched receipt as the command relies on it.

12 child attributes
amount_minorintegerRequired
confirmation_idstringRequired
delivering_referencestringRequired
distribution_datestring · dateRequired

A business date, YYYY-MM-DD

outstanding_at_year_endbooleanRequired
railstringRequired
receipt_idstringRequired

Example achr_2tVh8nqLxq4GbDe0K1F6S9zRcWm

received_onstring · dateRequired

A business date, YYYY-MM-DD

referencestringRequired
sender_namestringRequired
sender_routingstringRequired
transfer_idstringRequired

Example acht_2tVh8nqLxq4GbDe0K1F6S9zRcWm

ira_typestringOptional
journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

origin_cash_datestring · dateOptional

A business date, YYYY-MM-DD

other_ownership_revisionintegerRequired
ownership_revisionintegerRequired
proposed_atstring · date-timeRequired
proposed_bystringRequired
recipientsarray of objectsOptional
7 child attributes
account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

amount_minorintegerRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

distribution_codestringOptional
inheritance_idstringRequired
ownership_revisionintegerRequired
share_bpsintegerRequired
requestobjectRequired
22 child attributes
beneficiary_paymentobject or nullOptional

BeneficiaryPaymentEvidence supports full cash settlement to the sole adult individual named in the original IRA title, with death before the owner's RBD.

15 child attributes
authority_refstringRequired
authority_sha256stringRequired
authority_valid_untilstring · date-timeRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

death_report_idstringRequired

Example strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm

death_revisionintegerRequired
election_refstringRequired
election_sha256stringRequired
jurisdictionstringRequired
minimum_recipient_ageintegerRequired
policy_refstringRequired
policy_sha256stringRequired
restriction_idstringRequired
rmd_policy_idstringRequired
tax_rule_idstringRequired
conversionobject or nullOptional

ConversionEvidence authorizes only an immediate same-bank cash conversion. It does not authorize a recharacterization, inherited transfer or 60-day deposit.

7 child attributes
as_of_datestring · dateRequired

A business date, YYYY-MM-DD

authority_refstringRequired
instruction_refstringRequired
instruction_sha256stringRequired
policy_sha256stringRequired
rmd_policy_idstringRequired
rmd_review_idsarray of stringsOptional
custodianobject or nullOptional

CustodianTransferEvidence retains the successor trustee's acceptance of a direct transfer that involves no payment to the owner or beneficiary. ReceivingPlanType is the plan the successor trustee accepted into, which must be the source's own plan type.

14 child attributes
acceptance_refstringRequired
acceptance_sha256stringRequired
inheritance_idstringOptional
inherited_rmd_review_idstringOptional
inherited_titlebooleanRequired
instruction_refstringRequired
instruction_sha256stringRequired
payee_referencestringRequired
receiving_account_referencestringRequired
receiving_custodianstringRequired
receiving_plan_typestringRequired
receiving_title_sha256stringRequired
rmd_policy_idstringOptional
rmd_review_idsarray of stringsOptional
earnings_minorintegerOptional

Evidenced signed net income attributable, return_excess only

eligibility_idstringRequired
evidence_refstringRequired
evidence_sha256stringRequired
inbound_transferobject or nullOptional

InboundReceiptEvidence names the payments receipt a custodian_transfer_in applies.

3 child attributes
railstringRequired

Wire or ach

receipt_idstringRequired

Example achr_2tVh8nqLxq4GbDe0K1F6S9zRcWm

transfer_idstringRequired

Example acht_2tVh8nqLxq4GbDe0K1F6S9zRcWm

income_tax_yearintegerOptional

Return_excess income attribution, reviewed against tax code

inheritanceobject or nullOptional

InheritanceCommandEvidence authorizes death_transfer and death_distribution (every captured beneficiary in title order) and inherited_distribution (one).

8 child attributes
account_idsarray of stringsOptional
authority_refstringOptional
authority_sha256stringOptional
authority_valid_untilstring · date-timeRequired
inheritance_idsarray of stringsRequired
instruction_refstringRequired
instruction_sha256stringRequired
tax_rule_idstringOptional
kindstringRequired

Contribution, distribution, return_excess, rollover, trustee_transfer, conversion, beneficiary_distribution, death_transfer, death_distribution, inherited_distribution, recharacterization, custodian_transfer, custodian_transfer_in

medical_use_attestedbooleanOptional

Evidence only: trustee does not determine HSA expense deductibility

movementobject or nullOptional
10 child attributes
authority_refstringRequired
instruction_refstringRequired
instruction_sha256stringRequired
ordinary_owner_cash_onlybooleanRequired
outside_inventory_as_ofstring · dateOptional

A business date, YYYY-MM-DD

outside_inventory_completebooleanRequired
outside_originalobject or nullOptional

OutsideDistribution is another custodian's actual distribution that the owner received and is redepositing here, evidenced by that custodian's own statement.

8 child attributes
custodianstringRequired
distribution_datestring · dateRequired

A business date, YYYY-MM-DD

gross_minorintegerRequired
ira_typestringOptional
referencestringRequired
statement_refstringRequired
statement_sha256stringRequired
wrapperstringRequired
outside_rolloversarray of objectsOptional
6 child attributes
amount_minorintegerRequired
contribution_datestring · dateRequired

A business date, YYYY-MM-DD

distribution_datestring · dateRequired

A business date, YYYY-MM-DD

original_bank_command_idstringOptional
referencestringRequired
wrapperstringRequired
policy_sha256stringRequired
rmd_policy_idstringOptional
original_command_idstringOptional

The bank's original regular contribution

other_account_idstringRequired

Same-owner ordinary account; trustee_transfer/conversion name the protected destination

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

principal_minorintegerRequired
reasonstringRequired
recharacterizationobject or nullOptional

RecharacterizationEvidence retains the owner's election and the reviewed net income attributable; the trustee does not calculate that income here.

6 child attributes
authority_refstringRequired
earnings_refstringRequired
earnings_sha256stringRequired
instruction_refstringRequired
instruction_sha256stringRequired
policy_sha256stringRequired
tax_yearintegerRequired
withholding_bpsinteger or nullOptional

Nil uses reviewed traditional-IRA nonperiodic default

withholding_election_refstringOptional
withholding_election_sha256stringOptional
statusstringRequired
taxable_minorinteger or nullOptional
taxable_undeterminedbooleanRequired
withheld_minorintegerRequired
wrapperstringRequired

Errors

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

400401403404409412413422424429500503

to move to open esc to close