---
title: "Retrieve Account Beneficiaries"
method: GET
path: "/accounts/{accountID}/beneficiaries"
tags: ["Beneficiaries"]
---

# Retrieve Account Beneficiaries

`GET /accounts/{accountID}/beneficiaries`

Retrieves a list of Account Beneficiaries by accountID.

## Path parameters

- `accountID` string, required — The user's unique account identifier.

## Response `200`

Retrieving a list of Account Beneficiaries was Successful.

- BeneficiaryRes
  - `primary` BeneficiariesResObject[] — An array of objects containing the primary beneficiary details
    - `type` 'PERSON' | 'ENTITY' — Type of beneficiary.
    - `name` string — Full name or entity name of type.
    - `percentage` number — Percentage ownership beneficiary has in the account. Must total 1 (aka 100%) across all beneficiaries.
    - `dob` string — Date of birth of the beneficiary. Only required if type: `PERSON`.
    - `email` string — The email of the entity.
    - `formationDate` string — Entity formation date. Must follow the YYYY-MM-DD format. Only required if type: `ENTITY`.
    - `primaryContact` string — Primary phone contact of entity. Only required if type: `ENTITY`
    - `phone` string — Phone number of beneficiary.
    - `created` string — The when the beneficiary was added to the account.
    - `address` string — Address of the beneficiary.
    - `relationship` 'Trust' | 'Organization' | 'Spouse' | 'Children' | 'Grandchildren' | 'Parents' | 'Other' — Relationship to account holder. For ENTITY type: Trust, Organization. For PERSON type: Spouse, Children, Grandchildren, Parents, Other.
    - `idType` 'SSN' | 'EIN' | 'FTIN' | 'OTHER' — Type of identification. For ENTITY type: EIN, FTIN, OTHER. For PERSON type: SSN, FTIN, OTHER.
    - `idNo` string — Identification number. For SSN and EIN, must be 9 digit numbers only.
    - `citizenship` string — Citizenship in ISO3 format (3-letter country code). Only required if type: `PERSON`.
    - `formationCountry` string — Country of formation in ISO3 format (3-letter country code). Only required if type: `ENTITY`.
    - `documentID` string — Document identification number. Only valid if type: `PERSON`.
  - `contingent` BeneficiariesResObject[] — An array of objects containing the contingent beneficiary details.
    - `type` 'PERSON' | 'ENTITY' — Type of beneficiary.
    - `name` string — Full name or entity name of type.
    - `percentage` number — Percentage ownership beneficiary has in the account. Must total 1 (aka 100%) across all beneficiaries.
    - `dob` string — Date of birth of the beneficiary. Only required if type: `PERSON`.
    - `email` string — The email of the entity.
    - `formationDate` string — Entity formation date. Must follow the YYYY-MM-DD format. Only required if type: `ENTITY`.
    - `primaryContact` string — Primary phone contact of entity. Only required if type: `ENTITY`
    - `phone` string — Phone number of beneficiary.
    - `created` string — The when the beneficiary was added to the account.
    - `address` string — Address of the beneficiary.
    - `relationship` 'Trust' | 'Organization' | 'Spouse' | 'Children' | 'Grandchildren' | 'Parents' | 'Other' — Relationship to account holder. For ENTITY type: Trust, Organization. For PERSON type: Spouse, Children, Grandchildren, Parents, Other.
    - `idType` 'SSN' | 'EIN' | 'FTIN' | 'OTHER' — Type of identification. For ENTITY type: EIN, FTIN, OTHER. For PERSON type: SSN, FTIN, OTHER.
    - `idNo` string — Identification number. For SSN and EIN, must be 9 digit numbers only.
    - `citizenship` string — Citizenship in ISO3 format (3-letter country code). Only required if type: `PERSON`.
    - `formationCountry` string — Country of formation in ISO3 format (3-letter country code). Only required if type: `ENTITY`.
    - `documentID` string — Document identification number. Only valid if type: `PERSON`.

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)