---
title: "List Beneficiaries"
method: GET
path: "/beneficiary/{customerId}"
---

# List Beneficiaries

`GET /beneficiary/{customerId}`

List all existing beneficiaries on an account

## Path parameters

- `customerId` string, required

## Headers

- `api-key` string, required
- `auth-key` string

## Response `200`

200

- object
  - `status` integer
  - `doc` object[]
    - `stoBeneficiaryId` string
    - `stoUserName` string
    - `isPrimary` boolean
    - `beneficiaryType` string
    - `beneficiaryName` string
    - `benefitPct` string
    - `beneficiaryPhone` string
    - `beneficiaryEmail` string
    - `primaryContact` string
    - `formationDt` string

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/stockal/apis/uat-client-api-v2.md) · [All operations](https://skmtc.net/stockal/apis/uat-client-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockal/uat-client-api-v2/versions/08e36bbbd3be/schema)