# Businesses Version: 1.0 ## Servers Sandbox ``` https://api.solaris-sandbox.de ``` Production ``` https://api.solarisbank.de ``` ## Download OpenAPI description [Businesses](https://docs.solarisgroup.com/_spec/api-reference/onboarding/businesses.yaml) ## Businesses ### Create a business - [POST /v1/businesses](https://docs.solarisgroup.com/api-reference/onboarding/businesses/businesses/paths/~1v1~1businesses/post.md): 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. ### Index businesses - [GET /v1/businesses](https://docs.solarisgroup.com/api-reference/onboarding/businesses/businesses/paths/~1v1~1businesses/get.md): Returns an array containing all of your business customers. ### Retrieve a business - [GET /v1/businesses/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/businesses/paths/~1v1~1businesses~1%7Bid%7D/get.md): Returns information about the business specified in the request URL. ### Update a business - [PATCH /v1/businesses/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/businesses/paths/~1v1~1businesses~1%7Bid%7D/patch.md): Modifies one or more properties of a business. Note that changing existing properties will trigger the ### Add Annual Turnover - [POST /v1/businesses/{id}/annual_turnover](https://docs.solarisgroup.com/api-reference/onboarding/businesses/businesses/paths/~1v1~1businesses~1%7Bid%7D~1annual_turnover/post.md): Add Annual Turnover to the Business ## Business Registrations ### Retrieve business registration number and issuer - [GET /v1/commercial_registrations/search_by_name](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-registrations/paths/~1v1~1commercial_registrations~1search_by_name/get.md): Returns the business registration number and issuer for a business by searching for it in the commercial registry by name and country. ### Search for business's commercial registration - [GET /v1/commercial_registrations/find](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-registrations/paths/~1v1~1commercial_registrations~1find/get.md): Retrieves the business's information from the commercial registry. You must add the business's and in the request URL. ## Business tax identifications ### Create business tax identification - [POST /v1/businesses/{business_id}/tax_identifications](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-tax-identifications/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1tax_identifications/post.md): Creates a tax identification for the given business. Please note the following: The first to be submitted must be the primary tax identification. If you create another for the business with the value of set to , then it will overrule the previous tax identification (i.e., the property of the previous one will be set to ). A business may only have one tax identification per country. ### Index business tax identifications - [GET /v1/businesses/{business_id}/tax_identifications](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-tax-identifications/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1tax_identifications/get.md): Returns an array containing all tax identifications for a business. ### Get a business tax identification - [GET /v1/businesses/{business_id}/tax_identifications/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-tax-identifications/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1tax_identifications~1%7Bid%7D/get.md): Returns information about the business tax identification specified in the request URL. ### Update a business tax identification - [PATCH /v1/businesses/{business_id}/tax_identifications/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-tax-identifications/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1tax_identifications~1%7Bid%7D/patch.md): Updates one or more properties on an existing business tax identification. ## Business documents ### Index documents for a business - [GET /v1/businesses/{business_id}/documents](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents/get.md): Returns an array containing all documents for the business specified in the request URL. ### Create a document for a business - [POST /v1/businesses/{business_id}/documents](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents/post.md): Uploads a document and links it to the business specified in the request URL. Unlike most other endpoints, this request uses the content type. You must submit the parameters as items instead of a raw JSON body. By default, uploaded documents are not accessible to customers (i.e., the value is set to ). ### Download a business document - [GET /v1/businesses/{business_id}/documents/{id}/file](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents~1%7Bid%7D~1file/get.md): Downloads the file associated with the business document specified in the request URL. ### Retrieve a business document - [GET /v1/businesses/{business_id}/documents/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents~1%7Bid%7D/get.md): Returns information about the business document specified in the request URL. ### Delete a business document - [DELETE /v1/businesses/{business_id}/documents/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents~1%7Bid%7D/delete.md): Deletes a document for a business ### Update business document attributes - [PATCH /v1/businesses/{business_id}/documents/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-documents/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1documents~1%7Bid%7D/patch.md): Updates one or more properties of the business document specified in the request URL. ## Business legal representatives ### Create a legal representative for a business - [POST /v1/businesses/{business_id}/legal_representatives](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-legal-representatives/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1legal_representatives/post.md): 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. A legal representative can update the resource of any person connected to the business using the method. : 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. ### Index legal representatives of a business - [GET /v1/businesses/{business_id}/legal_representatives](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-legal-representatives/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1legal_representatives/get.md): Returns an array containing all legal representatives of a business. ### Update a legal representative of a business - [PATCH /v1/businesses/{business_id}/legal_representatives/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-legal-representatives/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1legal_representatives~1%7Bid%7D/patch.md): 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. ### Delete business legal representative - [DELETE /v1/businesses/{business_id}/legal_representatives/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-legal-representatives/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1legal_representatives~1%7Bid%7D/delete.md): Removes the person or business specified in the request URL from the given business as a legal representative. Note that this does delete the associated person or business resource. ## Beneficial Owners ### Create a beneficial owner for a business - [POST /v1/businesses/{business_id}/beneficial_owners](https://docs.solarisgroup.com/api-reference/onboarding/businesses/beneficial-owners/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1beneficial_owners/post.md): Links the person with the 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 ### List all beneficial owners for a business - [GET /v1/businesses/{business_id}/beneficial_owners](https://docs.solarisgroup.com/api-reference/onboarding/businesses/beneficial-owners/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1beneficial_owners/get.md): Returns an array containing all beneficial owners associated with a business. ### Get a beneficial owner of a business - [GET /v1/businesses/{business_id}/beneficial_owners/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/beneficial-owners/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1beneficial_owners~1%7Bid%7D/get.md): Returns a specific beneficial owner associated with a business as specified in the request URL. ### Update a beneficial owner of a business - [PATCH /v1/businesses/{business_id}/beneficial_owners/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/beneficial-owners/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1beneficial_owners~1%7Bid%7D/patch.md): Updates one or more properties on the beneficial owner specified in the request URL. ## Authorized persons ### Create an authorized person on a business account - [POST /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons](https://docs.solarisgroup.com/api-reference/onboarding/businesses/authorized-persons/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1accounts~1%7Baccount_id%7D~1authorized_persons/post.md): Links a to a business account as an authorized person. This endpoint requires the change request process unless the authorized person is a legal representative. The change request must be completed by a legal representative with a value of or . Note that the resource must have values for the following properties: address_line_1 (street) birth_city birth_date country first_name last_name nationality salutation : It's mandatory to collect the tax information from each authorized person on the business account and create a tax identification resource using POST Create a person tax identification. ### Index business account authorized persons - [GET /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons](https://docs.solarisgroup.com/api-reference/onboarding/businesses/authorized-persons/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1accounts~1%7Baccount_id%7D~1authorized_persons/get.md): Returns an array containing all authorized persons on the business account specified in the request URL. ### Get business account authorized person - [GET /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/authorized-persons/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1accounts~1%7Baccount_id%7D~1authorized_persons~1%7Bid%7D/get.md): Returns a specific authorized person on a business account based on the ID in the request URL. ### Remove authorized person from a business account - [DELETE /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/authorized-persons/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1accounts~1%7Baccount_id%7D~1authorized_persons~1%7Bid%7D/delete.md): Removes the authorized person specified in the request URL from the given business. ## Business signees ### Create a business signee - [POST /v1/businesses/{business_id}/signees](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-signees/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1signees/post.md): Assigns a person to the given business as a signee. ### Index business signees - [GET /v1/businesses/{business_id}/signees](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-signees/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1signees/get.md): Returns an array containing all signees for the given business. ### Delete business signee - [DELETE /v1/businesses/{business_id}/signees/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-signees/paths/~1v1~1businesses~1%7Bbusiness_id%7D~1signees~1%7Bid%7D/delete.md): Deletes the business signee specified in the request URL.