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

# Update Ultimate Beneficial Owner data

`PUT /v2/accounts/{accountId}/ultimateBeneficialOwner/{UltimateBeneficialOwnerId}`

## 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/{UltimateBeneficialOwnerId}`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

This method enables you to update information related to an Ultimate Beneficial Owner.

## Path parameters

- `accountId` string, required
- `UltimateBeneficialOwnerId` integer, required

## Headers

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

## Request body

- UpdateUltimateBeneficialOwnerInput
  - `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, required: Client Birthdate
  - `cityOfBirth` string, required: Client City of Birth
  - `countryOfBirth` string, required: Client Country of Birth (use ISO 3166-1 alpha-3 format)
  - `countryOfResidence` string: Country of Residence (use ISO 3166-1 alpha-3 format)
  - `isActive` boolean: Indicate if the UBO is active or not

## Response `200`

OK

- UpdateUltimateBeneficialOwnerOutput
  - `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.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)