---
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`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/accounts/{accountId}ultimateBeneficialOwner`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

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, required: Client First Name
    - `lastname` string, required: Client Last Name
    - `nationality` string, required: Client Nationality (use ISO 3166-1 alpha-3 format)
    - `dateOfBirth` string, required: Client Birthdate
    - `cityOfBirth` string: Client City of Birth
    - `countryOfBirth` string: Client Country of Birth (use ISO 3166-1 alpha-3 format)
    - `countryOfResidence` string, required: 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.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)