openapi: 3.0.1
info:
  title: Businesses
  version: '1.0'
servers:
  - url: https://api.solaris-sandbox.de
    description: Sandbox
  - url: https://api.solarisbank.de
    description: Production
paths:
  /v1/businesses:
    post:
      tags:
        - Businesses
      summary: Create a business
      description: >-
        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](https://docs.solarisgroup.com/guides/get-started/onboarding-requirements/2-data-collection/)
        for information about which data points are required for each country.
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The name of the business. Limited to 255 characters.
                sector:
                  type: string
                  description: >-
                    The sector of the business. Please note that the business'
                    `tax_country` determines the allowed values you may store in
                    the `sector` property, and the value of `sector` determines
                    the allowed values you may store in the `legal_form` and
                    `industry`/`nace_code` properties.
                  enum:
                    - ECONOMICALLY_SELF_EMPLOYED
                    - ECONOMIC_DEPENDENT
                    - FOREIGN_COMPANIES
                    - FOREIGN_ECONOMIC_DEPENDENT
                    - FOREIGN_PRIVATE_INDIVIDUAL
                    - FOREIGN_SELF_EMPLOYED_PRIVATE_PERSON
                    - GERMAN_BANKS
                    - MUNICIPALITY_AND_MUNICIPALITY_ASSOCIATION
                    - OTHER_COMPANIES_WORKMAN
                    - OTHER_COMPANIES
                    - OTHER_PRIVATE_INDIVIDUAL
                industry:
                  $ref: '#/components/schemas/Solaris-Decorators-IndustryEnum'
                industry_key:
                  $ref: '#/components/schemas/Solaris-Decorators-IndustryKeyEnum'
                nace_code:
                  description: >-
                    The nace code that describes the industry in which the
                    business works. For more info on how to implement this
                    field, see this
                    [section](https://docs.solarisgroup.com/guides/get-started/onboarding-requirements/2-data-collection/#nace-code).
                  allOf:
                    - $ref: >-
                        #/components/schemas/Solaris-Decorators-FreelancerNaceCodeEnum
                legal_form:
                  $ref: >-
                    #/components/schemas/Solaris-Decorators-BusinessLegalFormEnum
                foundation_date:
                  type: string
                  description: The date when the business was founded.
                address:
                  type: object
                  description: The business' address.
                  properties:
                    line_1:
                      type: string
                      description: Address line 1
                    line_2:
                      type: string
                      description: Address line 2
                    postal_code:
                      type: string
                      description: The business' postal code.
                    city:
                      type: string
                      description: The business' city.
                    country:
                      description: The business' country.
                      allOf:
                        - $ref: >-
                            #/components/schemas/Solaris-Server-Decorators-CountryEnum
                    state:
                      type: string
                      description: >-
                        (For German companies) The state where the business is
                        located.
                      enum:
                        - BE
                        - BB
                        - BW
                        - BY
                        - HB
                        - HE
                        - HH
                        - MV
                        - NI
                        - NW
                        - RP
                        - SH
                        - SL
                        - SN
                        - ST
                        - TH
                tax_information:
                  type: object
                  description: The business' tax information.
                  properties:
                    tax_country:
                      type: string
                      description: The business' tax country.
                      allOf:
                        - $ref: >-
                            #/components/schemas/Solaris-Server-Decorators-CountryEnum
                    tax_confirmation:
                      type: string
                      description: The business' tax confirmation interval.
                      enum:
                        - ANNUALY
                        - SINGLE
                    registration_number:
                      type: string
                      description: The business' registration number.
                    registration_issuer:
                      type: string
                      description: The authority that issued the business' registration.
                fatca_relevant:
                  type: boolean
                  description: Indicates whether or not the company is FATCA relevant.
                fatca_crs_confirmed_at:
                  type: string
                  description: >-
                    UTC timestamp when the business confirmed whether or not
                    they were FATCA relevant.
                crs_company_type:
                  type: string
                  description: The business' Common Reporting Standard (CRS) company type.
                  enum:
                    - FE_REPORTING
                    - FE_NON_REPORTING
                    - NFE_ACTIVE
                    - NFE_ACTIVE_OTHER
                    - NFE_PASSIVE
                    - NFE_PASSIVE_INVESTMENT
                balance_sheet_total:
                  type: integer
                  description: The business' total assets, in Euro cents.
                number_employees:
                  type: integer
                  description: The number of employees at the business.
                registration_type:
                  type: string
                  description: The business' registration type.
                  allOf:
                    - $ref: >-
                        #/components/schemas/Solaris-Decorators-RegistrationTypeEnum
                registration_district:
                  type: string
                  description: >-
                    (For German businesses only) The district where the business
                    is registered.
                  allOf:
                    - $ref: >-
                        #/components/schemas/Solaris-Decorators-RegistrationDistrictEnum
                business_purpose:
                  type: string
                  description: >-
                    Short summary of the purpose of the business. May also
                    include the business' web address.
                terms_conditions_signed_at:
                  type: string
                  description: >-
                    UTC timestamp when the business signed the Solaris Terms and
                    Conditions.
                vat_number:
                  type: string
                  description: The business' VAT number.
                website_social_media:
                  type: string
                  description: The business' website or social media accounts.
                branch:
                  type: string
                  description: >-
                    (If creating a non-German branching account) The country
                    where the branching account should be created.
                  enum:
                    - DE
                    - FR
                    - ES
                    - IT
                international_operativity_expectation:
                  type: array
                  description: Regions where the business expects to operate.
                  items:
                    type: string
                    enum:
                      - AFRICA
                      - ASIA
                      - MIDDLE_EAST
                      - NORTH_AMERICA
                      - SOUTH_AMERICA
                      - NATIONAL_ACTIVITY_ONLY
                purpose_of_account_opening:
                  type: string
                  description: The business' purpose for opening the account.
                  enum:
                    - SAVINGS
                    - DAILY_EXPENSES
                    - TRAVELLING_AND_RELOCATING
                    - FREELANCER_ACTIVITY
                    - ONLINE_SHOPPING
                    - SALARY_OR_PENSION_ACCREDITATION
                    - TRADING
                    - FINANCING
                    - BUYING_AND_SELLING_GOODS
                    - MANAGEMENT_OF_INVOICES_AND_RECEIPTS
                    - TREASURY
                    - SUPPLIERS_MANAGEMENT
                    - SETTLEMENT_OF_TRANSACTIONS_TO_AND_FROM_ABROAD
                    - INVESTMENT_ACTIVITY
                    - EMPLOYEE_PAYROLL_MANAGEMENT
                source_of_funds:
                  type: string
                  description: The business' source of funds.
                  enum:
                    - REAL_ESTATE_INCOME
                    - SALE_OF_GOODS_AND_SERVICES
                    - TRANSFER_FROM_DIFFERENT_ACCOUNTS
                    - INCOME_FROM_CUSTOMERS
                    - CORPORATE_MERGERS_AND_ACQUISITIONS
                    - FINANCING
                    - SECURITIES_OR_OTHER_FINANCIAL_INSTRUMENTS
                    - TREASURY
                    - DONATIONS
                expected_annual_revenue:
                  type: string
                  description: The business' expected annual revenue.
                  enum:
                    - ENTITY_IN_CRISIS
                    - ENTITY_IN_SETUP
                    - UP_TO_ONE_MEUR
                    - ONE_M_TO_FIVE_MEUR
                    - FIVE_M_TO_TEN_MEUR
                    - MORE_THAN_TEN_MEUR
                expected_annual_incoming_funds:
                  type: string
                  description: The business' expected annual incoming funds.
                  enum:
                    - UP_TO_TEN_KEUR
                    - TEN_K_TO_FIFTY_KEUR
                    - FIFTY_K_TO_TWO_HUNDRED_KEUR
                    - TWO_HUNDRED_K_TO_ONE_MEUR
                    - ONE_M_TO_FIVE_MEUR
                    - MORE_THAN_FIVE_MEUR
                company_status:
                  type: string
                  description: The business' expected annual incoming funds.
                  enum:
                    - ACTIVE
                    - INACTIVE
                    - IN_LIQUIDATION
                    - COLLECTIVE_PROCEEDINGS
                    - IN_CONSTITUTION
                risk_group:
                  type: string
                  description: Risk Group
                  enum:
                    - LOW
                    - MEDIUM
                    - HIGH
                    - HIGHEST
              example:
                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
        required: false
      responses:
        '201':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-Business'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Businesses
      summary: Index businesses
      description: Returns an array containing all of your business customers.
      parameters:
        - name: page[number]
          in: query
          description: The number of results pages to return.
          schema:
            type: string
        - name: page[size]
          in: query
          description: The size of each page in the response.
          schema:
            type: string
        - name: sort
          in: query
          description: Sort the results by business name.
          schema:
            type: string
            enum:
              - name
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-Business'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business#all
  /v1/businesses/{id}:
    get:
      tags:
        - Businesses
      summary: Retrieve a business
      description: Returns information about the business specified in the request URL.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-Business'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business#find
    patch:
      tags:
        - Businesses
      summary: Update a business
      description: >-
        Modifies one or more properties of a business. Note that changing
        existing properties will trigger the **change request process.**
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: company name
                sector:
                  type: string
                  description: >-
                    The sector of the business. Please note that the business'
                    `tax_country` determines the allowed values you may store in
                    the `sector` property, and the value of `sector` determines
                    the allowed values you may store in the `legal_form` and
                    `industry`/`nace_code` properties.
                  enum:
                    - ECONOMICALLY_SELF_EMPLOYED
                    - ECONOMIC_DEPENDENT
                    - FOREIGN_COMPANIES
                    - FOREIGN_ECONOMIC_DEPENDENT
                    - FOREIGN_PRIVATE_INDIVIDUAL
                    - FOREIGN_SELF_EMPLOYED_PRIVATE_PERSON
                    - GERMAN_BANKS
                    - MUNICIPALITY_AND_MUNICIPALITY_ASSOCIATION
                    - OTHER_COMPANIES_WORKMAN
                    - OTHER_COMPANIES
                    - OTHER_PRIVATE_INDIVIDUAL
                industry:
                  $ref: '#/components/schemas/Solaris-Decorators-IndustryEnum'
                industry_key:
                  $ref: '#/components/schemas/Solaris-Decorators-IndustryKeyEnum'
                legal_form:
                  $ref: >-
                    #/components/schemas/Solaris-Decorators-BusinessLegalFormEnum
                foundation_date:
                  type: string
                  description: The date when the business was founded.
                address:
                  type: object
                  description: The business' address.
                  properties:
                    line_1:
                      type: string
                      description: Address line 1
                    line_2:
                      type: string
                      description: Address line 2
                    postal_code:
                      type: string
                      description: The business' postal code.
                    city:
                      type: string
                      description: The business' city.
                    country:
                      description: The business' country.
                      allOf:
                        - $ref: >-
                            #/components/schemas/Solaris-Server-Decorators-CountryEnum
                    state:
                      type: string
                      description: >-
                        (For German companies) The state where the business is
                        located.
                      enum:
                        - BE
                        - BB
                        - BW
                        - BY
                        - HB
                        - HE
                        - HH
                        - MV
                        - NI
                        - NW
                        - RP
                        - SH
                        - SL
                        - SN
                        - ST
                        - TH
                tax_information:
                  type: object
                  description: The business' tax information.
                  properties:
                    tax_country:
                      type: string
                      description: The business' tax country.
                      allOf:
                        - $ref: >-
                            #/components/schemas/Solaris-Server-Decorators-CountryEnum
                    tax_confirmation:
                      type: string
                      description: The business' tax confirmation interval.
                      enum:
                        - ANNUALY
                        - SINGLE
                    registration_number:
                      type: string
                      description: The business' registration number.
                    registration_issuer:
                      type: string
                      description: The authority that issued the business' registration.
                fatca_relevant:
                  type: boolean
                  description: Indicates whether or not the company is FATCA relevant.
                fatca_crs_confirmed_at:
                  type: string
                  description: >-
                    UTC timestamp when the business confirmed whether or not
                    they were FATCA relevant.
                crs_company_type:
                  type: string
                  description: The business' Common Reporting Standard (CRS) company type.
                  enum:
                    - FE_REPORTING
                    - FE_NON_REPORTING
                    - NFE_ACTIVE
                    - NFE_ACTIVE_OTHER
                    - NFE_PASSIVE
                    - NFE_PASSIVE_INVESTMENT
                balance_sheet_total:
                  type: integer
                  description: The business' total assets, in Euro cents.
                number_employees:
                  type: integer
                  description: The number of employees at the business.
                registration_type:
                  type: string
                  description: The business' registration type.
                  allOf:
                    - $ref: >-
                        #/components/schemas/Solaris-Decorators-RegistrationTypeEnum
                registration_district:
                  type: string
                  description: >-
                    (For German businesses only) The district where the business
                    is registered.
                  allOf:
                    - $ref: >-
                        #/components/schemas/Solaris-Decorators-RegistrationDistrictEnum
                business_purpose:
                  type: string
                  description: >-
                    Short summary of the purpose of the business. May also
                    include the business' web address.
                terms_conditions_signed_at:
                  type: string
                  description: >-
                    UTC timestamp when the business signed the Solaris Terms and
                    Conditions.
                vat_number:
                  type: string
                  description: The business' VAT number.
                international_operativity_expectation:
                  type: array
                  description: Regions where the business expects to operate.
                  items:
                    type: string
                    enum:
                      - AFRICA
                      - ASIA
                      - MIDDLE_EAST
                      - NORTH_AMERICA
                      - SOUTH_AMERICA
                      - NATIONAL_ACTIVITY_ONLY
                purpose_of_account_opening:
                  type: string
                  description: The business' purpose for opening the account.
                  enum:
                    - SAVINGS
                    - DAILY_EXPENSES
                    - TRAVELLING_AND_RELOCATING
                    - FREELANCER_ACTIVITY
                    - ONLINE_SHOPPING
                    - SALARY_OR_PENSION_ACCREDITATION
                    - TRADING
                    - FINANCING
                    - BUYING_AND_SELLING_GOODS
                    - MANAGEMENT_OF_INVOICES_AND_RECEIPTS
                    - TREASURY
                    - SUPPLIERS_MANAGEMENT
                    - SETTLEMENT_OF_TRANSACTIONS_TO_AND_FROM_ABROAD
                    - INVESTMENT_ACTIVITY
                    - EMPLOYEE_PAYROLL_MANAGEMENT
                source_of_funds:
                  type: string
                  description: The business' source of funds.
                  enum:
                    - REAL_ESTATE_INCOME
                    - SALE_OF_GOODS_AND_SERVICES
                    - TRANSFER_FROM_DIFFERENT_ACCOUNTS
                    - INCOME_FROM_CUSTOMERS
                    - CORPORATE_MERGERS_AND_ACQUISITIONS
                    - FINANCING
                    - SECURITIES_OR_OTHER_FINANCIAL_INSTRUMENTS
                    - TREASURY
                    - DONATIONS
                expected_annual_revenue:
                  type: string
                  description: The business' expected annual revenue.
                  enum:
                    - ENTITY_IN_CRISIS
                    - ENTITY_IN_SETUP
                    - UP_TO_ONE_MEUR
                    - ONE_M_TO_FIVE_MEUR
                    - FIVE_M_TO_TEN_MEUR
                    - MORE_THAN_TEN_MEUR
                expected_annual_incoming_funds:
                  type: string
                  description: The business' expected annual incoming funds.
                  enum:
                    - UP_TO_TEN_KEUR
                    - TEN_K_TO_FIFTY_KEUR
                    - FIFTY_K_TO_TWO_HUNDRED_KEUR
                    - TWO_HUNDRED_K_TO_ONE_MEUR
                    - ONE_M_TO_FIVE_MEUR
                    - MORE_THAN_FIVE_MEUR
                company_status:
                  type: string
                  description: The business' expected annual incoming funds.
                  enum:
                    - ACTIVE
                    - INACTIVE
                    - IN_LIQUIDATION
                    - COLLECTIVE_PROCEEDINGS
                    - IN_CONSTITUTION
              example:
                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
        required: false
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-Business'
        '202':
          description: >-
            The request was accepted, and now the customer must confirm the
            change request.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Solaris-Decorators-ChangeRequest-Start'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business#update
      x-codegen-request-body-name: body
  /v1/commercial_registrations/search_by_name:
    get:
      tags:
        - Business Registrations
      summary: Retrieve business registration number and issuer
      description: >-
        Returns the business registration number and issuer for a business by
        searching for it in the commercial registry by name and country.
      parameters:
        - name: name
          in: query
          description: The business's registered name.
          required: false
          schema:
            type: string
        - name: country
          in: query
          description: The country code where the business is registered.
          required: false
          schema:
            type: string
            default: DE
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GetSearchByNameResult'
          description: Operation was successful
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403-2'
          description: Unauthorized Action
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404-2'
          description: Model Not Found
      security:
        - oauth2:
            - solaris_service_brex_company#search_by_name
  /v1/commercial_registrations/find:
    get:
      tags:
        - Business Registrations
      summary: Search for business's commercial registration
      description: >-
        Retrieves the business's information from the commercial registry. You
        must add the business's `registration_number` and `registration_issuer`
        in the request URL.
      parameters:
        - name: registration_number
          in: query
          description: The business's commercial registration number without spaces.
          required: false
          schema:
            type: string
        - name: registration_issuer
          in: query
          description: The entity that issued the business commercial registration number.
          required: false
          schema:
            type: string
        - name: country
          in: query
          description: The country code where the business is registered.
          required: false
          schema:
            type: string
            default: DE
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRetrieveCommercialRegistryResponse'
          description: Operation was successful
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403-2'
          description: Unauthorized Action
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404-2'
          description: Model Not Found
      security:
        - oauth2:
            - solaris_service_brex_company#find
  /v1/businesses/{id}/annual_turnover:
    post:
      tags:
        - Businesses
      summary: Add Annual Turnover
      description: Add Annual Turnover to the Business
      parameters:
        - name: id
          in: path
          required: true
          description: ID of the business
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              example:
                value: 12345
              type: object
              properties:
                value:
                  description: >-
                    Annual turnover value in EUR for the business. It should be
                    a non-negative integer.
                  type: integer
        description: the content of the request
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                example:
                  value: 12345
                  created_at: '2024-10-17T05:00:00.000Z'
                  updated_at: '2024-10-17T06:01:01.001Z'
                type: object
                properties:
                  value:
                    description: Annual turnover value of the business.
                    type: integer
                  created_at:
                    description: >-
                      UTC timestamp when the annual turnover was created for the
                      business
                    type: string
                  updated_at:
                    description: >-
                      UTC timestamp when the annual turnover was updated for the
                      business
                    type: string
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessError400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessError404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_annual_turnover#create
  /v1/businesses/{business_id}/tax_identifications:
    post:
      tags:
        - Business tax identifications
      summary: Create business tax identification
      description: >-
        Creates a tax identification for the given business. Please note the
        following:<br> <ul> <li>The first `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`).</li>
        <li>A business may only have one tax identification per country.</li>
        </ul>
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                  description: The business' tax identification number (TIN).
                country:
                  type: string
                  description: The business' tax country.
                primary:
                  type: boolean
                  description: Indicates whether this is the business' primary TIN.
                reason_no_tin:
                  type: string
                  description: >-
                    Provides a reason why the tax identification does not
                    contain a TIN for the business.
                  enum:
                    - NOT_ASSIGNED_YET
                    - NOT_ASSIGNED_BY_COUNTRY
                    - OTHER
                reason_description:
                  type: string
                  description: >-
                    Additional context around why there is no TIN for the
                    business.
                valid_until:
                  type: string
                  description: Date when the tax identification becomes invalid.
                  format: date
                tax_id_type:
                  type: string
                  description: The type of tax ID provided by the business.
              example:
                number: '31659837651'
                country: DE
                primary: true
        required: false
      responses:
        '201':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-TaxIdentification
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_tax_identification#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Business tax identifications
      summary: Index business tax identifications
      description: Returns an array containing all tax identifications for a business.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Solaris-Server-Decorators-TaxIdentification
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_tax_identification#all
  /v1/businesses/{business_id}/tax_identifications/{id}:
    get:
      tags:
        - Business tax identifications
      summary: Get a business tax identification
      description: >-
        Returns information about the business tax identification specified in
        the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-TaxIdentification
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_tax_identification#find
    patch:
      tags:
        - Business tax identifications
      summary: Update a business tax identification
      description: >-
        Updates one or more properties on an existing business tax
        identification.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                  description: The business' tax identification number (TIN).
                country:
                  type: string
                  description: The business' tax country.
                primary:
                  type: boolean
                  description: Indicates whether this is the business' primary TIN.
                reason_no_tin:
                  type: string
                  description: >-
                    Provides a reason why the tax identification does not
                    contain a TIN for the business.
                  enum:
                    - NOT_ASSIGNED_YET
                    - NOT_ASSIGNED_BY_COUNTRY
                    - OTHER
                reason_description:
                  type: string
                  description: >-
                    Additional context around why there is no TIN for the
                    business.
                valid_until:
                  type: string
                  description: Date when the tax identification becomes invalid.
                  format: date
                tax_id_type:
                  type: string
                  description: The type of tax ID provided by the business.
              example:
                number: '31659837651'
                country: DE
                primary: true
        required: false
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-TaxIdentification
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_tax_identification#update
      x-codegen-request-body-name: body
  /v1/businesses/{business_id}/documents:
    get:
      tags:
        - Business documents
      summary: Index documents for a business
      description: >-
        Returns an array containing all documents for the business specified in
        the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: include_deleted
          in: query
          description: >-
            Boolean flag to determine whether or not the API should return
            documents that were deleted.
          required: false
          schema:
            type: boolean
        - name: customer_accessible
          in: query
          description: >-
            Boolean flag to determine whether the API should return documents
            that the customer has access to.
          required: false
          schema:
            type: boolean
        - name: sort
          in: query
          required: false
          description: Sort the results by document creation date (i.e., `created_at`).
          schema:
            type: string
            example: created_at
        - name: page[number]
          in: query
          description: The number of results pages to return.
          required: false
          schema:
            type: string
        - name: page[size]
          in: query
          description: The number of entries to return in each page.
          required: false
          schema:
            type: string
        - name: filter[document_type]
          in: query
          description: Filters the result by document type.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Resources-Document'
        '400':
          description: An error occurred on the client side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400-2'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403-2'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404-2'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#all
    post:
      tags:
        - Business documents
      summary: Create a document for a business
      description: >-
        Uploads a document and links it to the business specified in the request
        URL. <br> 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.<br> By default, uploaded
        documents are not accessible to customers (i.e., the
        `customer_accessible` value is set to `false`).
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  description: File to upload
                  type: string
                  format: binary
                document_type:
                  $ref: '#/components/schemas/Solaris-Enums-DocumentType'
                  example: FOUNDATION_DOCUMENT
              required:
                - file
                - document_type
        required: true
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Resources-Document'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#create
  /v1/businesses/{business_id}/documents/{id}/file:
    get:
      tags:
        - Business documents
      summary: Download a business document
      description: >-
        Downloads the file associated with the business document specified in
        the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation.
          headers:
            date:
              schema:
                type: string
                example: Sun, 13 Aug 2017 20:35:45 GMT
            x-content-type-options:
              schema:
                type: string
                example: nosniff
            content-disposition:
              schema:
                type: string
                example: attachment; filename=sample_pdf.pdf
            content-length:
              schema:
                type: integer
                example: 3028
            x-request-id:
              schema:
                type: string
                example: fbc2deff-8066-11e7-9271-02420a000109
            content-type:
              schema:
                type: string
                example: application/pdf
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '400':
          description: An error occurred on the client side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400-2'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403-2'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404-2'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#read
  /v1/businesses/{business_id}/documents/{id}:
    get:
      tags:
        - Business documents
      summary: Retrieve a business document
      description: >-
        Returns information about the business document specified in the request
        URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Resources-Document'
        '400':
          description: An error occurred on the client side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400-2'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403-2'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404-2'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#find
    delete:
      tags:
        - Business documents
      summary: Delete a business document
      description: Deletes a document for a business
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Resources-Document'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#delete
    patch:
      tags:
        - Business documents
      summary: Update business document attributes
      description: >-
        Updates one or more properties of the business document specified in the
        request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                document_type:
                  $ref: '#/components/schemas/Solaris-Enums-DocumentType'
                customer_accessible:
                  description: 'Customer accessible : Boolean'
                  type: boolean
              example:
                document_type: ACCOUNT_SNAPSHOT.FINTECSYSTEMS
                customer_accessible: true
        description: the content of the request
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Resources-Document'
        default:
          description: Unexpected error
      security:
        - oauth2:
            - solaris_service_document#update
  /v1/businesses/{business_id}/legal_representatives:
    post:
      tags:
        - Business legal representatives
      summary: Create a legal representative for a business
      description: >-
        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.<br>**Note:** A legal representative can update the `person`
        resource of any person connected to the business using the `PATCH Update
        a person` method.<br> **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](https://docs.solarisgroup.com/api-reference/onboarding/persons/#tag/Person-tax-identifications/paths/~1v1~1persons~1{person_id}~1tax_identifications/post).
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                legal_representative_id:
                  type: string
                  description: >-
                    The ID of the person or business to add as a legal
                    representative of the given business.
                type_of_representation:
                  type: string
                  description: >-
                    The type of representation to assign to the legal
                    representative.
                  enum:
                    - ALONE
                    - JOINT
                    - OTHER
                    - AUTHORIZED_PERSON
                power_of_attorney_confirmed_at:
                  type: string
                  description: >-
                    Timestamp from when the person confirmed that they have
                    power of attorney for the business.
                  format: date-time
              example:
                legal_representative_id: 0ba2211cab11af6094d60ead81f2bd9dcper
                type_of_representation: ALONE
                power_of_attorney_confirmed_at: '2017-01-01T00:00:00Z'
        required: false
      responses:
        '201':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-LegalRepresentative
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_legal_representative#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Business legal representatives
      summary: Index legal representatives of a business
      description: Returns an array containing all legal representatives of a business.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: page[number]
          in: query
          description: The number of results pages to return.
          schema:
            type: string
        - name: page[size]
          in: query
          description: The size of each page in the response.
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Solaris-Server-Decorators-LegalRepresentative
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_legal_representative#all
  /v1/businesses/{business_id}/legal_representatives/{id}:
    patch:
      tags:
        - Business legal representatives
      summary: Update a legal representative of a business
      description: >-
        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.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                valid_until:
                  type: string
                  description: The date when the legal representative's role expires.
                type_of_representation:
                  type: string
                  description: >-
                    The type of representation that the legal representative has
                    for the business.
                  enum:
                    - ALONE
                    - JOINT
                    - OTHER
                    - AUTHORIZED_PERSON
                power_of_attorney_confirmed_at:
                  type: string
                  description: >-
                    Timestamp from when the person confirmed that they have
                    power of attorney for the business.
                  format: date-time
              example:
                valid_until: '2022-12-31'
                type_of_representation: ALONE
                power_of_attorney_confirmed_at: '2017-01-01T00:00:00Z'
        required: false
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-LegalRepresentative
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_legal_representative#update
      x-codegen-request-body-name: body
    delete:
      tags:
        - Business legal representatives
      summary: Delete business legal representative
      description: >-
        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.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '204':
          description: Successful result of the operation
          content: {}
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_legal_representative#expire
  /v1/businesses/{business_id}/beneficial_owners:
    post:
      tags:
        - Beneficial Owners
      summary: Create a beneficial owner for a business
      description: >-
        Links the person with the `person_id` specified in the request body to
        the business specified in the request URL as a beneficial owner.<br>
        Please note that the person must have valid values in each of the
        following attributes: <ul> <li><code>salutation</code></li>
        <li><code>first_name</code></li> <li><code>last_name</code></li>
        <li><code>birth_date</code></li> </ul>
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                person_id:
                  type: string
                  description: >-
                    ID of the person to be associated with the business as a
                    beneficial owner.
                voting_share:
                  type: string
                  description: >-
                    The beneficial's voting share, expressed as a percentile
                    value from 0 to 100 using the format `xx.xx`.
                fictitious:
                  type: boolean
                  description: Indicates whether or not the beneficial owner is fictitious.
                relationship_to_business:
                  type: string
                  description: >-
                    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:
                person_id: 3b8cfd40fb4dce5a231251ea06a014cper
                voting_share: '70.50'
                fictitious: false
                relationship_to_business: DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL
        required: false
      responses:
        '201':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-BeneficialOwner'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_beneficial_owner#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Beneficial Owners
      summary: List all beneficial owners for a business
      description: >-
        Returns an array containing all beneficial owners associated with a
        business.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: page[number]
          in: query
          description: The number of results pages to return.
          schema:
            type: string
        - name: page[size]
          in: query
          description: The size of each page in the response.
          schema:
            type: string
        - name: include_invalid
          in: query
          description: >-
            Flag that specifies whether or not to include beneficial owners who
            are no longer valid (i.e., their `valid_until` date has passed).
          schema:
            type: boolean
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Solaris-Server-Decorators-BeneficialOwner
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_beneficial_owner#all
  /v1/businesses/{business_id}/beneficial_owners/{id}:
    get:
      tags:
        - Beneficial Owners
      summary: Get a beneficial owner of a business
      description: >-
        Returns a specific beneficial owner associated with a business as
        specified in the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-BeneficialOwner'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_beneficial_owner#find
    patch:
      tags:
        - Beneficial Owners
      summary: Update a beneficial owner of a business
      description: >-
        Updates one or more properties on the beneficial owner specified in the
        request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                valid_until:
                  type: string
                  description: >-
                    The date when the person's beneficial owner role for the
                    account expires.
                voting_share:
                  type: string
                  description: >-
                    The beneficial's voting share, expressed as a percentile
                    value from 0 to 100 using the format `xx.xx`.
                fictitious:
                  type: boolean
                  description: Indicates whether or not the beneficial owner is fictitious.
                relationship_to_business:
                  type: string
                  description: >-
                    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:
                valid_until: '2012-12-12'
                voting_share: '70.50'
                fictitious: false
                relationship_to_business: DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL
        required: false
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-BeneficialOwner'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_beneficial_owner#update
      x-codegen-request-body-name: body
  /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons:
    post:
      tags:
        - Authorized persons
      summary: Create an authorized person on a business account
      description: >-
        Links a `person` to a business account as an authorized person. <br>
        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 `type_of_representation` value of
        `ALONE` or `null`. Note that the `person` resource must have values for
        the following properties:<br> <ul> <li><code>address_line_1</code>
        (street)</li> <li><code>birth_city</code></li>
        <li><code>birth_date</code></li> <li><code>country</code></li>
        <li><code>first_name</code></li> <li><code>last_name</code></li>
        <li><code>nationality</code></li> <li><code>salutation</code></li> </ul>
        <br> **Note**: 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](https://docs.solarisgroup.com/api-reference/onboarding/persons/#tag/Person-tax-identifications/paths/~1v1~1persons~1{person_id}~1tax_identifications/post).
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: account_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                authorized_person_id:
                  type: string
                  description: >-
                    The ID of the person to add to the business account as an
                    authorized person.
              example:
                authorized_person_id: 3b8cfd40fb4dce5a231251ea06a014cper
        required: false
      responses:
        '201':
          description: >-
            The change request was successfully confirmed, and the authorized
            person is now added to the account.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-AuthorizedPerson
        '202':
          description: >-
            The request was accepted and now the legal representative must
            confirm the change request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Decorators-ChangeRequest-Start'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_account_authorization#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Authorized persons
      summary: Index business account authorized persons
      description: >-
        Returns an array containing all authorized persons on the business
        account specified in the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: account_id
          in: path
          required: true
          schema:
            type: string
        - name: page[number]
          in: query
          description: The number of results pages to return.
          schema:
            type: string
        - name: page[size]
          in: query
          description: The size of each page in the response.
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Solaris-Server-Decorators-AuthorizedPerson
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_account_authorization#all
  /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons/{id}:
    get:
      tags:
        - Authorized persons
      summary: Get business account authorized person
      description: >-
        Returns a specific authorized person on a business account based on the
        ID in the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: account_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Solaris-Server-Decorators-AuthorizedPerson
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_account_authorization#find
    delete:
      tags:
        - Authorized persons
      summary: Remove authorized person from a business account
      description: >-
        Removes the authorized person specified in the request URL from the
        given business.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: account_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Successful result of the operation, the authorized person is deleted
            from the account.
          content: {}
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_business_account_authorization#expire
  /v1/businesses/{business_id}/signees:
    post:
      tags:
        - Business signees
      summary: Create a business signee
      description: Assigns a person to the given business as a signee.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: The content of the request.
        content:
          application/json:
            schema:
              type: object
              properties:
                person_id:
                  type: string
                  description: ID of the person to add to the business as a signee.
              example:
                person_id: 0ba2211cab11af6094d60ead81f2bd9dcper
        required: false
      responses:
        '201':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Solaris-Server-Decorators-Signee'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_signee#create
      x-codegen-request-body-name: body
    get:
      tags:
        - Business signees
      summary: Index business signees
      description: Returns an array containing all signees for the given business.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful result of the operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Solaris-Server-Decorators-Signee'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_signee#all
  /v1/businesses/{business_id}/signees/{id}:
    delete:
      tags:
        - Business signees
      summary: Delete business signee
      description: Deletes the business signee specified in the request URL.
      parameters:
        - name: business_id
          in: path
          required: true
          schema:
            type: string
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '204':
          description: Successful result of the operation
          content: {}
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '403':
          description: You are not authorized to perform this action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
        '404':
          description: The resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
        default:
          description: Unexpected error
          content: {}
      security:
        - oauth2:
            - solaris_service_signee#expire
components:
  schemas:
    Solaris-Decorators-IndustryEnum:
      type: string
      description: >-
        The business' industry. This field is deprecated; please use `nace_code`
        instead.
      enum:
        - BUILDING_INDUSTRY
        - CHEMICAL_INDUSTRY_COKE_OVEN_MINERAL_OIL
        - CONSUMER_INSTALMENT_CREDITS
        - DEBIT_BALANCE_SALARY_ACCOUNT
        - FARMER_FORESTRY_FISHING_AND_AQUACULTURE
        - FINANCIAL_INSTITUTIONS_INSURANCE
        - FINANCIAL_LEASING_COMPANIES
        - FOOD_INDUSTRY_TOBACCO_PRODUCTS
        - GASTRONOMY
        - HEALTH_CARE_VETERIN_A_WELFARE_FIRM_FREELANCE
        - HOLDING_COMPANIES
        - HOUSING_COMPANIES
        - INFORMATION_AND_COMMUNICATION
        - INSTALMENT_CREDITS
        - LEASING_OF_MOVABLE_OBJECTS
        - LEATHER_TEXTILE_CLOTHES_INDUSTRY
        - MANUFACTURE_DATA_PROC_EQUIPMENT_ELECTRIC_OPTICS
        - MANUFACTURE_PLASTICS_RUBBER_GOODS
        - MECHANICAL_ENGINEERING_VEHICLE_MANUFACTURING
        - METAL_PRODUCTION_PROCESSING
        - NONE
        - OTHER_ECONOMIC_SERVICES
        - OTHER_PROPERTY_MANAGEMENT
        - OTHER_SERVICES
        - POWER_WATER_SUPPLY_DISPOSAL_MINING
        - SCIENTIFIC_TECHNICAL_CONSULTING_SERVICES
        - STONE_SOIL_CERAMICS_GLASS
        - TRADE_MAINTENANCE_AND_REPAIR_OF_VEHICLES
        - TRANSPORT_AND_STORAGE_AND_NEWS_TRANSMISSION
        - WOOD_PAPER_PRINT_INDUSTRY_FURNITURE_ETC
        - NON_PROFIT_ORGANIZATION
        - NON_MARKET_PRODUCERS
        - ORGANIZATION_WITHOUT_ACQUIRING_HOUSE_BUILDING
        - OTHER_INDUSTRY
    Solaris-Decorators-IndustryKeyEnum:
      type: string
      description: >-
        Additional information about the industry in which the business
        operates. This field is deprecated; please use `nace_code` instead.
      enum:
        - ACCOMMODATION
        - >-
          ACTIVITIES_OF_BUSINESS_EMPLOYERS_AND_PROFESSIONAL_MEMBERSHIP_ORGANISATIONS
        - ACTIVITIES_OF_HEAD_OFFICES
        - >-
          ACTIVITIES_OF_INVESTMENT_STOCK_CORPORATIONS_AND_FUNDS_OF_INVESTMENT_MANAGEMENT_COMPANIES_EXCL_MONEY_MARKET_FUNDS
        - ADULT_ENTERTAINMENT_AND_ONLINE_DATING_AND_RELATED
        - ADVERTISING_AND_MARKET_RESEARCH
        - AIR_TRANSPORT
        - >-
          ARCHITECTURAL_AND_ENGINEERING_ACTIVITIES_TECHNICAL_TESTING_AND_ANALYSIS
        - BUYING_AND_SELLING_OF_OWN_NON_RESIDENTIAL_REAL_ESTATE
        - BUYING_AND_SELLING_OF_OWN_RESIDENTIAL_REAL_ESTATE
        - CAPITAL_HOLDING_COMPANY
        - CIVIL_ENGINEERING
        - COMPUTER_PROGRAMMING_CONSULTANCY_AND_RELATED_ACTIVITIES
        - CONSTRUCTION_OF_BUILDINGS
        - CREATIVE_ARTS_AND_ENTERTAINMENT_ACTIVITIES
        - CROP_AND_ANIMAL_PRODUCTION_HUNTING_AND_RELATED_SERVICE_ACTIVITIES
        - ECONOMICALLY_DEPENDENT_INDIVIDUALS
        - EDUCATION
        - ELECTRICITY_GAS_STEAM_AND_AIR_CONDITIONING_SUPPLY
        - EMPLOYMENT_ACTIVITIES
        - IMPORT_EXPORT_OF_RAW_MATERIALS_SUCH_AS_OIL_GAS_MINING_AND_EXPLOITATION
        - INSURANCE_REINSURANCE_EXCEPT_PENSION_FUNDING
        - FINANCIAL_LEASING
        - FISHING_AND_AQUACULTURE
        - FOOD_AND_BEVERAGE_SERVICE_ACTIVITIES
        - FORESTRY_AND_LOGGING
        - GAMBLING_AND_BETTING_ACTIVITIES
        - HOLDING_COMPANIES_WITHOUT_MANAGEMENT_FUNCTION
        - HUMAN_HEALTH_ACTIVITIES
        - INFORMATION_SERVICE_ACTIVITIES
        - LAND_TRANSPORT_AND_TRANSPORT_VIA_PIPELINES
        - LEGAL_AND_ACCOUNTING_ACTIVITIES
        - LIBRARIES_ARCHIVES_MUSEUMS_AND_OTHER_CULTURAL_ACTIVITIES
        - MANAGEMENT_CONSULTANCY_ACTIVITIES
        - MANUFACTURE_OF_BASIC_METALS
        - >-
          MANUFACTURE_OF_BASIC_PHARMACEUTICAL_PRODUCTS_AND_PHARMACEUTICAL_PREPARATIONS
        - MANUFACTURE_OF_BEVERAGES
        - MANUFACTURE_OF_CHEMICALS_AND_CHEMICAL_PRODUCTS
        - MANUFACTURE_OF_COKE_AND_REFINED_PETROLEUM_PRODUCTS
        - MANUFACTURE_OF_COMPUTER_ELECTRONIC_AND_OPTICAL_PRODUCTS
        - MANUFACTURE_OF_ELECTRICAL_EQUIPMENT
        - >-
          MANUFACTURE_OF_FABRICATED_METAL_PRODUCTS_EXCEPT_MACHINERY_AND_EQUIPMENT
        - MANUFACTURE_OF_FOOD_PRODUCTS
        - MANUFACTURE_OF_FURNITURE
        - MANUFACTURE_OF_LEATHER_AND_RELATED_PRODUCTS
        - MANUFACTURE_OF_MACHINERY_AND_EQUIPMENT_N_E_C
        - MANUFACTURE_OF_MOTOR_VEHICLES_TRAILERS_AND_SEMI_TRAILERS
        - MANUFACTURE_OF_PRECIOUS_METALS_OR_STONES
        - MANUFACTURE_OF_OTHER_TRANSPORT_EQUIPMENT
        - MANUFACTURE_OF_PAPER_AND_PAPER_PRODUCTS
        - MANUFACTURE_OF_RUBBER_AND_PLASTIC_PRODUCTS
        - MANUFACTURE_OF_TEXTILES
        - MANUFACTURE_OR_TRADE_OF_ALCOHOL_OR_CIGARETTES
        - MANUFACTURE_OF_WEARING_APPAREL
        - >-
          MANUFACTURE_OF_WOOD_AND_OF_PRODUCTS_OF_WOOD_AND_CORK_EXCEPT_FURNITURE_MANUFACTURE_OF_ARTICLES_OF_STRAW_AND_PLAITING_MATERIALS
        - MINING_OF_COAL_AND_LIGNITE
        - MINING_OF_METAL_ORES
        - >-
          MOTION_PICTURE_VIDEO_AND_TELEVISION_PROGRAMME_PRODUCTION_SOUND_RECORDING_AND_MUSIC_PUBLISHING_ACTIVITIES
        - NONE
        - >-
          OFFICE_ADMINISTRATIVE_OFFICE_SUPPORT_AND_OTHER_BUSINESS_SUPPORT_ACTIVITIES
        - OTHER_MANUFACTURING
        - WHOLESALE_RETAIL_OF_PRECIOUS_METALS_OR_STONES
        - OTHER_CREDIT_GRANTING
        - OTHER_PERSONAL_SERVICE_ACTIVITIES
        - OTHER_PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_ACTIVITIES
        - OWN_ASSET_MANAGEMENT
        - PENSION_FUNDING_EXCEPT_COMPULSORY_SOCIAL_SECURITY
        - POSTAL_AND_COURIER_ACTIVITIES
        - PRINTING_AND_REPRODUCTION_OF_RECORDED_MEDIA
        - PROGRAMMING_AND_BROADCASTING_ACTIVITIES
        - PUBLISHING_ACTIVITIES
        - REMEDIATION_ACTIVITIES_AND_OTHER_WASTE_MANAGEMENT_SERVICES
        - RENTAL_AND_LEASING_ACTIVITIES
        - REPAIR_AND_INSTALLATION_OF_MACHINERY_AND_EQUIPMENT
        - REPAIR_OF_COMPUTERS_AND_PERSONAL_AND_HOUSEHOLD_GOODS
        - RESIDENTIAL_CARE_ACTIVITIES
        - RETAIL_TRADE_EXCEPT_OF_MOTOR_VEHICLES_AND_MOTORCYCLES
        - SCIENTIFIC_RESEARCH_AND_DEVELOPMENT
        - SECURITY_AND_INVESTIGATION_ACTIVITIES
        - SERVICES_TO_BUILDINGS_AND_LANDSCAPE_ACTIVITIES
        - SEWERAGE
        - SOCIAL_WORK_ACTIVITIES_WITHOUT_ACCOMMODATION
        - SPECIALISED_CONSTRUCTION_ACTIVITIES
        - SPORTS_ACTIVITIES_AND_AMUSEMENT_AND_RECREATION_ACTIVITIES
        - TELECOMMUNICATIONS
        - >-
          TRAVEL_AGENCY_TOUR_OPERATOR_AND_OTHER_RESERVATION_SERVICE_AND_RELATED_ACTIVITIES
        - TRUSTS_FUNDS_AND_SIMILAR_FINANCIAL_ENTITIES
        - VETERINARY_ACTIVITIES
        - WAREHOUSING_AND_SUPPORT_ACTIVITIES_FOR_TRANSPORTATION
        - WASTE_COLLECTION_TREATMENT_AND_DISPOSAL_ACTIVITIES_MATERIALS_RECOVERY
        - WATER_COLLECTION_TREATMENT_AND_SUPPLY
        - WATER_TRANSPORT
        - >-
          WHOLESALE_AND_RETAIL_TRADE_AND_REPAIR_OF_MOTOR_VEHICLES_AND_MOTORCYCLES
        - WHOLESALE_TRADE_EXCEPT_OF_MOTOR_VEHICLES_AND_MOTORCYCLES
        - PRIVATE_NON_PROFIT_ORGANIZATIONS
        - ACTIVITIES_AUXILIARY_TO_FINANCIAL_SERVICES_AND_INSURANCE_ACTIVITIES
        - >-
          ADMINISTRATION_OF_THE_STATE_AND_THE_ECONOMIC_AND_SOCIAL_POLICY_OF_THE_COMMUNITY
        - COMPULSORY_SOCIAL_SECURITY_ACTIVITIES
        - OTHER_INDUSTRY_KE
    Solaris-Decorators-BusinessLegalFormEnum:
      type: string
      description: >-
        The business' legal form. Check the [Onboarding requirements
        guide](https://docs.solarisgroup.com/guides/get-started/onboarding-requirements/2-data-collection/#legal-form-per-country)
        for the mapping between legal form and tax country.
      enum:
        - AT_SE
        - AT_OHG
        - AT_KG
        - AT_AG
        - AT_GESMBH
        - AT_EG
        - AT_GBR
        - AT_EV
        - AT_SOLE_PROPRIETORSHIP
        - AT_SELF_EMPLOYED
        - AT_AMT
        - AT_KOR
        - AT_STIFTUNGEN
        - AT_GMBH
        - AT_GMBH_CO_KG
        - BE_SNC
        - BE_SCS
        - BE_SA
        - BE_SPRL
        - BE_SE
        - BE_SCA
        - BE_SC
        - BE_SCRI
        - BE_SEP
        - BE_SF
        - BE_SPRLU
        - BE_SOLE_PROPRIETORSHIP
        - BE_SELF_EMPLOYED
        - BG_AD
        - BG_OOD
        - BG_KDA
        - BG_KD
        - BG_SD
        - BG_SELF_EMPLOYED
        - BG_SOLE_PROPRIETORSHIP
        - HR_DD
        - HR_DOO
        - HR_JDOO
        - HR_KD
        - HR_JTD
        - HR_SELF_EMPLOYED
        - HR_SOLE_PROPRIETORSHIP
        - HR_ORTA
        - CZ_AS
        - CZ_SRO
        - CZ_KS
        - CZ_VOS
        - CZ_DRUZSTVO
        - CZ_FYZICKA_OSOBA
        - CZ_SOLE_PROPRIETORSHIP
        - CZ_SELF_EMPLOYED
        - FR_AE
        - FR_EI
        - FR_SNC
        - FR_SCS
        - FR_SA
        - FR_SAS
        - FR_SARL
        - FR_SE
        - FR_SCA
        - FR_EURL
        - FR_SC
        - FR_SCOP
        - FR_SELARL
        - FR_SOLE_PROPRIETORSHIP
        - FR_SELF_EMPLOYED
        - AG
        - EG
        - EK
        - EV
        - NEV
        - GBR
        - GMBH
        - GMBH_CO_KG
        - GMBH_I_GR
        - KG
        - KGAA
        - LTD
        - MUNICIPALITY
        - MUNICIPAL_COMPANY
        - NONE
        - OHG
        - PARTG
        - PRIVATE_PERSON
        - SAVINGS_BANK
        - SE
        - SELF_EMPLOYED
        - SOLE_PROPRIETORSHIP
        - UG
        - UG_I_GR
        - FOREIGN_CORPORATION
        - ADOR
        - AMT
        - KDOR
        - STIFTUNGEN
        - SECOKG
        - AGCOKG
        - HU_NYRT
        - HU_KFT
        - HU_BT
        - HU_KKT
        - HU_SOLE_PROPRIETORSHIP
        - HU_SELF_EMPLOYED
        - HU_ORTA
        - IT_SE
        - IT_SNC
        - IT_SAS
        - IT_SPA
        - IT_SRL
        - IT_SAPA
        - IT_SCPA
        - IT_SCARL
        - IT_SCOP
        - IT_SS
        - IT_SOLE_PROPRIETORSHIP
        - IT_SELF_EMPLOYED
        - LU_SNC
        - LU_SCS
        - LU_SA
        - LU_SARL
        - LU_SE
        - LU_SCA
        - LU_SCSP
        - LU_SARLS
        - LU_SC
        - LU_SCOP
        - LU_SOLE_PROPRIETORSHIP
        - LU_SELF_EMPLOYED
        - LU_SECA
        - LU_ASBL
        - LU_FON
        - LU_SP
        - PL_SA
        - PL_SPZOO
        - PL_SE
        - PL_SKA
        - PL_SPK
        - PL_SPJ
        - PL_SELF_EMPLOYED
        - PL_OTHER
        - PT_SNC
        - PT_SC
        - PT_SA
        - PT_LDA
        - PT_SE
        - PT_SUNI
        - PT_EIRL
        - PT_SCIV
        - PT_COP
        - PT_SOLE_PROPRIETORSHIP
        - PT_SELF_EMPLOYED
        - RO_SA
        - RO_SRL
        - RO_SCA
        - RO_SCS
        - RO_SNC
        - RO_SELF_EMPLOYED
        - RO_SOLE_PROPRIETORSHIP
        - RS_AD
        - RS_DOO
        - RS_KD
        - RS_OD
        - RS_SELF_EMPLOYED
        - RS_SOLE_PROPRIETORSHIP
        - SI_DD
        - SI_DOO
        - SI_KDD
        - SI_KD
        - SI_DNO
        - SI_SELF_EMPLOYED
        - SI_SOLE_PROPRIETORSHIP
        - ES_SRC
        - ES_SC
        - ES_SA
        - ES_SAS
        - ES_SRL
        - ES_SE
        - ES_SCA
        - ES_SLNE
        - ES_SAU
        - ES_SLU
        - ES_SPRO
        - ES_SCOP
        - ES_SOLE_PROPRIETORSHIP
        - ES_SELF_EMPLOYED
        - CH_DE_AG
        - CH_FR_SA
        - CH_IT_SA
        - CH_DE_GMBH
        - CH_FR_SARL
        - CH_IT_SAGL
        - CH_SE
        - CH_DE_KOMAG
        - CH_FR_SCA
        - CH_IT_SACA
        - CH_DE_KG
        - CH_FR_SCM
        - CH_IT_SAC
        - CH_DE_KIG
        - CH_FR_SNC
        - CH_IT_SNC
        - CH_DE_EG
        - CH_FR_SS
        - CH_IT_SS
        - CH_SELF_EMPLOYED
        - CH_SOLE_PROPRIETORSHIP
        - CH_DE_KMG
        - NL_VOF
        - NL_CV
        - NL_NV
        - NL_BV
        - NL_SE
        - NL_CVOA
        - NL_COPV
        - NL_MTS
        - NL_SOLE_PROPRIETORSHIP
        - NL_SELF_EMPLOYED
        - NL_VERENIGING
        - NL_STICHT
        - TR_ADI_SIR
        - TR_AS
        - TR_LS
        - TR_KOM_STI
        - TR_KOLL_STI
        - TR_SELF_EMPLOYED
        - TR_SOLE_PROPRIETORSHIP
        - GB_SE
        - GB_PARTNERSHIP
        - GB_LP
        - GB_PLC
        - GB_LTD
        - GB_COPS
        - GB_UAS
        - GB_PRCU
        - GB_PUCU
        - GB_SOLE_PROPRIETORSHIP
        - GB_SELF_EMPLOYED
    Solaris-Server-Decorators-CountryEnum:
      type: string
      enum:
        - AD
        - AE
        - AF
        - AG
        - AI
        - AL
        - AM
        - AO
        - AQ
        - AR
        - AS
        - AT
        - AU
        - AW
        - AX
        - AZ
        - BA
        - BB
        - BD
        - BE
        - BF
        - BG
        - BH
        - BI
        - BJ
        - BL
        - BM
        - BN
        - BO
        - BQ
        - BR
        - BS
        - BT
        - BV
        - BW
        - BY
        - BZ
        - CA
        - CC
        - CD
        - CF
        - CG
        - CH
        - CI
        - CK
        - CL
        - CM
        - CN
        - CO
        - CR
        - CU
        - CV
        - CW
        - CX
        - CY
        - CZ
        - DE
        - DJ
        - DK
        - DM
        - DO
        - DZ
        - EC
        - EE
        - EG
        - EH
        - ER
        - ES
        - ET
        - FI
        - FJ
        - FK
        - FM
        - FO
        - FR
        - GA
        - GB
        - GD
        - GE
        - GF
        - GG
        - GH
        - GI
        - GL
        - GM
        - GN
        - GP
        - GQ
        - GR
        - GS
        - GT
        - GU
        - GW
        - GY
        - HK
        - HM
        - HN
        - HR
        - HT
        - HU
        - ID
        - IE
        - IL
        - IM
        - IN
        - IO
        - IQ
        - IR
        - IS
        - IT
        - JE
        - JM
        - JO
        - JP
        - KE
        - KG
        - KH
        - KI
        - KM
        - KN
        - KP
        - KR
        - KW
        - KY
        - KZ
        - LA
        - LB
        - LC
        - LI
        - LK
        - LR
        - LS
        - LT
        - LU
        - LV
        - LY
        - MA
        - MC
        - MD
        - ME
        - MF
        - MG
        - MH
        - MK
        - ML
        - MM
        - MN
        - MO
        - MP
        - MQ
        - MR
        - MS
        - MT
        - MU
        - MV
        - MW
        - MX
        - MY
        - MZ
        - NA
        - NC
        - NE
        - NF
        - NG
        - NI
        - NL
        - 'NO'
        - NP
        - NR
        - NU
        - NZ
        - OM
        - PA
        - PE
        - PF
        - PG
        - PH
        - PK
        - PL
        - PM
        - PN
        - PR
        - PS
        - PT
        - PW
        - PY
        - QA
        - RE
        - RO
        - RS
        - RU
        - RW
        - SA
        - SB
        - SC
        - SD
        - SE
        - SG
        - SH
        - SI
        - SJ
        - SK
        - SL
        - SM
        - SN
        - SO
        - SR
        - SS
        - ST
        - SV
        - SX
        - SY
        - SZ
        - TC
        - TD
        - TF
        - TG
        - TH
        - TJ
        - TK
        - TL
        - TM
        - TN
        - TO
        - TR
        - TT
        - TV
        - TW
        - TZ
        - UA
        - UG
        - UM
        - US
        - UY
        - UZ
        - VA
        - VC
        - VE
        - VG
        - VI
        - VN
        - VU
        - WF
        - WS
        - XK
        - YE
        - YT
        - ZA
        - ZM
        - ZW
    Solaris-Decorators-RegistrationTypeEnum:
      type: string
      enum:
        - AT_FB_CD
        - AT_GEM_CD
        - AT_IDENT_CD
        - AT_LAE_CD
        - AT_ZVR_CD
        - BE_OND_CD
        - BG_BULSTAT_CD
        - BG_OTHER_CD
        - BG_UIC_CD
        - BG_VAT_CD
        - CY_DRCOR_CD
        - CY_NOTAP_CD
        - CY_TIC_CD
        - CY_VAT_CD
        - CZ_ICO_CD
        - CZ_NID_CD
        - DE_GNR_CD
        - DE_HRA_CD
        - DE_HRB_CD
        - DE_NOTAP_CD
        - DE_PR_CD
        - DE_VR_CD
        - DK_CVR_CD
        - DK_FT_CD
        - DK_NOTAP_CD
        - EE_FON_CD
        - EE_RG_CD
        - ES_NIF_CD
        - FI_ALV_CD
        - FI_NOTAP_CD
        - FI_SIRA_CD
        - FI_Y_CD
        - FR_CIB
        - FR_SIREN_CD
        - GEN_IPF_CD
        - GEN_NBR_ENTTY_CD
        - GEN_NCB_ENTTY_CD
        - GEN_NSA_ENTTY_CD
        - GEN_NSI_ENTTY_CD
        - GEN_OTHER_CD
        - GEN_PS_CD
        - GEN_TAX_CD
        - GEN_TRD_RGSTR_ENTTY_CD
        - GEN_VAT_CD
        - GR_AFM_CD
        - GR_IMO_CD
        - HR_MB_CD
        - HR_MBS_CD
        - HR_OIB_CD
        - HU_CEG_CD
        - HU_FB_CD
        - HU_KOZ_CD
        - HU_TOR_CD
        - IE_CRO_CD
        - IE_VAT_CD
        - IT_CCIAA_CD
        - IT_CF_CD
        - IT_UCITS_CD
        - LT_INV_CD
        - LT_JAR_CD
        - LU_RSC_CD
        - LV_FON_CD
        - LV_NBR_CD
        - LV_VAT_CD
        - MT_CNUM_CD
        - MT_OLE_CD
        - MT_VAT_CD
        - NL_KVK_CD
        - NL_RSIN_CD
        - PL_KRS_CD
        - PL_NIP_CD
        - PL_REGON_CD
        - PL_VAT_CD
        - PT_FSA_CD
        - PT_NIF_CD
        - RO_CUI_CD
        - RO_TAX_CD
        - RO_TRN_CD
        - SE_FIN_CD
        - SE_MOM_CD
        - SE_ORG_CD
        - SI_DAV_CD
        - SI_DDV_CD
        - SI_MAT_CD
        - SK_ICO_CD
    Solaris-Decorators-RegistrationDistrictEnum:
      type: string
      enum:
        - AACHEN
        - ALTENBURG
        - AMBERG
        - ANSBACH
        - APOLDA
        - ARNSBERG
        - ARNSTADT
        - ARNSTADT_ZWEIGSTELLE_ILMENAU
        - ASCHAFFENBURG
        - AUGSBURG
        - AURICH
        - BAD_HERSFELD
        - BAD_HOMBURG_VDH
        - BAD_KREUZNACH
        - BAD_OEYNHAUSEN
        - BAD_SALZUNGEN
        - BAMBERG
        - BAYREUTH
        - BERLIN_CHARLOTTENBURG
        - BIELEFELD
        - BOCHUM
        - BONN
        - BRAUNSCHWEIG
        - BREMEN
        - CHEMNITZ
        - COBURG
        - COESFELD
        - COTTBUS
        - DARMSTADT
        - DEGGENDORF
        - DORTMUND
        - DRESDEN
        - DUISBURG
        - DUEREN
        - DUESSELDORF
        - EISENACH
        - ERFURT
        - ESCHWEGE
        - ESSEN
        - FLENSBURG
        - FRANKFURT_AM_MAIN
        - FRANKFURT_ODER
        - FREIBURG
        - FRIEDBERG
        - FRITZLAR
        - FULDA
        - FUERTH
        - GELSENKIRCHEN
        - GERA
        - GIESSEN
        - GOTHA
        - GOETTINGEN
        - GREIFSWALD
        - GREIZ
        - GUESTROW
        - GUETERSLOH
        - HAGEN
        - HAMBURG
        - HAMM
        - HANAU
        - HANNOVER
        - HEILBAD_HEILIGENSTADT
        - HILDBURGHAUSEN
        - HILDESHEIM
        - HOF
        - HOMBURG
        - INGOLSTADT
        - ISERLOHN
        - JENA
        - KAISERSLAUTERN
        - KASSEL
        - KEMPTEN_ALLGAUE
        - KIEL
        - KLEVE
        - KOBLENZ
        - KOELN
        - KOENIGSTEIN
        - KORBACH
        - KREFELD
        - LANDAU
        - LANDSHUT
        - LEBACH
        - LEIPZIG
        - LEMGO
        - LIMBURG
        - LUEBECK
        - LUDWIGSHAFEN_A_RHEIN_LUDWIGSHAFEN
        - LUDWIGSLUST
        - LUENEBURG
        - MAINZ
        - MANNHEIM
        - MARBURG
        - MEININGEN
        - MEMMINGEN
        - MERZIG
        - MOENCHENGLADBACH
        - MONTABAUR
        - MUEHLHAUSEN
        - MUENCHEN
        - MUENSTER
        - NEUBRANDENBURG
        - NEUNKIRCHEN
        - NEURUPPIN
        - NEUSS
        - NORDHAUSEN
        - NUERNBERG
        - OFFENBACH_AM_MAIN
        - OLDENBURG_OLDENBURG
        - OSNABRUECK
        - OTTWEILER
        - PADERBORN
        - PASEWALK
        - PASSAU
        - PINNEBERG
        - POESSNECK
        - POESSNECK_ZWEIGSTELLE_BAD_LOBENSTEIN
        - POTSDAM
        - RECKLINGHAUSEN
        - REGENSBURG
        - RIBNITZ_DAMGARTEN
        - ROSTOCK
        - RUDOLSTADT
        - RUDOLSTADT_ZWEIGSTELLE_SAALFELD
        - SAARBRUECKEN
        - SAARLOUIS
        - SCHWEINFURT
        - SCHWERIN
        - SIEGBURG
        - SIEGEN
        - SOEMMERDA
        - SONDERSHAUSEN
        - SONNEBERG
        - ST_INGBERT_ST_INGBERT
        - ST_WENDEL_ST_WENDEL
        - STADTHAGEN
        - STADTRODA
        - STEINFURT
        - STENDAL
        - STRALSUND
        - STRAUBING
        - STUTTGART
        - SUHL
        - TOSTEDT
        - TRAUNSTEIN
        - ULM
        - VOELKLINGEN
        - WALSRODE
        - WAREN_MUERITZ
        - WEIDEN_ID_OPF
        - WEIMAR
        - WETZLAR
        - WIESBADEN
        - WISMAR
        - WITTLICH
        - WUPPERTAL
        - WUERZBURG
        - ZWEIBRUECKEN
    Solaris-Server-Decorators-Business:
      type: object
      properties:
        id:
          type: string
          description: ID of the business.
          example: e0277fae750a4c849660da873f94cbiz
        name:
          type: string
          description: The name of the business. Limited to 255 characters.
        sector:
          type: string
          description: >-
            The sector of the business. Please note that the business'
            `tax_country` determines the allowed values you may store in the
            `sector` property, and the value of `sector` determines the allowed
            values you may store in the `legal_form` and `industry`/`nace_code`
            properties.
          enum:
            - ECONOMICALLY_SELF_EMPLOYED
            - ECONOMIC_DEPENDENT
            - FOREIGN_COMPANIES
            - FOREIGN_ECONOMIC_DEPENDENT
            - FOREIGN_PRIVATE_INDIVIDUAL
            - FOREIGN_SELF_EMPLOYED_PRIVATE_PERSON
            - GERMAN_BANKS
            - MUNICIPALITY_AND_MUNICIPALITY_ASSOCIATION
            - OTHER_COMPANIES_WORKMAN
            - OTHER_COMPANIES
            - OTHER_PRIVATE_INDIVIDUAL
        industry:
          $ref: '#/components/schemas/Solaris-Decorators-IndustryEnum'
        industry_key:
          $ref: '#/components/schemas/Solaris-Decorators-IndustryKeyEnum'
        legal_form:
          $ref: '#/components/schemas/Solaris-Decorators-BusinessLegalFormEnum'
        foundation_date:
          type: string
          description: The date when the business was founded.
        address:
          type: object
          description: The business' address.
          properties:
            line_1:
              type: string
              description: Address line 1
            line_2:
              type: string
              description: Address line 2
            postal_code:
              type: string
              description: The business' postal code.
            city:
              type: string
              description: The business' city.
            country:
              description: The business' country.
              allOf:
                - $ref: '#/components/schemas/Solaris-Server-Decorators-CountryEnum'
            state:
              type: string
              description: (For German companies) The state where the business is located.
              enum:
                - BE
                - BB
                - BW
                - BY
                - HB
                - HE
                - HH
                - MV
                - NI
                - NW
                - RP
                - SH
                - SL
                - SN
                - ST
                - TH
        tax_information:
          type: object
          description: The business' tax information.
          properties:
            tax_country:
              type: string
              description: The business' tax country.
              allOf:
                - $ref: '#/components/schemas/Solaris-Server-Decorators-CountryEnum'
            tax_confirmation:
              type: string
              description: The business' tax confirmation interval.
              enum:
                - ANNUALY
                - SINGLE
            registration_number:
              type: string
              description: The business' registration number.
            registration_issuer:
              type: string
              description: The authority that issued the business' registration.
        aml_follow_up_date:
          type: string
          format: date-time
          description: Anti-money laundering follow-up date
          example: '2021-01-30T08:30:00Z'
        fatca_relevant:
          type: boolean
          description: Indicates whether or not the company is FATCA relevant.
        fatca_crs_confirmed_at:
          type: string
          description: >-
            UTC timestamp when the business confirmed whether or not they were
            FATCA relevant.
        crs_company_type:
          type: string
          description: The business' Common Reporting Standard (CRS) company type.
          enum:
            - FE_REPORTING
            - FE_NON_REPORTING
            - NFE_ACTIVE
            - NFE_ACTIVE_OTHER
            - NFE_PASSIVE
            - NFE_PASSIVE_INVESTMENT
        business_purpose:
          type: string
          description: >-
            Short summary of the purpose of the business. May also include the
            business' web address.
        terms_conditions_signed_at:
          type: string
          description: >-
            UTC timestamp when the business signed the Solaris Terms and
            Conditions.
        flagged_by_compliance:
          type: string
          description: Any Compliance questions for the customer?
        balance_sheet_total:
          type: integer
          description: The business' total assets, in Euro cents.
        number_employees:
          type: integer
          description: The number of employees at the business.
        registration_type:
          type: string
          description: The business' registration type.
          allOf:
            - $ref: '#/components/schemas/Solaris-Decorators-RegistrationTypeEnum'
        registration_district:
          type: string
          description: >-
            (For German businesses only) The district where the business is
            registered.
          allOf:
            - $ref: '#/components/schemas/Solaris-Decorators-RegistrationDistrictEnum'
        screening_progress:
          type: string
          description: The current status of the risk screening process for the business.
          enum:
            - NOT_SCREENED
            - POTENTIAL_MATCH
            - SCREENED_ACCEPTED
            - SCREENED_DECLINED
        international_operativity_expectation:
          type: array
          description: Regions where the business expects to operate.
          items:
            type: string
            enum:
              - AFRICA
              - ASIA
              - MIDDLE_EAST
              - NORTH_AMERICA
              - SOUTH_AMERICA
              - NATIONAL_ACTIVITY_ONLY
        vat_number:
          type: string
          description: The business' VAT number.
        risk_classification_status:
          type: string
          description: The business' risk classification status.
          enum:
            - NOT_SCORED
            - POTENTIAL_RISK
            - NORMAL_RISK
            - INFORMATION_REQUESTED
            - INFORMATION_RECEIVED
            - RISK_ACCEPTED
            - RISK_REJECTED
            - CUSTOMER_UNRESPONSIVE
            - SCORING_NOT_REQUIRED
        customer_vetting_status:
          type: string
          description: The status of the customer vetting process for the business.
          enum:
            - NOT_VETTED
            - NO_MATCH
            - POTENTIAL_MATCH
            - INFORMATION_REQUESTED
            - INFORMATION_RECEIVED
            - RISK_ACCEPTED
            - RISK_REJECTED
            - CUSTOMER_UNRESPONSIVE
            - VETTING_NOT_REQUIRED
        purpose_of_account_opening:
          type: string
          description: The business' purpose for opening the account.
          enum:
            - SAVINGS
            - DAILY_EXPENSES
            - TRAVELLING_AND_RELOCATING
            - FREELANCER_ACTIVITY
            - ONLINE_SHOPPING
            - SALARY_OR_PENSION_ACCREDITATION
            - TRADING
            - FINANCING
            - BUYING_AND_SELLING_GOODS
            - MANAGEMENT_OF_INVOICES_AND_RECEIPTS
            - TREASURY
            - SUPPLIERS_MANAGEMENT
            - SETTLEMENT_OF_TRANSACTIONS_TO_AND_FROM_ABROAD
            - INVESTMENT_ACTIVITY
            - EMPLOYEE_PAYROLL_MANAGEMENT
        source_of_funds:
          type: string
          description: The business' source of funds.
          enum:
            - REAL_ESTATE_INCOME
            - SALE_OF_GOODS_AND_SERVICES
            - TRANSFER_FROM_DIFFERENT_ACCOUNTS
            - INCOME_FROM_CUSTOMERS
            - CORPORATE_MERGERS_AND_ACQUISITIONS
            - FINANCING
            - SECURITIES_OR_OTHER_FINANCIAL_INSTRUMENTS
            - TREASURY
            - DONATIONS
        expected_annual_revenue:
          type: string
          description: The business' expected annual revenue.
          enum:
            - ENTITY_IN_CRISIS
            - ENTITY_IN_SETUP
            - UP_TO_ONE_MEUR
            - ONE_M_TO_FIVE_MEUR
            - FIVE_M_TO_TEN_MEUR
            - MORE_THAN_TEN_MEUR
        expected_annual_incoming_funds:
          type: string
          description: The business' expected annual incoming funds.
          enum:
            - UP_TO_TEN_KEUR
            - TEN_K_TO_FIFTY_KEUR
            - FIFTY_K_TO_TWO_HUNDRED_KEUR
            - TWO_HUNDRED_K_TO_ONE_MEUR
            - ONE_M_TO_FIVE_MEUR
            - MORE_THAN_FIVE_MEUR
        company_status:
          type: string
          description: The current legal status of the company.
          enum:
            - ACTIVE
            - INACTIVE
            - IN_LIQUIDATION
            - COLLECTIVE_PROCEEDINGS
            - IN_CONSTITUTION
    Error400:
      type: object
      properties:
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        status:
          type: string
          example: '400'
        code:
          type: string
          example: build_pagination_headers_failure
        title:
          type: string
          example: Failed to build pagination headers.
        detail:
          type: string
          example: Cannot connect to database.
    Error403:
      type: object
      properties:
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        status:
          type: string
          example: '403'
        code:
          type: string
          example: unauthorized_action
        title:
          type: string
          example: Unauthorized Action
        detail:
          type: string
          example: Unauthorized action is not allowed.
    Error404:
      type: object
      properties:
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        status:
          type: string
          example: '404'
        code:
          type: string
          example: model_not_found
        title:
          type: string
          example: Model Not Found
        detail:
          type: string
          example: >-
            Couldn't find 'Solaris::Identification' for id
            'bbbcccfff388923eb899a5852df6cidt'.
    Error500:
      type: object
      properties:
        id:
          type: string
          example: e8915041-9d8c-4d96-9dd1-04e8522ecdbf
        status:
          type: string
          example: '500'
        code:
          type: string
          example: generic_error
        title:
          type: string
          example: Generic Error
        detail:
          type: string
          example: There was an error.
    Solaris-Decorators-FreelancerNaceCodeEnum:
      type: string
      enum:
        - I 55.10
        - I 55.20
        - I 55.30
        - I 55.90
        - I 56.10
        - I 56.21
        - I 56.29
        - I 56.30
        - J 58.11
        - J 58.12
        - J 58.13
        - J 58.14
        - J 58.19
        - J 58.21
        - J 58.29
        - J 59.11
        - J 59.12
        - J 59.13
        - J 59.14
        - J 59.20
        - J 60.10
        - J 60.20
        - J 61.10
        - J 61.20
        - J 61.30
        - J 61.90
        - J 62.01
        - J 62.02
        - J 62.03
        - J 62.09
        - J 63.11
        - J 63.12
        - J 63.91
        - J 63.99
        - K 64.11
        - K 64.19
        - K 66.22
        - L 68.2
        - L 68.10
        - L 68.20
        - L 68.31
        - L 68.32
        - M 69.10
        - M 69.20
        - M 70.10
        - M 70.21
        - M 70.22
        - M 71.11
        - M 71.12
        - M 71.20
        - M 72.11
        - M 72.19
        - M 72.20
        - M 73.11
        - M 73.12
        - M 73.20
        - M 74.10
        - M 74.20
        - M 74.30
        - M 74.90
        - M 75.00
        - N 77.11
        - N 77.12
        - N 77.21
        - N 77.22
        - N 77.29
        - N 77.31
        - N 77.32
        - N 77.33
        - N 77.34
        - N 77.35
        - N 77.39
        - N 77.40
        - N 78.10
        - N 78.20
        - N 78.30
        - N 80.10
        - N 80.20
        - N 80.30
        - N 81.10
        - N 81.21
        - N 81.22
        - N 81.29
        - N 81.30
        - N 82.11
        - N 82.19
        - N 82.20
        - N 82.30
        - N 82.91
        - N 82.92
        - N 82.99
        - P 85.10
        - P 85.20
        - P 85.31
        - P 85.32
        - P 85.41
        - P 85.42
        - P 85.51
        - P 85.52
        - P 85.53
        - P 85.59
        - P 85.60
        - Q 86.10
        - Q 86.21
        - Q 86.22
        - Q 86.23
        - Q 86.90
        - Q 87.10
        - Q 87.20
        - Q 87.30
        - Q 87.90
        - Q 88.10
        - Q 88.91
        - Q 88.99
        - R 90.01
        - R 90.02
        - R 90.03
        - R 90.04
        - R 91.01
        - R 91.02
        - R 91.03
        - R 91.04
        - R 92.00
        - R 93.11
        - R 93.12
        - R 93.13
        - R 93.19
        - R 93.21
        - R 93.29
        - S 94.11
        - S 94.12
        - S 94.20
        - S 94.91
        - S 94.92
        - S 94.99
        - S 96.01
        - S 96.02
        - S 96.03
        - S 96.04
        - S 96.09
    Solaris-Decorators-ChangeRequest-Start:
      type: object
      properties:
        id:
          type: string
          description: ID of the change request.
          example: d6c778822b2d7bd3b778935bcfd0d1d3csc
        status:
          type: string
          description: The current status of the change request.
          example: CONFIRMATION_REQUIRED
          enum:
            - ACCEPTED
            - AUTHORIZATION_REQUIRED
            - CONFIRMATION_REQUIRED
            - COMPLETED
            - FAILED
        updated_at:
          type: string
          description: UTC timestamp from the last time the change request was updated.
          format: date-time
          example: '2022-04-21T13:59:52+00:00'
        url:
          type: string
          description: URL to use to authorize the change request.
          example: https://example.com/authorize
    GetSearchByNameResult:
      properties:
        name:
          type: string
          example: Used Luxury Cars GmbH
          description: The name of the business.
        registration_number:
          type: string
          example: HRB 198673
          description: The business's commercial registration number without spaces
        registration_issuer:
          type: string
          example: AMTSGERICHT München
          description: The business's registered name.
      required:
        - country
        - name
      title: GetSearchByNameResult
      type: object
    Error403-2:
      x-struct: Elixir.SolarisToolkit.Web.Schemas.HttpError.Error403
      type: object
      title: Error403
      properties:
        title:
          type: string
          example: Unauthorized Action
        status:
          type: string
          example: '403'
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        detail:
          type: string
          example: Unauthorized action is not allowed.
        code:
          type: string
          example: unauthorized_action
    Error404-2:
      x-struct: Elixir.SolarisToolkit.Web.Schemas.HttpError.Error404
      type: object
      title: Error404
      properties:
        title:
          type: string
          example: Model Not Found
        status:
          type: string
          example: '404'
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        detail:
          type: string
          example: Couldn't find 'Account' for id 'DE24112233445566'.
        code:
          type: string
          example: model_not_found
    GetRetrieveCommercialRegistryResponse:
      properties:
        name:
          type: string
          example: FLOOR 13 GmbH
          description: The business's registered name.
        address:
          type: object
          properties:
            line_1:
              type: string
              example: Seestraße 9
            line_2:
              type: string
            postal_code:
              type: string
              example: '86919'
            city:
              type: string
              example: Utting a.Ammersee
            country:
              type: string
              example: DE
            state:
              type: string
        legal_form:
          type: string
          example: GMBH
          description: The business's legal form.
        tax_country:
          type: string
          example: DE
          description: The country where the business is taxable.
        registration_number:
          type: string
          example: HRB198673
          description: The business's commercial registration number without spaces.
        registration_issuer:
          type: string
          example: AMTSGERICHT München
          description: The entity that issued the business commercial registration number.
        registration_date:
          type: string
          example: '2012-05-09'
          description: The date when the business was registered.
        registry_updated_at:
          type: string
          example: '2015-11-17'
          description: >-
            The date when the business's entry in the commercial registry was
            last amended.
        commercial_registry_industry_key:
          type: array
          description: A list of NACE codes or industry keys for the business
          items:
            type: string
            example: 55.10.1 Hotels
        legal_representatives:
          type: array
          description: A list of the names of the legal representatives of the business.
          items:
            type: object
            properties:
              first_name:
                type: string
                example: Stefan
                description: First name of the legal representative.
              last_name:
                type: string
                example: Schneider
                description: Last name of the legal representative.
      required:
        - country
        - name
      title: GetRetrieveCommercialRegistryResponse
      type: object
    BusinessError400:
      type: object
      properties:
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        status:
          type: string
          example: '400'
        code:
          type: string
          example: invalid_model
        title:
          type: string
          example: Invalid Model
        detail:
          type: string
          example: The request could not be processed due to invalid parameters.
    BusinessError404:
      type: object
      properties:
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        status:
          type: string
          example: '404'
        code:
          type: string
          example: model_not_found
        title:
          type: string
          example: Model Not Found
        details:
          type: string
          example: >-
            Couldn't find 'Solaris::Business' for id
            'bb267278f2be0eaf47ebde6cdb9b2726cbiz'.
    Solaris-Server-Decorators-TaxIdentification:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the tax identification resource created for a customer.
          example: cba4289c773b7450482ee88a6e5126e9ctin
        country:
          description: >-
            The country in which the customer is taxable. Uses [ISO 3661 alpha-2
            Codes].
          allOf:
            - $ref: '#/components/schemas/Solaris-Server-Decorators-CountryEnum'
        number:
          type: string
          description: The tax identification number (TIN).
          example: '12345678901'
        primary:
          type: boolean
          description: >-
            Indicates whether this is the primary tax residency. In case of
            multiple tax residencies, the customer must have only one primary
            TIN.
          example: true
        reason_no_tin:
          type: string
          description: Provides a reason why the tax identification does not contain a TIN.
          enum:
            - NOT_ASSIGNED_YET
            - NOT_ASSIGNED_BY_COUNTRY
            - OTHER
        reason_description:
          type: string
          description: >-
            Additional context around why there is no TIN. Only required if
            `OTHER` was the value for the `reason_no_tin` field.
        valid_until:
          type: string
          description: Date when the tax identification becomes invalid.
          format: date
        tax_id_type:
          type: string
          description: The type of tax ID document. Only required for Spain.
          enum:
            - NIE
            - NIF
    Solaris-Enums-DocumentType:
      type: string
      description: The type of document.
      enum:
        - ACCOUNT_SNAPSHOT.FINTECSYSTEMS
        - ACCOUNT_STATEMENT
        - AML_POLICY
        - ANNUAL_FINANCIAL_STATEMENT
        - B2B_MANDATE
        - BALANCE_REPORT
        - BANK_REFERENCE
        - BUSINESS_ASSESSMENT
        - BUSINESS_FINANCIALS_XBRL
        - CREDIT_AGENCY_REPORT
        - CREDIT_RECORD.SCHUFA
        - CUSTOMER_COMMUNICATION
        - FATCA_SELF_DECLARATION
        - FOUNDATION_DOCUMENT
        - ID_DOCUMENT
        - INVOICE
        - KYC_BENEFICIAL_OWNER
        - KYC_CORPORATE_DOCUMENT
        - KYC_FORM
        - KYC_LEGAL_REPRESENTATIVE
        - KYC_RELIABILITY_CHECK
        - KYC_REPORT
        - LOAN_MANDATE_CONTRACT
        - OTHER
        - PAYMENT_CONFIRMATION
        - PICTURE
        - POWER_OF_ATTORNEY
        - PROOF_OF_ADDRESS
        - PROOF_OF_PHONE_CHANGE
        - PROOF_OF_PROFESSION
        - PROOF_OF_SALARY
        - PROOF_OF_TAX_ID
        - REFERENCE_LETTER
        - REGISTER_APPLICATION
        - REGISTER_EXTRACT
        - SALARY_INFORMATION
        - SCHUFA_COMPACT_REPORT
        - SCHUFA_FULL_REPORT
        - SCHUFA_GWG_REPORT
        - SCHUFA_SHORT_REPORT
        - SCORE_CARD.SOLARIS
        - SCREENING_REPORT
        - SHAREHOLDERS_LIST
        - SHARE_HOLDERS_AGREEMENT
        - SIGNATURE
        - SIGNED_CONTRACT
        - SIGNED_LOAN_MANDATE_CONTRACT
        - TRADING_LICENSE
        - TRANSACTIONAL_DOCUMENT
        - TRANSFER_CANCELLATION
        - VAT_CERTIFICATE
        - VIDEO
    Solaris-Resources-Document:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the document.
          example: 69ec2a9d8dbaf5ea1b13124098a34ea3cdoc
        name:
          type: string
          description: The name of the file associated with the document.
          example: Operation_authorization.png
        content_type:
          type: string
          description: The content type of the file associated with the document.
          example: image/png
        document_type:
          allOf:
            - $ref: '#/components/schemas/Solaris-Enums-DocumentType'
          example: PICTURE
        size:
          type: integer
          description: The file size, in bytes.
          example: 10187
        customer_accessible:
          type: boolean
          description: Indicates whether the customer has access to the document.
          example: false
        created_at:
          type: string
          description: UTC timestamp from when the document was created in Solaris' system.
          example: '2022-05-20T12:46:09Z'
        deleted_at:
          type: string
          description: UTC timestamp from when the document was deleted (if applicable).
          example: 'null'
    Error400-2:
      x-struct: Elixir.SolarisToolkit.Web.Schemas.HttpError.Error400
      type: object
      title: Error400
      properties:
        title:
          type: string
          example: Failed to build pagination headers.
        status:
          type: string
          example: '400'
        id:
          type: string
          example: a95f2aaf-4e0c-4d49-8021-8a16a884ed86
        detail:
          type: string
          example: Cannot connect to database.
        code:
          type: string
          example: build_pagination_headers_failure
    Solaris-Server-Decorators-LegalRepresentative:
      type: object
      properties:
        id:
          type: string
          description: ID of the legal representative relationship.
          example: a46578f4049f42aba9fe88a2a80fed53
        legal_representative_id:
          type: string
          description: >-
            ID of the person or business with the legal authority to represent
            the business.
          example: 33fbdd2c0bb94db1af5b5d2a4426cper
        legal_representative_type:
          type: string
          description: The type of legal representative that this record represents.
          enum:
            - Person
            - Business
          example: Person
        valid_until:
          type: string
          description: Date when the legal representative relationship expires.
          example: '2022-12-31'
        power_of_attorney_confirmed_at:
          type: string
          description: >-
            UTC timestamp from when the legal representative's power of attorney
            was confirmed.
          example: '2022-04-22T16:02:54Z'
          format: date-time
        type_of_representation:
          type: string
          description: The type of legal representation.
          example: ALONE
          enum:
            - ALONE
            - JOINT
            - OTHER
            - AUTHORIZED_PERSON
        business_id:
          type: string
          description: >-
            ID of the business for which the person or business is a legal
            representative.
          example: 095cc43012a04ccca02f0f93c145cbiz
    Solaris-Server-Decorators-BeneficialOwner:
      type: object
      properties:
        id:
          type: string
          description: ID of the beneficial owner relationship.
          example: a5f454e3f96447d6b3f7ecda46328040
        beneficial_owner_id:
          type: string
          description: Person or business ID of the beneficial owner.
          example: b9c5661fc7d240b8b51b9059b580cper
        person_id:
          type: string
          description: Person ID of the beneficial owner.
          example: b9c5661fc7d240b8b51b9059b580cper
        valid_until:
          type: string
          description: The date when the beneficial owner relationship expires.
          example: '2022-12-31'
        voting_share:
          type: integer
          description: >-
            The beneficial owner's voting share. Expressed as a double-digit
            percentile (e.g., 75% would be expressed as `75`).
          example: 75
        business_id:
          type: string
          description: ID of the relevant business.
          example: e0277fae750a4c849660da873f94cbiz
        fictitious:
          type: boolean
          description: Indicates whether the beneficial owner is fictitious.
          example: false
        relationship_to_business:
          type: string
          description: >-
            The type of relationship that the beneficial owner has to the
            business.
          example: DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL
          enum:
            - DIRECTLY_HOLDING_25_PERCENT_OR_MORE
            - DOMINANT_INFLUENCE_OVER_SHARE_CAPITAL
            - INDIRECTLY_HOLDING_25_PERCENT_OR_MORE
    Solaris-Server-Decorators-AuthorizedPerson:
      type: object
      properties:
        id:
          type: string
          description: ID of the authorized person relationship.
          example: c25ac6d8a4774e0dacb61a70427e0782
        authorized_person_id:
          type: string
          description: Person ID of the authorized person.
          example: 0ba2211cab11af6094d60ead81f2bd9dcper
        valid_from:
          type: string
          description: >-
            The date from which the authorized person has been authorized on the
            account.
          example: '2021-04-01'
        valid_until:
          type: string
          description: >-
            The date until which the authorized person is authorized on the
            account.
          example: '2031-04-01'
    Solaris-Server-Decorators-Signee:
      title: Solaris-Server-Decorators-Signee
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the signee role assigned to a person.
          example: 43f732deceba4e908835b62815bae4a6
        person_id:
          type: string
          description: Unique ID of the person resource created for a business's signee.
          example: dc1a6812a14f6cc338cd084208535bcdcper
        business_id:
          type: string
          description: Unique ID of the business resource.
          example: 880bbac68a34add190786b9c74f4c82fcbiz
      description: Business Signee
