List beneficiary classifications of a deceased holder's IRA or HSA

GET/accounts/{id}/retirement-inheritances

Path parameters

idstringRequired

Query parameters

afterstringOptional

Returns

200 OK

Errors

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

400401403404409412413422424429500503

Request

curl -X GET 'https://api.dev.bank.corgi.com/accounts/{id}/retirement-inheritances' \
  -H "Authorization: Bearer $TOKEN"

Response200

[
  {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "beneficiary_type": "string",
    "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "decedent_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "decided_at": "2026-09-17T14:30:00Z",
    "decided_by": "string",
    "destination_ownership_revision": 0,
    "id": "string",
    "ira_type": "string",
    "original_owner_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "ownership_revision": 0,
    "predecessor_inheritance_id": "string",
    "proposed_at": "2026-09-17T14:30:00Z",
    "proposed_by": "string",
    "request": {
      "beneficiary_index": 0,
      "category": "string",
      "contract_default_method": "string",
      "contract_permits_election": false,
      "contract_ref": "string",
      "contract_sha256": "string",
      "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "death_report_id": "strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "death_revision": 0,
      "destination_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "documentation_received": "2026-09-17",
      "documentation_ref": "string",
      "documentation_sha256": "string",
      "election": "string",
      "election_date": "2026-09-17",
      "election_ref": "string",
      "election_sha256": "string",
      "estate_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "evidence_ref": "string",
      "evidence_sha256": "string",
      "expected_version": 0,
      "jurisdiction": "string",
      "minimum_recipient_age": 0,
      "owner_rmd_review_id": "string",
      "policy_ref": "string",
      "policy_sha256": "string",
      "predecessor_rmd_review_id": "string",
      "reason": "string",
      "relationship_ref": "string",
      "relationship_sha256": "string",
      "restriction_id": "string",
      "rmd_policy_id": "string",
      "trust_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "trust_determination_ref": "string",
      "trust_determination_sha256": "string",
      "trust_instrument_ref": "string",
      "trust_instrument_sha256": "string"
    },
    "schedule": {
      "annual_distributions": false,
      "beneficiary_base_year": 0,
      "beneficiary_birth_date": "2026-09-17",
      "beneficiary_life": "string",
      "date_of_death": "2026-09-17",
      "death_year_entire_balance": false,
      "death_year_required_minor": 0,
      "died_before_required_beginning_date": false,
      "election_deadline": "2026-09-17",
      "eligible_designated": false,
      "final_distribution_year": 0,
      "first_distribution_year": 0,
      "majority_date": "2026-09-17",
      "method": "string",
      "owner_birth_date": "2026-09-17",
      "owner_date_of_death": "2026-09-17",
      "owner_life": false,
      "owner_required_age": 0,
      "predecessor_date_of_death": "2026-09-17",
      "required_beginning_date": "2026-09-17",
      "transfer_deadline": "2026-09-17"
    },
    "share_bps": 0,
    "status": "string",
    "title_shares": [
      0
    ],
    "version": 0,
    "wrapper": "string"
  }
]