---
title: "Update a beneficial owner"
method: PATCH
path: "/beneficial-owners/{beneficialOwnerId}"
tags: ["KYC/KYB Verifications"]
---

# Update a beneficial owner

`PATCH /beneficial-owners/{beneficialOwnerId}`

Update details of a specific beneficial owner. Only provided fields are updated.

## Path parameters

- `beneficialOwnerId` string, required

## Request body

- BeneficialOwnerUpdateRequest
  - `roles` BeneficialOwnerRole[] — Roles of this person within the business
  - `ownershipPercentage` integer — Percentage of ownership in the business (0-100)
  - `personalInfo` BeneficialOwnerPersonalInfoUpdate — Partial update for beneficial owner personal information. Only provided fields are updated.
    - `firstName` string — First name of the individual
    - `middleName` string — Middle name of the individual
    - `lastName` string — Last name of the individual
    - `birthDate` string, date — Date of birth in ISO 8601 format (YYYY-MM-DD)
    - `nationality` string — Country of nationality (ISO 3166-1 alpha-2)
    - `email` string, email — Email address of the individual
    - `phoneNumber` string — Phone number in E.164 format
    - `address` Address
      - `line1` string, required — Street address line 1
      - `line2` string — Street address line 2
      - `city` string — City
      - `state` string — State/Province/Region
      - `postalCode` string, required — Postal/ZIP code
      - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `idType` 'SSN' | 'ITIN' | 'EIN' | 'NON_US_TAX_ID' — Type of tax identification
    - `identifier` string — The identification number or value
    - `countryOfIssuance` string — Country that issued the identification (ISO 3166-1 alpha-2)

## Response `200`

Beneficial owner updated successfully

- BeneficialOwner
  - `id` string, required — Unique identifier for this beneficial owner
  - `customerId` string, required — The ID of the business customer this beneficial owner is associated with
  - `roles` BeneficialOwnerRole[], required — Roles of this person within the business
  - `ownershipPercentage` integer, required — Percentage of ownership in the business (0-100)
  - `personalInfo` BeneficialOwnerPersonalInfo, required
    - `firstName` string, required — First name of the individual
    - `middleName` string — Middle name of the individual
    - `lastName` string, required — Last name of the individual
    - `birthDate` string, date, required — Date of birth in ISO 8601 format (YYYY-MM-DD)
    - `nationality` string, required — Country of nationality (ISO 3166-1 alpha-2)
    - `email` string, email — Email address of the individual
    - `phoneNumber` string — Phone number in E.164 format
    - `address` Address, required
      - `line1` string, required — Street address line 1
      - `line2` string — Street address line 2
      - `city` string — City
      - `state` string — State/Province/Region
      - `postalCode` string, required — Postal/ZIP code
      - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `idType` 'SSN' | 'ITIN' | 'EIN' | 'NON_US_TAX_ID', required — Type of tax identification
    - `identifier` string, required — The identification number or value
    - `countryOfIssuance` string — Country that issued the identification (ISO 3166-1 alpha-2)
  - `kycStatus` 'UNVERIFIED' | 'PENDING' | 'APPROVED' | 'REJECTED', required — The current KYC status of a customer
  - `createdAt` string, date-time, required — When this beneficial owner was created
  - `updatedAt` string, date-time — When this beneficial owner was last updated

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized
- `404` — Beneficial owner not found
- `500` — Internal service error

---

[API](https://skmtc.net/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.net/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/versions/d0bce562bffd/schema)