Download OpenAPI specification:Download
Creates a new business resource. The mandatory data points you must provide when creating a business vary based on the country where you are opening the account. See the onboarding requirements guide guide for information about which data points are required for each country.
The content of the request.
name | string The name of the business. Limited to 255 characters. |
sector | string The sector of the business. Please note that the business' |
industry | string (Solaris-Decorators-IndustryEnum) The business' industry. This field is deprecated; please use |
industry_key | string (Solaris-Decorators-IndustryKeyEnum) Additional information about the industry in which the business operates. This field is deprecated; please use |
legal_form | string (Solaris-Decorators-BusinessLegalFormEnum) The business' legal form. Check the Onboarding requirements guide for the mapping between legal form and tax country. |
foundation_date | string The date when the business was founded. |
object The business' address. | |
object The business' tax information. | |
fatca_relevant | boolean Indicates whether or not the company is FATCA relevant. |
fatca_crs_confirmed_at | string UTC timestamp when the business confirmed whether or not they were FATCA relevant. |
crs_company_type | string The business' Common Reporting Standard (CRS) company type. |
balance_sheet_total | integer The business' total assets, in Euro cents. |
number_employees | integer The number of employees at the business. |
registration_type | string The business' registration type. |
registration_district | string (For German businesses only) The district where the business is registered. |
business_purpose | string Short summary of the purpose of the business. May also include the business' web address. |
terms_conditions_signed_at | string UTC timestamp when the business signed the Solaris Terms and Conditions. |
vat_number | string The business' VAT number. |
website_social_media | string The business' website or social media accounts. |
branch | string (If creating a non-German branching account) The country where the branching account should be created. |
international_operativity_expectation | Array of strings Regions where the business expects to operate. |
purpose_of_account_opening | string The business' purpose for opening the account. |
source_of_funds | string The business' source of funds. |
expected_annual_revenue | string The business' expected annual revenue. |
expected_annual_incoming_funds | string The business' expected annual incoming funds. |
company_status | string The business' expected annual incoming funds. |
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "name": "Example GmbH",
- "sector": "OTHER_COMPANIES",
- "industry": "OTHER_SERVICES",
- "industry_key": "EDUCATION",
- "legal_form": "GMBH",
- "foundation_date": "1990-06-01T00:00:00.000Z",
- "address": {
- "line_1": "Address 1",
- "line_2": "Address 2",
- "postal_code": "10409",
- "city": "Berlin",
- "country": "DE",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "DE",
- "tax_confirmation": "SINGLE",
- "registration_number": "HRB 12345",
- "registration_issuer": "Amtsgericht Berlin"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "2017-01-01T00:00:00.000Z",
- "crs_company_type": "FE_REPORTING",
- "balance_sheet_total": 1234567,
- "number_employees": 3,
- "registration_type": "DE_GNR_CD",
- "registration_district": "BERLIN_CHARLOTTENBURG",
- "business_purpose": "change the world for the better",
- "terms_conditions_signed_at": "2017-01-01T00:00:00.000Z",
- "branch": "ES",
- "international_operativity_expectation": [
- "NATIONAL_ACTIVITY_ONLY"
], - "vat_number": "4711",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "UP_TO_ONE_MEUR",
- "expected_annual_incoming_funds": "TWO_HUNDRED_K_TO_ONE_MEUR",
- "company_status": "ACTIVE"
}
{- "id": "e0277fae750a4c849660da873f94cbiz",
- "name": "string",
- "sector": "ECONOMICALLY_SELF_EMPLOYED",
- "industry": "BUILDING_INDUSTRY",
- "industry_key": "ACCOMMODATION",
- "legal_form": "AT_SE",
- "foundation_date": "string",
- "address": {
- "line_1": "string",
- "line_2": "string",
- "postal_code": "string",
- "city": "string",
- "country": "AD",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "AD",
- "tax_confirmation": "ANNUALY",
- "registration_number": "string",
- "registration_issuer": "string"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "string",
- "crs_company_type": "FE_REPORTING",
- "business_purpose": "string",
- "terms_conditions_signed_at": "string",
- "flagged_by_compliance": "string",
- "balance_sheet_total": 0,
- "number_employees": 0,
- "registration_type": "AT_FB_CD",
- "registration_district": "AACHEN",
- "screening_progress": "NOT_SCREENED",
- "international_operativity_expectation": [
- "AFRICA"
], - "vat_number": "string",
- "risk_classification_status": "NOT_SCORED",
- "customer_vetting_status": "NOT_VETTED",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "ENTITY_IN_CRISIS",
- "expected_annual_incoming_funds": "UP_TO_TEN_KEUR",
- "company_status": "ACTIVE"
}
Returns an array containing all of your business customers.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses?page%5Bnumber%5D=string&page%5Bsize%5D=string&sort=name'
{- "id": "e0277fae750a4c849660da873f94cbiz",
- "name": "string",
- "sector": "ECONOMICALLY_SELF_EMPLOYED",
- "industry": "BUILDING_INDUSTRY",
- "industry_key": "ACCOMMODATION",
- "legal_form": "AT_SE",
- "foundation_date": "string",
- "address": {
- "line_1": "string",
- "line_2": "string",
- "postal_code": "string",
- "city": "string",
- "country": "AD",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "AD",
- "tax_confirmation": "ANNUALY",
- "registration_number": "string",
- "registration_issuer": "string"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "string",
- "crs_company_type": "FE_REPORTING",
- "business_purpose": "string",
- "terms_conditions_signed_at": "string",
- "flagged_by_compliance": "string",
- "balance_sheet_total": 0,
- "number_employees": 0,
- "registration_type": "AT_FB_CD",
- "registration_district": "AACHEN",
- "screening_progress": "NOT_SCREENED",
- "international_operativity_expectation": [
- "AFRICA"
], - "vat_number": "string",
- "risk_classification_status": "NOT_SCORED",
- "customer_vetting_status": "NOT_VETTED",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "ENTITY_IN_CRISIS",
- "expected_annual_incoming_funds": "UP_TO_TEN_KEUR",
- "company_status": "ACTIVE"
}
Returns information about the business specified in the request URL.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{id}'
{- "id": "e0277fae750a4c849660da873f94cbiz",
- "name": "string",
- "sector": "ECONOMICALLY_SELF_EMPLOYED",
- "industry": "BUILDING_INDUSTRY",
- "industry_key": "ACCOMMODATION",
- "legal_form": "AT_SE",
- "foundation_date": "string",
- "address": {
- "line_1": "string",
- "line_2": "string",
- "postal_code": "string",
- "city": "string",
- "country": "AD",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "AD",
- "tax_confirmation": "ANNUALY",
- "registration_number": "string",
- "registration_issuer": "string"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "string",
- "crs_company_type": "FE_REPORTING",
- "business_purpose": "string",
- "terms_conditions_signed_at": "string",
- "flagged_by_compliance": "string",
- "balance_sheet_total": 0,
- "number_employees": 0,
- "registration_type": "AT_FB_CD",
- "registration_district": "AACHEN",
- "screening_progress": "NOT_SCREENED",
- "international_operativity_expectation": [
- "AFRICA"
], - "vat_number": "string",
- "risk_classification_status": "NOT_SCORED",
- "customer_vetting_status": "NOT_VETTED",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "ENTITY_IN_CRISIS",
- "expected_annual_incoming_funds": "UP_TO_TEN_KEUR",
- "company_status": "ACTIVE"
}
Modifies one or more properties of a business. Note that changing existing properties will trigger the change request process.
The content of the request.
name | string company name |
sector | string The sector of the business. Please note that the business' |
industry | string (Solaris-Decorators-IndustryEnum) The business' industry. This field is deprecated; please use |
industry_key | string (Solaris-Decorators-IndustryKeyEnum) Additional information about the industry in which the business operates. This field is deprecated; please use |
legal_form | string (Solaris-Decorators-BusinessLegalFormEnum) The business' legal form. Check the Onboarding requirements guide for the mapping between legal form and tax country. |
foundation_date | string The date when the business was founded. |
object The business' address. | |
object The business' tax information. | |
fatca_relevant | boolean Indicates whether or not the company is FATCA relevant. |
fatca_crs_confirmed_at | string UTC timestamp when the business confirmed whether or not they were FATCA relevant. |
crs_company_type | string The business' Common Reporting Standard (CRS) company type. |
balance_sheet_total | integer The business' total assets, in Euro cents. |
number_employees | integer The number of employees at the business. |
registration_type | string The business' registration type. |
registration_district | string (For German businesses only) The district where the business is registered. |
business_purpose | string Short summary of the purpose of the business. May also include the business' web address. |
terms_conditions_signed_at | string UTC timestamp when the business signed the Solaris Terms and Conditions. |
vat_number | string The business' VAT number. |
international_operativity_expectation | Array of strings Regions where the business expects to operate. |
purpose_of_account_opening | string The business' purpose for opening the account. |
source_of_funds | string The business' source of funds. |
expected_annual_revenue | string The business' expected annual revenue. |
expected_annual_incoming_funds | string The business' expected annual incoming funds. |
company_status | string The business' expected annual incoming funds. |
Successful result of the operation
The request was accepted, and now the customer must confirm the change request.
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "name": "Example GmbH",
- "sector": "OTHER_COMPANIES",
- "industry": "OTHER_SERVICES",
- "industry_key": "EDUCATION",
- "legal_form": "GMBH",
- "foundation_date": "1990-06-01T00:00:00.000Z",
- "address": {
- "line_1": "Address 1",
- "line_2": "Address 2",
- "postal_code": "10409",
- "city": "Berlin",
- "country": "DE",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "DE",
- "tax_confirmation": "SINGLE",
- "registration_number": "HRB 12345",
- "registration_issuer": "Amtsgericht Berlin"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "2017-01-01T00:00:00.000Z",
- "crs_company_type": "FE_REPORTING",
- "balance_sheet_total": 1234567,
- "number_employees": 3,
- "registration_type": "DE_GNR_CD",
- "registration_district": "BERLIN_CHARLOTTENBURG",
- "business_purpose": "change the world for the better",
- "terms_conditions_signed_at": "2017-01-01T00:00:00.000Z",
- "international_operativity_expectation": [
- "NATIONAL_ACTIVITY_ONLY"
], - "vat_number": "4711",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "UP_TO_ONE_MEUR",
- "expected_annual_incoming_funds": "TWO_HUNDRED_K_TO_ONE_MEUR",
- "company_status": "ACTIVE"
}
{- "id": "e0277fae750a4c849660da873f94cbiz",
- "name": "string",
- "sector": "ECONOMICALLY_SELF_EMPLOYED",
- "industry": "BUILDING_INDUSTRY",
- "industry_key": "ACCOMMODATION",
- "legal_form": "AT_SE",
- "foundation_date": "string",
- "address": {
- "line_1": "string",
- "line_2": "string",
- "postal_code": "string",
- "city": "string",
- "country": "AD",
- "state": "BE"
}, - "tax_information": {
- "tax_country": "AD",
- "tax_confirmation": "ANNUALY",
- "registration_number": "string",
- "registration_issuer": "string"
}, - "fatca_relevant": true,
- "fatca_crs_confirmed_at": "string",
- "crs_company_type": "FE_REPORTING",
- "business_purpose": "string",
- "terms_conditions_signed_at": "string",
- "flagged_by_compliance": "string",
- "balance_sheet_total": 0,
- "number_employees": 0,
- "registration_type": "AT_FB_CD",
- "registration_district": "AACHEN",
- "screening_progress": "NOT_SCREENED",
- "international_operativity_expectation": [
- "AFRICA"
], - "vat_number": "string",
- "risk_classification_status": "NOT_SCORED",
- "customer_vetting_status": "NOT_VETTED",
- "purpose_of_account_opening": "SAVINGS",
- "source_of_funds": "REAL_ESTATE_INCOME",
- "expected_annual_revenue": "ENTITY_IN_CRISIS",
- "expected_annual_incoming_funds": "UP_TO_TEN_KEUR",
- "company_status": "ACTIVE"
}
Returns the business registration number and issuer for a business by searching for it in the commercial registry by name and country.
Operation was successful
Unauthorized Action
Model Not Found
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/commercial_registrations/search_by_name?name=string&country=DE'
[- {
- "name": "Company GmbH",
- "registration_number": "HRB 198673",
- "registration_issuer": "AMTSGERICHT München"
}
]
Retrieves the business's information from the commercial registry. You must add the business's registration_number
and registration_issuer
in the request URL.
Operation was successful
Unauthorized Action
Model Not Found
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/commercial_registrations/find?registration_number=string®istration_issuer=string&country=DE'
{- "name": "FLOOR 13 GmbH",
- "address": {
- "line_1": "Seestraße 9",
- "line_2": "string",
- "postal_code": "86919",
- "city": "Utting a.Ammersee",
- "country": "DE",
- "state": "string"
}, - "legal_form": "GMBH",
- "tax_country": "DE",
- "registration_number": "HRB198673",
- "registration_issuer": "AMTSGERICHT München",
- "registration_date": "2012-05-09",
- "registry_updated_at": "2015-11-17",
- "legal_representatives": [
- {
- "first_name": "Stefan",
- "last_name": "Schneider"
}
]
}
Creates a tax identification for the given business. Please note the following:
tax_identification
to be submitted must be the primary tax identification. If you create another tax_identification
for the business with the value of primary
set to true
, then it will overrule the previous tax identification (i.e., the primary
property of the previous one will be set to false
).The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "number": "31659837651",
- "country": "DE",
- "primary": true
}
{- "id": "cba4289c773b7450482ee88a6e5126e9ctin",
- "country": "AD",
- "number": "12345678901",
- "primary": true,
- "reason_no_tin": "NOT_ASSIGNED_YET",
- "reason_description": "string",
- "valid_until": "2019-08-24",
- "tax_id_type": "NIE"
}
Returns an array containing all tax identifications for a business.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/tax_identifications'
[- {
- "id": "cba4289c773b7450482ee88a6e5126e9ctin",
- "country": "AD",
- "number": "12345678901",
- "primary": true,
- "reason_no_tin": "NOT_ASSIGNED_YET",
- "reason_description": "string",
- "valid_until": "2019-08-24",
- "tax_id_type": "NIE"
}
]
Returns information about the business tax identification specified in the request URL.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/tax_identifications/{id}'
{- "id": "cba4289c773b7450482ee88a6e5126e9ctin",
- "country": "AD",
- "number": "12345678901",
- "primary": true,
- "reason_no_tin": "NOT_ASSIGNED_YET",
- "reason_description": "string",
- "valid_until": "2019-08-24",
- "tax_id_type": "NIE"
}
Updates one or more properties on an existing business tax identification.
The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "number": "31659837651",
- "country": "DE",
- "primary": true
}
{- "id": "cba4289c773b7450482ee88a6e5126e9ctin",
- "country": "AD",
- "number": "12345678901",
- "primary": true,
- "reason_no_tin": "NOT_ASSIGNED_YET",
- "reason_description": "string",
- "valid_until": "2019-08-24",
- "tax_id_type": "NIE"
}
Returns an array containing all documents for the business specified in the request URL.
Successful result of the operation
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/documents?include_deleted=true&customer_accessible=true&sort=created_at&page%5Bnumber%5D=string&page%5Bsize%5D=string&filter%5Bdocument_type%5D=string'
{- "id": "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc",
- "name": "Operation_authorization.png",
- "content_type": "image/png",
- "document_type": "PICTURE",
- "size": 10187,
- "customer_accessible": false,
- "created_at": "2022-05-20T12:46:09Z",
- "deleted_at": "null"
}
Uploads a document and links it to the business specified in the request URL.
Unlike most other endpoints, this request uses the multipart/form-data
content type. You must submit the parameters as form-data
items instead of a raw JSON body.
By default, uploaded documents are not accessible to customers (i.e., the customer_accessible
value is set to false
).
Successful result of the operation
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/documents' \ -H 'Content-Type: multipart/form-data' \ -F file=string \ -F document_type=ACCOUNT_SNAPSHOT.FINTECSYSTEMS
{- "id": "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc",
- "name": "Operation_authorization.png",
- "content_type": "image/png",
- "document_type": "PICTURE",
- "size": 10187,
- "customer_accessible": false,
- "created_at": "2022-05-20T12:46:09Z",
- "deleted_at": "null"
}
Downloads the file associated with the business document specified in the request URL.
Successful result of the operation.
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/documents/{id}/file'
{- "title": "Failed to build pagination headers.",
- "status": "400",
- "id": "a95f2aaf-4e0c-4d49-8021-8a16a884ed86",
- "detail": "Cannot connect to database.",
- "code": "build_pagination_headers_failure"
}
Returns information about the business document specified in the request URL.
Successful result of the operation
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/documents/{id}'
{- "id": "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc",
- "name": "Operation_authorization.png",
- "content_type": "image/png",
- "document_type": "PICTURE",
- "size": 10187,
- "customer_accessible": false,
- "created_at": "2022-05-20T12:46:09Z",
- "deleted_at": "null"
}
Deletes a document for a business
Successful result of the operation
Unexpected error
curl -i -X DELETE \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/documents/{id}'
{- "id": "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc",
- "name": "Operation_authorization.png",
- "content_type": "image/png",
- "document_type": "PICTURE",
- "size": 10187,
- "customer_accessible": false,
- "created_at": "2022-05-20T12:46:09Z",
- "deleted_at": "null"
}
Updates one or more properties of the business document specified in the request URL.
the content of the request
Successful result of the operation
Unexpected error
{- "document_type": "ACCOUNT_SNAPSHOT.FINTECSYSTEMS",
- "customer_accessible": true
}
{- "id": "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc",
- "name": "Operation_authorization.png",
- "content_type": "image/png",
- "document_type": "PICTURE",
- "size": 10187,
- "customer_accessible": false,
- "created_at": "2022-05-20T12:46:09Z",
- "deleted_at": "null"
}
Links the person or business specified in the request body to the business specified in the URL as a legal representative. You must add legal representatives sequentially with individual calls to this endpoint.
Note: A legal representative can update the person
resource of any person connected to the business using the PATCH Update a person
method.
Note: It's mandatory to collect the tax information from each legal representative associated with the business and create a tax identification resource using POST Create a person tax identification.
The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "legal_representative_id": "0ba2211cab11af6094d60ead81f2bd9dcper",
- "type_of_representation": "ALONE",
- "power_of_attorney_confirmed_at": "2017-01-01T00:00:00Z"
}
{- "id": "a46578f4049f42aba9fe88a2a80fed53",
- "legal_representative_id": "33fbdd2c0bb94db1af5b5d2a4426cper",
- "legal_representative_type": "Person",
- "valid_until": "2022-12-31",
- "power_of_attorney_confirmed_at": "2022-04-22T16:02:54Z",
- "type_of_representation": "ALONE",
- "business_id": "095cc43012a04ccca02f0f93c145cbiz"
}
Returns an array containing all legal representatives of a business.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/legal_representatives?page%5Bnumber%5D=string&page%5Bsize%5D=string'
[- {
- "id": "a46578f4049f42aba9fe88a2a80fed53",
- "legal_representative_id": "33fbdd2c0bb94db1af5b5d2a4426cper",
- "legal_representative_type": "Person",
- "valid_until": "2022-12-31",
- "power_of_attorney_confirmed_at": "2022-04-22T16:02:54Z",
- "type_of_representation": "ALONE",
- "business_id": "095cc43012a04ccca02f0f93c145cbiz"
}
]
Updates the properties of a legal representative resource. Note that you cannot use this endpoint to update properties on the associated person or business resource.
The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "valid_until": "2022-12-31",
- "type_of_representation": "ALONE",
- "power_of_attorney_confirmed_at": "2017-01-01T00:00:00Z"
}
{- "id": "a46578f4049f42aba9fe88a2a80fed53",
- "legal_representative_id": "33fbdd2c0bb94db1af5b5d2a4426cper",
- "legal_representative_type": "Person",
- "valid_until": "2022-12-31",
- "power_of_attorney_confirmed_at": "2022-04-22T16:02:54Z",
- "type_of_representation": "ALONE",
- "business_id": "095cc43012a04ccca02f0f93c145cbiz"
}
Removes the person or business specified in the request URL from the given business as a legal representative. Note that this does not delete the associated person or business resource.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X DELETE \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/legal_representatives/{id}'
{- "id": "a95f2aaf-4e0c-4d49-8021-8a16a884ed86",
- "status": "400",
- "code": "build_pagination_headers_failure",
- "title": "Failed to build pagination headers.",
- "detail": "Cannot connect to database."
}
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
The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "person_id": "3b8cfd40fb4dce5a231251ea06a014cper",
- "voting_share": "70.50",
- "fictitious": false,
- "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}
{- "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"
}
Returns an array containing all beneficial owners associated with a business.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/beneficial_owners?page%5Bnumber%5D=string&page%5Bsize%5D=string&include_invalid=true'
[- {
- "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"
}
]
Returns a specific beneficial owner associated with a business as specified in the request URL.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/beneficial_owners/{id}'
{- "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"
}
Updates one or more properties on the beneficial owner specified in the request URL.
The content of the request.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "valid_until": "2012-12-12",
- "voting_share": "70.50",
- "fictitious": false,
- "relationship_to_business": "DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL"
}
{- "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"
}
Assigns a person to the given business as a signee.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "person_id": "0ba2211cab11af6094d60ead81f2bd9dcper"
}
{- "id": "43f732deceba4e908835b62815bae4a6",
- "person_id": "dc1a6812a14f6cc338cd084208535bcdcper",
- "business_id": "880bbac68a34add190786b9c74f4c82fcbiz"
}
Returns an array containing all signees for the given business.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/signees'
[- {
- "id": "43f732deceba4e908835b62815bae4a6",
- "person_id": "dc1a6812a14f6cc338cd084208535bcdcper",
- "business_id": "880bbac68a34add190786b9c74f4c82fcbiz"
}
]