---
title: "Create an Ultimate Beneficial Owner"
method: POST
path: "/v2/accounts/{accountId}/ultimateBeneficialOwner"
tags: ["Accounts | Create & KYC"]
---

# Create an Ultimate Beneficial Owner

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

The method enables you to link an Ultimate Beneficial Owner to a legal payment account.  
To be validated all Legal accounts need to provide their Ultimate Beneficial Owner information.  
An Ultimate Beneficial Owner is a natural person that owns directly or indirectly (i.e. through another entity)  
more than 25% of the shares/stock or voting rights of the legal entity, or a person having significant control over it   
through other means. Any company established in EEA or EU is obliged to obtain and maintain this information with the competent   
central register (as per article 30 of Directive 2015/843/EU).   
Similar requirements may also exist in other countries.  
In order to comply with AML-CTF legal provisions, payment institutions are required  
to identify the beneficial owner(s) of a legal entity(i.e.a company or an organisation).  
If the Legal Representative is also an Ultimate Beneficial Owner,  you can specify this information when creating or updating a legal account.

## Path parameters

- `accountId` string, required

## Headers

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

## Request body

- AddUltimateBeneficialOwnerInput
  - `firstName` string, required — Client First Name
  - `lastName` string, required — 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)

## Response `200`

OK

- AddUltimateBeneficialOwnerOutput
  - `ultimateBeneficialOwnerId` integer
  - `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)