New service | **Last updated**: 14 May 2025

Important
This documentation is for preview purposes only.

# Manage beneficial owners

A beneficial owner record is used to store the details about a specific beneficial owner. The purpose is to be able to perform [identity verification](/products/parties/verify-parties) checks for companies.

br
details
summary
b
Who is a beneficial owner?
A beneficial owner can be anyone with ownership percentage of the company, managing directors, or any person with in a managing and/or controlling role, as stated in public records for the company. This record is very important from an [identity verification](/products/parties/verify-parties) perspective of a company and should match publicly stated records for that company. This is to ensure highest probability of a successful [identity verification](/products/parties/verify-parties) process.

You can add details of people (`person` in the API) that are beneficial owners of the company to your `party` record.

Note
Only add persons as beneficial owners. If your company additionally has beneficial owners that are also companies, proceed to identity verification with only persons as beneficial owners. You will be contacted by our Operations team to complete application in next stages. 
The ability to add details for beneficial owners that are companies is **coming soon**.

br
You can add a beneficial owner in two ways. Either **during** or **after** the creation of a party. This guide focuses on adding a beneficial owner **after** the party creation call.

br
To add a beneficial owner **during** [orchestrated party creation call](/products/parties/create-party#orchestrated-party-creation), you can use the `https://access.worldpay-bsh.securedataplatform.com/parties` endpoint.

## Add beneficial owners

**After** a party of type [company](/products/parties/create-party#create-a-party) is created, you can add beneficial owner details by using following endpoint:


`POST` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/beneficialOwner`

br
#### Request/response example

See full [schema](/products/parties/openapi/beneficial-owners/createbeneficialowner) to create a beneficial owner.

## View a beneficial owner

View information of a beneficial owner, previously created.

br
`GET` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/beneficialOwner/{beneficialOwnerId}`

br
* `beneficialOwnerId` - you have received this in the [beneficial owner creation response](#add-a-beneficial-owner). It uniquely identifies your payout instrument in our system.


#### Request example

See full [schema](/products/parties/openapi/beneficial-owners/getbeneficialowner) to view a beneficial owner.

## Modify a beneficial owner

You can modify certain beneficial owner information previously created by calling the following endpoint:

br
`PUT` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/beneficialOwner/{beneficialOwnerId}`

br
* `beneficialOwnerId` - you have received this in the [beneficial owner creation response](#add-a-beneficial-owner). It uniquely identifies your payout instrument in our system.
* `partyId` - you have received this in the [party creation response](/products/parties/create-party). It uniquely identifies your payout instrument in our system.


#### Request/response example

See full [schema](/products/parties/openapi/beneficial-owners/updatebeneficialowner) to modify a beneficial owner.

## Delete a beneficial owner

You can delete a beneficial owner from the company record:

`DELETE` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/beneficialOwner/{beneficialOwnerId}`

#### Request/response example

See full [schema](/products/parties/openapi/beneficial-owners/deletebeneficialowner) to delete a beneficial owner.

#### Next steps

[Add a payout instrument](/products/parties/payout-instruments)
[Add balance accounts](/products/parties/balance-accounts) or 
[Verify a party](/products/parties/verify-parties)