---
title: "Update a beneficial owner"
method: PATCH
path: "/businesses/{business_id}/beneficial_owners/{beneficial_owner_id}"
tags: ["Beneficial owners"]
---

# Update a beneficial owner

`PATCH /businesses/{business_id}/beneficial_owners/{beneficial_owner_id}`

## Request

- Base URL: `https://sandbox.bond.tech/api/v0`
- URL: `https://sandbox.bond.tech/api/v0/businesses/{business_id}/beneficial_owners/{beneficial_owner_id}`
- Auth: API key in header `Identity` and API key in header `Authorization`

Updates a beneficial owner associated with a business

## Path parameters

- `business_id` string, required
- `beneficial_owner_id` string, required

## Request body

- BeneficialOwnerPatchSerializer
  - `dob` string, string: Date of birth in YYYY-MM-DD format.
  - `first_name` string: First name.<br />Has a 1 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `middle_name` string: Middle name.<br />Has a 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `last_name` string: Last name.<br />Has a 2 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.

## Response `200`

Example response

- object
  - `first_name` string, required
  - `last_name` string, required
  - `dob` string, required
  - `address` object[], required
    - `address_type` string, required
    - `street` string, required
    - `street2` string, required
    - `city` string, required
    - `state` string, required
    - `zip_code` string, required
    - `country` string, required
    - `is_primary` boolean, required

---

[API](https://skmtc.dev/bond/apis/customer.md) - [All operations](https://skmtc.dev/bond/apis/customer/llms.txt) - [OpenAPI document](https://skmtc.dev/bond/apis/customer/revisions/62f5ac53144d?raw)