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

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