Skip to content
/Beneficial Owners

Businesses (1.0)

Download OpenAPI description
businesses.json
businesses.yaml
Languages
Servers
Mock Server

https://docs.solarisgroup.com/_mock/api-reference/onboarding/businesses/

Businesses

Operations

Business Registrations

Operations

Business tax identifications

Operations

Business documents

Operations

Beneficial Owners

Operations

Create a beneficial owner for a business

Request

Links the person with the person_id specified in the request body to the business specified in the request URL as a beneficial owner.
Please note that the person must have valid values in each of the following attributes:

  • salutation
  • first_name
  • last_name
  • birth_date

Path
business_idstringrequired
Bodyapplication/json

The content of the request.

person_idstring

ID of the person to be associated with the business as a beneficial owner.

Example: "3b8cfd40fb4dce5a231251ea06a014cper"
voting_sharestring

The beneficial's voting share, expressed as a percentile value from 0 to 100 using the format xx.xx.

Example: "70.50"
fictitiousboolean

Indicates whether or not the beneficial owner is fictitious.

relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
application/json
{
  "person_id": "3b8cfd40fb4dce5a231251ea06a014cper",
  "voting_share": "70.50",
  "fictitious": false,
  "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}

Responses

Successful result of the operation

Bodyapplication/json
idstring

ID of the beneficial owner relationship.

Example: "a5f454e3f96447d6b3f7ecda46328040"
beneficial_owner_idstring

Person or business ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
person_idstring

Person ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
valid_untilstring

The date when the beneficial owner relationship expires.

Example: "2022-12-31"
voting_shareinteger

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

Example: 75
business_idstring

ID of the relevant business.

Example: "e0277fae750a4c849660da873f94cbiz"
fictitiousboolean

Indicates whether the beneficial owner is fictitious.

Example: false
relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
Response
application/json
{
  "id": "a5f454e3f96447d6b3f7ecda46328040",
  "beneficial_owner_id": "b9c5661fc7d240b8b51b9059b580cper",
  "person_id": "b9c5661fc7d240b8b51b9059b580cper",
  "valid_until": "2022-12-31",
  "voting_share": 75,
  "business_id": "e0277fae750a4c849660da873f94cbiz",
  "fictitious": false,
  "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}

List all beneficial owners for a business

Request

Returns an array containing all beneficial owners associated with a business.

Path
business_idstringrequired
Query
page[number]string

The number of results pages to return.

page[size]string

The size of each page in the response.

include_invalidboolean

Flag that specifies whether or not to include beneficial owners who are no longer valid (i.e., their valid_until date has passed).

No request payload

Responses

Successful result of the operation

Bodyapplication/jsonArray [
idstring

ID of the beneficial owner relationship.

Example: "a5f454e3f96447d6b3f7ecda46328040"
beneficial_owner_idstring

Person or business ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
person_idstring

Person ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
valid_untilstring

The date when the beneficial owner relationship expires.

Example: "2022-12-31"
voting_shareinteger

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

Example: 75
business_idstring

ID of the relevant business.

Example: "e0277fae750a4c849660da873f94cbiz"
fictitiousboolean

Indicates whether the beneficial owner is fictitious.

Example: false
relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
]
Response
application/json
[
  {
    "id": "a5f454e3f96447d6b3f7ecda46328040",
    "beneficial_owner_id": "b9c5661fc7d240b8b51b9059b580cper",
    "person_id": "b9c5661fc7d240b8b51b9059b580cper",
    "valid_until": "2022-12-31",
    "voting_share": 75,
    "business_id": "e0277fae750a4c849660da873f94cbiz",
    "fictitious": false,
    "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
  }
]

Get a beneficial owner of a business

Request

Returns a specific beneficial owner associated with a business as specified in the request URL.

Path
business_idstringrequired
idstringrequired
No request payload

Responses

Successful result of the operation

Bodyapplication/json
idstring

ID of the beneficial owner relationship.

Example: "a5f454e3f96447d6b3f7ecda46328040"
beneficial_owner_idstring

Person or business ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
person_idstring

Person ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
valid_untilstring

The date when the beneficial owner relationship expires.

Example: "2022-12-31"
voting_shareinteger

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

Example: 75
business_idstring

ID of the relevant business.

Example: "e0277fae750a4c849660da873f94cbiz"
fictitiousboolean

Indicates whether the beneficial owner is fictitious.

Example: false
relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
Response
application/json
{
  "id": "a5f454e3f96447d6b3f7ecda46328040",
  "beneficial_owner_id": "b9c5661fc7d240b8b51b9059b580cper",
  "person_id": "b9c5661fc7d240b8b51b9059b580cper",
  "valid_until": "2022-12-31",
  "voting_share": 75,
  "business_id": "e0277fae750a4c849660da873f94cbiz",
  "fictitious": false,
  "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}

Update a beneficial owner of a business

Request

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

Path
business_idstringrequired
idstringrequired
Bodyapplication/json

The content of the request.

valid_untilstring

The date when the person's beneficial owner role for the account expires.

Example: "2012-12-12"
voting_sharestring

The beneficial's voting share, expressed as a percentile value from 0 to 100 using the format xx.xx.

Example: "70.50"
fictitiousboolean

Indicates whether or not the beneficial owner is fictitious.

relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
application/json
{
  "valid_until": "2012-12-12",
  "voting_share": "70.50",
  "fictitious": false,
  "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}

Responses

Successful result of the operation

Bodyapplication/json
idstring

ID of the beneficial owner relationship.

Example: "a5f454e3f96447d6b3f7ecda46328040"
beneficial_owner_idstring

Person or business ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
person_idstring

Person ID of the beneficial owner.

Example: "b9c5661fc7d240b8b51b9059b580cper"
valid_untilstring

The date when the beneficial owner relationship expires.

Example: "2022-12-31"
voting_shareinteger

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

Example: 75
business_idstring

ID of the relevant business.

Example: "e0277fae750a4c849660da873f94cbiz"
fictitiousboolean

Indicates whether the beneficial owner is fictitious.

Example: false
relationship_to_businessstring

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"
Example: "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
Response
application/json
{
  "id": "a5f454e3f96447d6b3f7ecda46328040",
  "beneficial_owner_id": "b9c5661fc7d240b8b51b9059b580cper",
  "person_id": "b9c5661fc7d240b8b51b9059b580cper",
  "valid_until": "2022-12-31",
  "voting_share": 75,
  "business_id": "e0277fae750a4c849660da873f94cbiz",
  "fictitious": false,
  "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}

Authorized persons

Operations

Business signees

Operations