# Update a beneficial owner of a business

Updates one or more properties on the beneficial owner specified in the request URL.

Endpoint: PATCH /v1/businesses/{business_id}/beneficial_owners/{id}
Version: 1.0

## Path parameters:

  - `business_id` (string, required)

  - `id` (string, required)

## Request fields (application/json):

  - `valid_until` (string)
    The date when the person's beneficial owner role for the account expires.
    Example: "2012-12-12"

  - `voting_share` (string)
    The beneficial's voting share, expressed as a percentile value from 0 to 100 using the format .
    Example: "70.50"

  - `fictitious` (boolean)
    Indicates whether or not the beneficial owner is fictitious.

  - `relationship_to_business` (string)
    Specifies the beneficial owner's relationship to the business.
    Enum: "DIRECTLY_HOLDING_25_PERCENT_OR_MORE", "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL", "INDIRECTLY_HOLDING_25_PERCENT_OR_MORE"

## Response 200 fields (application/json):

  - `id` (string)
    ID of the beneficial owner relationship.
    Example: "a5f454e3f96447d6b3f7ecda46328040"

  - `beneficial_owner_id` (string)
    Person or business ID of the beneficial owner.
    Example: "b9c5661fc7d240b8b51b9059b580cper"

  - `person_id` (string)
    Person ID of the beneficial owner.
    Example: "b9c5661fc7d240b8b51b9059b580cper"

  - `valid_until` (string)
    The date when the beneficial owner relationship expires.
    Example: "2022-12-31"

  - `voting_share` (integer)
    The beneficial owner's voting share. Expressed as a double-digit percentile (e.g., 75% would be expressed as ).
    Example: 75

  - `business_id` (string)
    ID of the relevant business.
    Example: "e0277fae750a4c849660da873f94cbiz"

  - `fictitious` (boolean)
    Indicates whether the beneficial owner is fictitious.

  - `relationship_to_business` (string)
    The type of relationship that the beneficial owner has to the business.
    Enum: "DIRECTLY_HOLDING_25_PERCENT_OR_MORE", "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL", "INDIRECTLY_HOLDING_25_PERCENT_OR_MORE"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."