Update an owner

Updates the ownership details of an owner, such as the ownership percentage or title. To change the person's own details, such as their name or address, update the individual instead.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID of the business, for example bus_3f8a2c71-9d4e-4b6a-8f15-6c2e9a7b4d10.

string
required

ID of the owner, for example bo_9e4a1c73-5d8b-4f21-b6e9-7a3c0d2f5b18.

Body Params

Ownership details to update. Send only the fields you want to change.

number
0 to 100

Share of the business this person owns, from 0 to 100, with up to two decimal places. The total across all owners cannot exceed 100. For government, nonprofit and tax-exempt businesses, use 0.

boolean

Set to true for the one person who has significant control over the business, such as the CEO or managing member. Exactly one owner or signatory must be the control person, and that person must have an SSN or ITIN.

string
length ≤ 100

The person's job title or role in the business, up to 100 characters. Needed to activate card processing (payin.card).

date

Date the person took on this role, in YYYY-MM-DD format.

date | null

Date the person left this role, in YYYY-MM-DD format. Leave empty while the role is current.

string
length ≤ 255

Your own reference for this record, up to 255 characters. Use it to find the record later with the externalId filter.

Headers
string

Optional. A unique value, such as a UUID, that identifies this request. If you retry with the same key, the change is not applied twice.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
.readme-logo { display: none !important; }