---
title: "Get all Ultimate Beneficial Owners associated to a payment account."
method: GET
path: "/v2/accounts/{accountId}ultimateBeneficialOwner"
tags: ["Accounts | Create & KYC"]
---

# Get all Ultimate Beneficial Owners associated to a payment account.

`GET /v2/accounts/{accountId}ultimateBeneficialOwner`

This method enables you get all the Ultimate Beneficial Owners associated to a legal payment account.

## Path parameters

- `accountId` string, required

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Response `200`

OK

- GetUltimateBeneficialOwnerOutput
  - `ultimateBeneficialOwners` UltimateBeneficialOwner[]
    - `firstname` string — Client First Name
    - `lastname` string — Client Last Name
    - `nationality` string — Client Nationality (use ISO 3166-1 alpha-3 format)
    - `dateOfBirth` string — Client Birthdate
    - `cityOfBirth` string — Client City of Birth
    - `countryOfBirth` string — Client Country of Birth (use ISO 3166-1 alpha-3 format)
    - `countryOfResidence` string — Country of Residence (use ISO 3166-1 alpha-3 format)
    - `startDate` integer
    - `endDate` integer
    - `ultimateBeneficialOwnerId` integer — Ultimate Beneficial Owner ID
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string — Get the Error Message from PSP

## Other responses

- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)