Corgi BankDocumentation
OpenAPI

Propose receiving a direct trustee-to-trustee transfer from another custodian for independent review

POST/accounts/{id}/retirement-inbound-transfers

Fresh dedicated retirement writer, then a different retirement approver. Reviews receiving a direct trustee-to-trustee transfer of cash from another IRA or HSA custodian into this open single-owner protected account: the delivering custodian, the routing number it sends cash from, its account reference, plan type and title hash, the holder, the signed transfer request, this bank's acceptance, the reviewed policy, a full or partial scope with the expected amount and a reviewed maximum, and an expiry within 180 days. A direct transfer keeps its plan type: a traditional or Roth IRA into the same IRA type, an HSA or Archer MSA into an HSA, and another trustee's inherited traditional IRA only into the inherited IRA already classified here for the same decedent and beneficiary and funded by its death transfer. SEP and SIMPLE plans, conversions and IRA-to-HSA funding distributions refuse. The response carries the fifteen-character match_reference the delivering custodian quotes on the cash. It is not a contribution or a rollover.

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

acceptance_refstringRequired
acceptance_sha256stringRequired
authority_refstringRequired
customer_idstringRequired

The owner, or the beneficiary of an inherited IRA

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decedent_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

delivering_account_referencestringRequired
delivering_custodianstringRequired
delivering_plan_typestringRequired
delivering_routing_numberstringRequired
delivering_title_sha256stringRequired
evidence_refstringRequired
evidence_sha256stringRequired
expected_minorintegerRequired
expires_onstring · dateRequired

A business date, YYYY-MM-DD

inheritance_idstringOptional
instruction_refstringRequired
instruction_sha256stringRequired
maximum_minorintegerRequired
policy_sha256stringRequired
reasonstringRequired
transfer_scopestringRequired

Full or partial

Returns

200 OK

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

confirmationobject or nullOptional

InboundTransferConfirmation retains the request sent to the delivering custodian and its answer. Simulated is carried from the answer: a simulator's confirmation never claims to be a real custodian's.

8 child attributes
account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

confirmation_sha256stringRequired
custodian_confirmationobjectRequired

Confirmation is the delivering custodian's validation or exception. Simulated is true for every confirmation the simulator produces and must be false from a certified integration.

11 child attributes
amount_minorintegerOptional
delivering_referencestringOptional
delivering_routing_numberstringOptional
delivery_methodstringOptional
distribution_datestring · dateRequired

A business date, YYYY-MM-DD

exception_codestringOptional
exception_reasonstringOptional
request_idstringRequired

Example req_2tVh8nqLxq4GbDe0K1F6S9zRcWm

settlement_datestring · dateRequired

A business date, YYYY-MM-DD

simulatedbooleanRequired
statusstringRequired

Accepted or rejected

custodian_requestobjectRequired

Request is what the receiving custodian sends.

13 child attributes
account_holder_namestringRequired
amount_minorintegerOptional
authorization_sha256stringRequired
decedent_namestringOptional
delivering_account_referencestringRequired
match_referencestringRequired
plan_typestringRequired
receiving_account_numberstringRequired
receiving_account_titlestringRequired
receiving_institutionstringRequired
receiving_routing_numberstringRequired
request_idstringRequired

Example req_2tVh8nqLxq4GbDe0K1F6S9zRcWm

transfer_scopestringRequired

Full or partial

idstringRequired
recorded_atstring · date-timeRequired
requested_bystringRequired
transfer_idstringRequired

Example acht_2tVh8nqLxq4GbDe0K1F6S9zRcWm

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decedent_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decided_atstring · date-time or nullOptional
decided_bystringOptional
idstringRequired
ira_typestringOptional
match_referencestringRequired
ownership_revisionintegerRequired
proposed_atstring · date-timeRequired
proposed_bystringRequired
requestobjectRequired

InboundTransferRequest is a reviewed instruction to receive a direct trustee-to-trustee transfer of cash from another custodian into this protected account. It is not a contribution or a rollover: nothing is reported on Form 5498 or 5498-SA for it.

21 child attributes
acceptance_refstringRequired
acceptance_sha256stringRequired
authority_refstringRequired
customer_idstringRequired

The owner, or the beneficiary of an inherited IRA

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decedent_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

delivering_account_referencestringRequired
delivering_custodianstringRequired
delivering_plan_typestringRequired
delivering_routing_numberstringRequired
delivering_title_sha256stringRequired
evidence_refstringRequired
evidence_sha256stringRequired
expected_minorintegerRequired
expires_onstring · dateRequired

A business date, YYYY-MM-DD

inheritance_idstringOptional
instruction_refstringRequired
instruction_sha256stringRequired
maximum_minorintegerRequired
policy_sha256stringRequired
reasonstringRequired
transfer_scopestringRequired

Full or partial

statusstringRequired
versionintegerRequired
wrapperstringRequired

Errors

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

400401403404409412413422424429500503

to move to open esc to close