hanzoai 8.5.156

data/lib/hanzoai/api/company_api.rb

@@ -0,0 +1,1544 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class CompanyApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get returns the caller org's formation and the stages reachable from it, or 404 when the org has not begun one.
+    # Get returns the caller org's formation and the stages reachable from it, or 404 when the org has not begun one.
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def get_company(opts = {})
+      data, _status_code, _headers = get_company_with_http_info(opts)
+      data
+    end
+
+    # Get returns the caller org's formation and the stages reachable from it, or 404 when the org has not begun one.
+    # Get returns the caller org's formation and the stages reachable from it, or 404 when the org has not begun one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def get_company_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.get_company ...'
+      end
+      # resource path
+      local_var_path = '/v1/company'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.get_company",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#get_company\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the platform's whole formation register, newest activity first — every org's formation, not the caller's.
+    # Returns the platform's whole formation register, newest activity first — every org's formation, not the caller's. It is a Hanzo platform operation: a caller who is not a platform reviewer gets 403.  Filter by stage and structure, page with limit and offset. An unknown stage is refused with 400 rather than returning a silently empty page.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :stage Stage keeps only formations at that stage. Empty means any.
+    # @option opts [String] :structure Structure keeps only formations of that entity kind. Empty means any.
+    # @option opts [Integer] :limit Limit bounds the page; 0 or less means the default of 200.
+    # @option opts [Integer] :offset Offset skips that many rows.
+    # @return [RegisterPage]
+    def get_company_register(opts = {})
+      data, _status_code, _headers = get_company_register_with_http_info(opts)
+      data
+    end
+
+    # Returns the platform&#39;s whole formation register, newest activity first — every org&#39;s formation, not the caller&#39;s.
+    # Returns the platform&#39;s whole formation register, newest activity first — every org&#39;s formation, not the caller&#39;s. It is a Hanzo platform operation: a caller who is not a platform reviewer gets 403.  Filter by stage and structure, page with limit and offset. An unknown stage is refused with 400 rather than returning a silently empty page.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :stage Stage keeps only formations at that stage. Empty means any.
+    # @option opts [String] :structure Structure keeps only formations of that entity kind. Empty means any.
+    # @option opts [Integer] :limit Limit bounds the page; 0 or less means the default of 200.
+    # @option opts [Integer] :offset Offset skips that many rows.
+    # @return [Array<(RegisterPage, Integer, Hash)>] RegisterPage data, response status code and response headers
+    def get_company_register_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.get_company_register ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/register'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'stage'] = opts[:'stage'] if !opts[:'stage'].nil?
+      query_params[:'structure'] = opts[:'structure'] if !opts[:'structure'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RegisterPage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.get_company_register",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#get_company_register\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Counts the platform's formations by stage — the register's shape in one read, so a queue that is growing is visible as a number rather than inferred by paging the list.
+    # Counts the platform's formations by stage — the register's shape in one read, so a queue that is growing is visible as a number rather than inferred by paging the list. A Hanzo platform operation: a caller who is not a platform reviewer gets 403.
+    # @param [Hash] opts the optional parameters
+    # @return [RegisterCounts]
+    def get_company_register_summary(opts = {})
+      data, _status_code, _headers = get_company_register_summary_with_http_info(opts)
+      data
+    end
+
+    # Counts the platform&#39;s formations by stage — the register&#39;s shape in one read, so a queue that is growing is visible as a number rather than inferred by paging the list.
+    # Counts the platform&#39;s formations by stage — the register&#39;s shape in one read, so a queue that is growing is visible as a number rather than inferred by paging the list. A Hanzo platform operation: a caller who is not a platform reviewer gets 403.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RegisterCounts, Integer, Hash)>] RegisterCounts data, response status code and response headers
+    def get_company_register_summary_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.get_company_register_summary ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/register/summary'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RegisterCounts'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.get_company_register_summary",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#get_company_register_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting.
+    # Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting. A Hanzo platform operation: a caller who is not a platform reviewer gets 403.  It only says who is waiting; the decision itself is POST /v1/company/kyc/decision.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds how many formations are scanned; 0 or less means the default of 200.
+    # @return [ReviewQueue]
+    def get_company_review(opts = {})
+      data, _status_code, _headers = get_company_review_with_http_info(opts)
+      data
+    end
+
+    # Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting.
+    # Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting. A Hanzo platform operation: a caller who is not a platform reviewer gets 403.  It only says who is waiting; the decision itself is POST /v1/company/kyc/decision.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds how many formations are scanned; 0 or less means the default of 200.
+    # @return [Array<(ReviewQueue, Integer, Hash)>] ReviewQueue data, response status code and response headers
+    def get_company_review_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.get_company_review ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/review'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ReviewQueue'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.get_company_review",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#get_company_review\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Begin starts the org's one formation and returns it with the stages reachable from it.
+    # Begin starts the org's one formation and returns it with the stages reachable from it. It is idempotent: an org that already has a formation gets that one back with 200, while a first call creates it and answers 201.
+    # @param begin_in [BeginIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company(begin_in, opts = {})
+      data, _status_code, _headers = post_company_with_http_info(begin_in, opts)
+      data
+    end
+
+    # Begin starts the org&#39;s one formation and returns it with the stages reachable from it.
+    # Begin starts the org&#39;s one formation and returns it with the stages reachable from it. It is idempotent: an org that already has a formation gets that one back with 200, while a first call creates it and answers 201.
+    # @param begin_in [BeginIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_with_http_info(begin_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company ...'
+      end
+      # verify the required parameter 'begin_in' is set
+      if @api_client.config.client_side_validation && begin_in.nil?
+        fail ArgumentError, "Missing the required parameter 'begin_in' when calling CompanyApi.post_company"
+      end
+      # resource path
+      local_var_path = '/v1/company'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(begin_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Advance runs the ONE guarded transition of the formation machine.
+    # Advance runs the ONE guarded transition of the formation machine. It is the only endpoint between stages: the actions populate data, this decides ordering.  An edge the machine does not define answers 409; an edge whose guard is not yet satisfied answers 422 naming what is missing. Reaching the terminal `company` stage also records the incorporation on the canonical cap table, and that must succeed before the transition is persisted.
+    # @param advance_in [AdvanceIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_advance(advance_in, opts = {})
+      data, _status_code, _headers = post_company_advance_with_http_info(advance_in, opts)
+      data
+    end
+
+    # Advance runs the ONE guarded transition of the formation machine.
+    # Advance runs the ONE guarded transition of the formation machine. It is the only endpoint between stages: the actions populate data, this decides ordering.  An edge the machine does not define answers 409; an edge whose guard is not yet satisfied answers 422 naming what is missing. Reaching the terminal &#x60;company&#x60; stage also records the incorporation on the canonical cap table, and that must succeed before the transition is persisted.
+    # @param advance_in [AdvanceIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_advance_with_http_info(advance_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_advance ...'
+      end
+      # verify the required parameter 'advance_in' is set
+      if @api_client.config.client_side_validation && advance_in.nil?
+        fail ArgumentError, "Missing the required parameter 'advance_in' when calling CompanyApi.post_company_advance"
+      end
+      # resource path
+      local_var_path = '/v1/company/advance'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(advance_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_advance",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_advance\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Renders the formation documents for the chosen structure and jurisdiction, ingests each into the org's data room, and submits the state filing through the filing client.
+    # Renders the formation documents for the chosen structure and jurisdiction, ingests each into the org's data room, and submits the state filing through the filing client.  With no filing partner wired the filing is recorded honestly as \"manual\" — no filing id is fabricated. Available only at the documents stage.
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_documents(opts = {})
+      data, _status_code, _headers = post_company_documents_with_http_info(opts)
+      data
+    end
+
+    # Renders the formation documents for the chosen structure and jurisdiction, ingests each into the org&#39;s data room, and submits the state filing through the filing client.
+    # Renders the formation documents for the chosen structure and jurisdiction, ingests each into the org&#39;s data room, and submits the state filing through the filing client.  With no filing partner wired the filing is recorded honestly as \&quot;manual\&quot; — no filing id is fabricated. Available only at the documents stage.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_documents_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_documents ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/documents'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_documents",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_documents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Opens the EIN application and answers what it owes.
+    # Opens the EIN application and answers what it owes.  The answer states whether it can be filed ONLINE, because that is the fact deciding whether the customer waits a sitting or several weeks — and it names each form with what that form is for, so nobody has to already know what an SS-4 is to understand why they are signing one.
+    # @param ein_in [EinIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [EIN]
+    def post_company_ein(ein_in, opts = {})
+      data, _status_code, _headers = post_company_ein_with_http_info(ein_in, opts)
+      data
+    end
+
+    # Opens the EIN application and answers what it owes.
+    # Opens the EIN application and answers what it owes.  The answer states whether it can be filed ONLINE, because that is the fact deciding whether the customer waits a sitting or several weeks — and it names each form with what that form is for, so nobody has to already know what an SS-4 is to understand why they are signing one.
+    # @param ein_in [EinIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EIN, Integer, Hash)>] EIN data, response status code and response headers
+    def post_company_ein_with_http_info(ein_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_ein ...'
+      end
+      # verify the required parameter 'ein_in' is set
+      if @api_client.config.client_side_validation && ein_in.nil?
+        fail ArgumentError, "Missing the required parameter 'ein_in' when calling CompanyApi.post_company_ein"
+      end
+      # resource path
+      local_var_path = '/v1/company/ein'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ein_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EIN'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_ein",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_ein\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Sends the generated formation documents for signature by every founder and records the provider's reference on the formation.
+    # Sends the generated formation documents for signature by every founder and records the provider's reference on the formation. Available only at the esign stage.
+    # @param [Hash] opts the optional parameters
+    # @return [EsignOut]
+    def post_company_esign(opts = {})
+      data, _status_code, _headers = post_company_esign_with_http_info(opts)
+      data
+    end
+
+    # Sends the generated formation documents for signature by every founder and records the provider&#39;s reference on the formation.
+    # Sends the generated formation documents for signature by every founder and records the provider&#39;s reference on the formation. Available only at the esign stage.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EsignOut, Integer, Hash)>] EsignOut data, response status code and response headers
+    def post_company_esign_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_esign ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/esign'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EsignOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_esign",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_esign\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records whether the formation documents have been signed.
+    # Records whether the formation documents have been signed. It consults the e-signature provider, which a real provider's webhook drives; the signal is idempotent.  An explicit `signed` in the request overrides the provider's answer, which is the manual path for the stub provider that never self-completes.
+    # @param esign_complete_in [EsignCompleteIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_esign_complete(esign_complete_in, opts = {})
+      data, _status_code, _headers = post_company_esign_complete_with_http_info(esign_complete_in, opts)
+      data
+    end
+
+    # Records whether the formation documents have been signed.
+    # Records whether the formation documents have been signed. It consults the e-signature provider, which a real provider&#39;s webhook drives; the signal is idempotent.  An explicit &#x60;signed&#x60; in the request overrides the provider&#39;s answer, which is the manual path for the stub provider that never self-completes.
+    # @param esign_complete_in [EsignCompleteIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_esign_complete_with_http_info(esign_complete_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_esign_complete ...'
+      end
+      # verify the required parameter 'esign_complete_in' is set
+      if @api_client.config.client_side_validation && esign_complete_in.nil?
+        fail ArgumentError, "Missing the required parameter 'esign_complete_in' when calling CompanyApi.post_company_esign_complete"
+      end
+      # resource path
+      local_var_path = '/v1/company/esign/complete'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(esign_complete_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_esign_complete",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_esign_complete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replaces the formation's founders.
+    # Replaces the formation's founders. Each founder needs a name, an email and an equity share in basis points; every founder is (re)set to pending KYC, so a previously settled decision does not survive a change of the list.
+    # @param founders_in [FoundersIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_founders(founders_in, opts = {})
+      data, _status_code, _headers = post_company_founders_with_http_info(founders_in, opts)
+      data
+    end
+
+    # Replaces the formation&#39;s founders.
+    # Replaces the formation&#39;s founders. Each founder needs a name, an email and an equity share in basis points; every founder is (re)set to pending KYC, so a previously settled decision does not survive a change of the list.
+    # @param founders_in [FoundersIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_founders_with_http_info(founders_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_founders ...'
+      end
+      # verify the required parameter 'founders_in' is set
+      if @api_client.config.client_side_validation && founders_in.nil?
+        fail ArgumentError, "Missing the required parameter 'founders_in' when calling CompanyApi.post_company_founders"
+      end
+      # resource path
+      local_var_path = '/v1/company/founders'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(founders_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_founders",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_founders\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Share a pitch deck in the org's data room
+    # Stores the request body as a document in the caller org's data room and answers with the data room id to reference it by. The deck is RAW BYTES of whatever content type is sent — a PDF, a slide export — not a JSON document: the Content-Type header is carried through to the data room as given, and `?name=` names the document, defaulting to `pitch-deck`.  Scoped to the caller's validated org, and only after incorporation: a formation still short of stage `company` is refused 409 and an org that never began one is 404. The route is registered AHEAD of the surface's JSON body cap deliberately, so a deck's size ceiling is the edge's rather than the cap meant for small structured records. An empty body is 400; a data room that will not take the bytes is 502.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [DeckOut]
+    def post_company_fundraise_deck(opts = {})
+      data, _status_code, _headers = post_company_fundraise_deck_with_http_info(opts)
+      data
+    end
+
+    # Share a pitch deck in the org&#39;s data room
+    # Stores the request body as a document in the caller org&#39;s data room and answers with the data room id to reference it by. The deck is RAW BYTES of whatever content type is sent — a PDF, a slide export — not a JSON document: the Content-Type header is carried through to the data room as given, and &#x60;?name&#x3D;&#x60; names the document, defaulting to &#x60;pitch-deck&#x60;.  Scoped to the caller&#39;s validated org, and only after incorporation: a formation still short of stage &#x60;company&#x60; is refused 409 and an org that never began one is 404. The route is registered AHEAD of the surface&#39;s JSON body cap deliberately, so a deck&#39;s size ceiling is the edge&#39;s rather than the cap meant for small structured records. An empty body is 400; a data room that will not take the bytes is 502.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [Array<(DeckOut, Integer, Hash)>] DeckOut data, response status code and response headers
+    def post_company_fundraise_deck_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_fundraise_deck ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/fundraise/deck'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/octet-stream'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeckOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_fundraise_deck",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_fundraise_deck\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records a fundraising round on the org's canonical cap table.
+    # Records a fundraising round on the org's canonical cap table. Available only after incorporation (stage company); roundType defaults to PRICED.
+    # @param round_input [RoundInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [RoundOut]
+    def post_company_fundraise_round(round_input, opts = {})
+      data, _status_code, _headers = post_company_fundraise_round_with_http_info(round_input, opts)
+      data
+    end
+
+    # Records a fundraising round on the org&#39;s canonical cap table.
+    # Records a fundraising round on the org&#39;s canonical cap table. Available only after incorporation (stage company); roundType defaults to PRICED.
+    # @param round_input [RoundInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RoundOut, Integer, Hash)>] RoundOut data, response status code and response headers
+    def post_company_fundraise_round_with_http_info(round_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_fundraise_round ...'
+      end
+      # verify the required parameter 'round_input' is set
+      if @api_client.config.client_side_validation && round_input.nil?
+        fail ArgumentError, "Missing the required parameter 'round_input' when calling CompanyApi.post_company_fundraise_round"
+      end
+      # resource path
+      local_var_path = '/v1/company/fundraise/round'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(round_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RoundOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_fundraise_round",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_fundraise_round\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Raises an e-signature request over documents already in the org's data room — a SAFE, a convertible note, or any other fundraising paper.
+    # Raises an e-signature request over documents already in the org's data room — a SAFE, a convertible note, or any other fundraising paper. Available only after incorporation (stage company).
+    # @param safe_in [SafeIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SafeOut]
+    def post_company_fundraise_safe(safe_in, opts = {})
+      data, _status_code, _headers = post_company_fundraise_safe_with_http_info(safe_in, opts)
+      data
+    end
+
+    # Raises an e-signature request over documents already in the org&#39;s data room — a SAFE, a convertible note, or any other fundraising paper.
+    # Raises an e-signature request over documents already in the org&#39;s data room — a SAFE, a convertible note, or any other fundraising paper. Available only after incorporation (stage company).
+    # @param safe_in [SafeIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SafeOut, Integer, Hash)>] SafeOut data, response status code and response headers
+    def post_company_fundraise_safe_with_http_info(safe_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_fundraise_safe ...'
+      end
+      # verify the required parameter 'safe_in' is set
+      if @api_client.config.client_side_validation && safe_in.nil?
+        fail ArgumentError, "Missing the required parameter 'safe_in' when calling CompanyApi.post_company_fundraise_safe"
+      end
+      # resource path
+      local_var_path = '/v1/company/fundraise/safe'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(safe_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SafeOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_fundraise_safe",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_fundraise_safe\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Seeds the canonical cap table with the founding allocation (stakeholders, a common share class, issued shares) and anchors the deterministic equity-genesis root on-chain.
+    # Seeds the canonical cap table with the founding allocation (stakeholders, a common share class, issued shares) and anchors the deterministic equity-genesis root on-chain.  It is idempotent: once a root is recorded the cap table is NOT re-seeded, which would double-issue founder share certificates. The root is persisted even when the on-chain submit fails, because the root is the tamper-evident witness and must not be recomputed on retry. Available only at the genesis stage.
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_genesis(opts = {})
+      data, _status_code, _headers = post_company_genesis_with_http_info(opts)
+      data
+    end
+
+    # Seeds the canonical cap table with the founding allocation (stakeholders, a common share class, issued shares) and anchors the deterministic equity-genesis root on-chain.
+    # Seeds the canonical cap table with the founding allocation (stakeholders, a common share class, issued shares) and anchors the deterministic equity-genesis root on-chain.  It is idempotent: once a root is recorded the cap table is NOT re-seeded, which would double-issue founder share certificates. The root is persisted even when the on-chain submit fails, because the root is the tamper-evident witness and must not be recomputed on retry. Available only at the genesis stage.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_genesis_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_genesis ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/genesis'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_genesis",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_genesis\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reads an existing company's cap table from a Google Sheet and adds its stakeholders to the canonical cap table.
+    # Reads an existing company's cap table from a Google Sheet and adds its stakeholders to the canonical cap table.  The first row is a header and columns are matched by name (case-insensitive): name and email are required, type/relationship/institution optional. A sheet without name and email columns, or with no usable data rows, is refused with 400. Available only at the import stage.
+    # @param import_cap_table_in [ImportCapTableIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ImportCapTableOut]
+    def post_company_import_captable(import_cap_table_in, opts = {})
+      data, _status_code, _headers = post_company_import_captable_with_http_info(import_cap_table_in, opts)
+      data
+    end
+
+    # Reads an existing company&#39;s cap table from a Google Sheet and adds its stakeholders to the canonical cap table.
+    # Reads an existing company&#39;s cap table from a Google Sheet and adds its stakeholders to the canonical cap table.  The first row is a header and columns are matched by name (case-insensitive): name and email are required, type/relationship/institution optional. A sheet without name and email columns, or with no usable data rows, is refused with 400. Available only at the import stage.
+    # @param import_cap_table_in [ImportCapTableIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ImportCapTableOut, Integer, Hash)>] ImportCapTableOut data, response status code and response headers
+    def post_company_import_captable_with_http_info(import_cap_table_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_import_captable ...'
+      end
+      # verify the required parameter 'import_cap_table_in' is set
+      if @api_client.config.client_side_validation && import_cap_table_in.nil?
+        fail ArgumentError, "Missing the required parameter 'import_cap_table_in' when calling CompanyApi.post_company_import_captable"
+      end
+      # resource path
+      local_var_path = '/v1/company/import/captable'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(import_cap_table_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ImportCapTableOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_import_captable",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_import_captable\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Ingests an existing company's corporate documents from a Google Drive folder into the org's data room.
+    # Ingests an existing company's corporate documents from a Google Drive folder into the org's data room. The import is shallow — sub-folders are skipped, not walked — and available only at the import stage.
+    # @param import_documents_in [ImportDocumentsIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ImportDocumentsOut]
+    def post_company_import_documents(import_documents_in, opts = {})
+      data, _status_code, _headers = post_company_import_documents_with_http_info(import_documents_in, opts)
+      data
+    end
+
+    # Ingests an existing company&#39;s corporate documents from a Google Drive folder into the org&#39;s data room.
+    # Ingests an existing company&#39;s corporate documents from a Google Drive folder into the org&#39;s data room. The import is shallow — sub-folders are skipped, not walked — and available only at the import stage.
+    # @param import_documents_in [ImportDocumentsIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ImportDocumentsOut, Integer, Hash)>] ImportDocumentsOut data, response status code and response headers
+    def post_company_import_documents_with_http_info(import_documents_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_import_documents ...'
+      end
+      # verify the required parameter 'import_documents_in' is set
+      if @api_client.config.client_side_validation && import_documents_in.nil?
+        fail ArgumentError, "Missing the required parameter 'import_documents_in' when calling CompanyApi.post_company_import_documents"
+      end
+      # resource path
+      local_var_path = '/v1/company/import/documents'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(import_documents_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ImportDocumentsOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_import_documents",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_import_documents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # StartKYC opens an identity-verification session for every founder with the wired provider and records each session's reference on the formation.
+    # StartKYC opens an identity-verification session for every founder with the wired provider and records each session's reference on the formation.  A start is never a decision: any terminal status the provider reports at inquiry time is clamped back to pending, so the payment gate can never open here. A terminal status arrives only from POST /v1/company/kyc/refresh (the provider) or POST /v1/company/kyc/decision (a Hanzo platform reviewer).
+    # @param [Hash] opts the optional parameters
+    # @return [KycStartOut]
+    def post_company_kyc(opts = {})
+      data, _status_code, _headers = post_company_kyc_with_http_info(opts)
+      data
+    end
+
+    # StartKYC opens an identity-verification session for every founder with the wired provider and records each session&#39;s reference on the formation.
+    # StartKYC opens an identity-verification session for every founder with the wired provider and records each session&#39;s reference on the formation.  A start is never a decision: any terminal status the provider reports at inquiry time is clamped back to pending, so the payment gate can never open here. A terminal status arrives only from POST /v1/company/kyc/refresh (the provider) or POST /v1/company/kyc/decision (a Hanzo platform reviewer).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(KycStartOut, Integer, Hash)>] KycStartOut data, response status code and response headers
+    def post_company_kyc_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_kyc ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/kyc'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'KycStartOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_kyc",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_kyc\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # DecideKYC records a privileged reviewer's MANUAL decision on a founder's KYC — the human-in-the-loop path, and the ONLY route to a pass when no real provider is wired.
+    # DecideKYC records a privileged reviewer's MANUAL decision on a founder's KYC — the human-in-the-loop path, and the ONLY route to a pass when no real provider is wired. It produces a DISTINCT reviewer_confirmed, never a provider \"verified\".  Because Hanzo forms the entity and carries the formation KYC/AML obligation, the reviewer is a HANZO platform reviewer (SuperAdmin), and the decision is ATTRIBUTED to them.
+    # @param decision_in [DecisionIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_kyc_decision(decision_in, opts = {})
+      data, _status_code, _headers = post_company_kyc_decision_with_http_info(decision_in, opts)
+      data
+    end
+
+    # DecideKYC records a privileged reviewer&#39;s MANUAL decision on a founder&#39;s KYC — the human-in-the-loop path, and the ONLY route to a pass when no real provider is wired.
+    # DecideKYC records a privileged reviewer&#39;s MANUAL decision on a founder&#39;s KYC — the human-in-the-loop path, and the ONLY route to a pass when no real provider is wired. It produces a DISTINCT reviewer_confirmed, never a provider \&quot;verified\&quot;.  Because Hanzo forms the entity and carries the formation KYC/AML obligation, the reviewer is a HANZO platform reviewer (SuperAdmin), and the decision is ATTRIBUTED to them.
+    # @param decision_in [DecisionIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_kyc_decision_with_http_info(decision_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_kyc_decision ...'
+      end
+      # verify the required parameter 'decision_in' is set
+      if @api_client.config.client_side_validation && decision_in.nil?
+        fail ArgumentError, "Missing the required parameter 'decision_in' when calling CompanyApi.post_company_kyc_decision"
+      end
+      # resource path
+      local_var_path = '/v1/company/kyc/decision'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(decision_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_kyc_decision",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_kyc_decision\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # RefreshKYC reconciles each pending founder's KYC with the WIRED provider — the PULL path to a provider-reported terminal status.
+    # RefreshKYC reconciles each pending founder's KYC with the WIRED provider — the PULL path to a provider-reported terminal status. For the manual provider the check stays pending; for a real provider it reflects the settled decision, ATTRIBUTED to the provider.  It NEVER trusts a client-asserted status — the status comes from the PROVIDER — so a client cannot force a pass here, and an already-passing founder (e.g. a reviewer confirmation) is left untouched.
+    # @param [Hash] opts the optional parameters
+    # @return [KycRefreshOut]
+    def post_company_kyc_refresh(opts = {})
+      data, _status_code, _headers = post_company_kyc_refresh_with_http_info(opts)
+      data
+    end
+
+    # RefreshKYC reconciles each pending founder&#39;s KYC with the WIRED provider — the PULL path to a provider-reported terminal status.
+    # RefreshKYC reconciles each pending founder&#39;s KYC with the WIRED provider — the PULL path to a provider-reported terminal status. For the manual provider the check stays pending; for a real provider it reflects the settled decision, ATTRIBUTED to the provider.  It NEVER trusts a client-asserted status — the status comes from the PROVIDER — so a client cannot force a pass here, and an already-passing founder (e.g. a reviewer confirmation) is left untouched.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(KycRefreshOut, Integer, Hash)>] KycRefreshOut data, response status code and response headers
+    def post_company_kyc_refresh_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_kyc_refresh ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/kyc/refresh'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'KycRefreshOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_kyc_refresh",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_kyc_refresh\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Charges the caller's own org the one-time Hanzo Company formation fee.
+    # Charges the caller's own org the one-time Hanzo Company formation fee.  It is $999 unless the deployment sets another, and the answer is the formation record carrying its paid flag and the charge reference. It takes no body: the org is the validated tenant and the amount is the platform's, never the caller's to assert.  IDEMPOTENT on the formation rather than on the request: an already-paid formation answers 200 with the same record and is not charged again, so a retry or a double-clicked button costs nothing. Available only at the `payment` stage (409 anywhere else) and only for an org that has begun a formation (404 otherwise).  A denial answers the fleet-wide billing contract — 402 insufficient_balance, 402 spend_cap_exceeded, 503 balance_unavailable — carried by cloud.Denied, which is the money wire's own {\"error\":{\"code\",\"message\"}} body rather than a second vocabulary invented for this surface.  The gate is the LAST thing it does, after the stage check and the paid short-circuit, so a caller the machine is about to refuse is never charged. That ordering is why the gate cannot lift into middleware, where it would run first. Both facts are pinned: TestPaymentDenialWire, TestPaymentChargesLast.
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_payment(opts = {})
+      data, _status_code, _headers = post_company_payment_with_http_info(opts)
+      data
+    end
+
+    # Charges the caller&#39;s own org the one-time Hanzo Company formation fee.
+    # Charges the caller&#39;s own org the one-time Hanzo Company formation fee.  It is $999 unless the deployment sets another, and the answer is the formation record carrying its paid flag and the charge reference. It takes no body: the org is the validated tenant and the amount is the platform&#39;s, never the caller&#39;s to assert.  IDEMPOTENT on the formation rather than on the request: an already-paid formation answers 200 with the same record and is not charged again, so a retry or a double-clicked button costs nothing. Available only at the &#x60;payment&#x60; stage (409 anywhere else) and only for an org that has begun a formation (404 otherwise).  A denial answers the fleet-wide billing contract — 402 insufficient_balance, 402 spend_cap_exceeded, 503 balance_unavailable — carried by cloud.Denied, which is the money wire&#39;s own {\&quot;error\&quot;:{\&quot;code\&quot;,\&quot;message\&quot;}} body rather than a second vocabulary invented for this surface.  The gate is the LAST thing it does, after the stage check and the paid short-circuit, so a caller the machine is about to refuse is never charged. That ordering is why the gate cannot lift into middleware, where it would run first. Both facts are pinned: TestPaymentDenialWire, TestPaymentChargesLast.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_payment_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_payment ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/payment'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_payment",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_payment\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Skip marks the org as already incorporated and moves it onto the import path, so an existing company brings its documents and cap table in instead of forming a new entity.
+    # Skip marks the org as already incorporated and moves it onto the import path, so an existing company brings its documents and cap table in instead of forming a new entity. Available only at the structure stage.
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def post_company_skip(opts = {})
+      data, _status_code, _headers = post_company_skip_with_http_info(opts)
+      data
+    end
+
+    # Skip marks the org as already incorporated and moves it onto the import path, so an existing company brings its documents and cap table in instead of forming a new entity.
+    # Skip marks the org as already incorporated and moves it onto the import path, so an existing company brings its documents and cap table in instead of forming a new entity. Available only at the structure stage.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def post_company_skip_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_skip ...'
+      end
+      # resource path
+      local_var_path = '/v1/company/skip'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_skip",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_skip\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Itemises what a formation costs before anyone commits to it.
+    # Itemises what a formation costs before anyone commits to it.  It answers what is due now and what recurs, as separate figures, and marks the state's filing fee as money we collect and remit rather than keep. A caller can therefore show a payer the whole bill — which is the point of quoting at all, and was impossible while the fee was one number in an error string.  A jurisdiction whose filing fee this deployment has not been told REFUSES, naming the setting that fixes it. Quoting our half as though it were the total is the one answer that would be worse than no answer.
+    # @param tariff_in [TariffIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Tariff]
+    def post_company_tariff(tariff_in, opts = {})
+      data, _status_code, _headers = post_company_tariff_with_http_info(tariff_in, opts)
+      data
+    end
+
+    # Itemises what a formation costs before anyone commits to it.
+    # Itemises what a formation costs before anyone commits to it.  It answers what is due now and what recurs, as separate figures, and marks the state&#39;s filing fee as money we collect and remit rather than keep. A caller can therefore show a payer the whole bill — which is the point of quoting at all, and was impossible while the fee was one number in an error string.  A jurisdiction whose filing fee this deployment has not been told REFUSES, naming the setting that fixes it. Quoting our half as though it were the total is the one answer that would be worse than no answer.
+    # @param tariff_in [TariffIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Tariff, Integer, Hash)>] Tariff data, response status code and response headers
+    def post_company_tariff_with_http_info(tariff_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.post_company_tariff ...'
+      end
+      # verify the required parameter 'tariff_in' is set
+      if @api_client.config.client_side_validation && tariff_in.nil?
+        fail ArgumentError, "Missing the required parameter 'tariff_in' when calling CompanyApi.post_company_tariff"
+      end
+      # resource path
+      local_var_path = '/v1/company/tariff'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(tariff_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Tariff'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.post_company_tariff",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#post_company_tariff\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records the entity kind, the state of formation and the proposed name.
+    # Records the entity kind, the state of formation and the proposed name. Available only at the structure stage; an unknown structure or jurisdiction, or an empty name, is refused with 400.
+    # @param structure_in [StructureIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [FormationView]
+    def put_company_structure(structure_in, opts = {})
+      data, _status_code, _headers = put_company_structure_with_http_info(structure_in, opts)
+      data
+    end
+
+    # Records the entity kind, the state of formation and the proposed name.
+    # Records the entity kind, the state of formation and the proposed name. Available only at the structure stage; an unknown structure or jurisdiction, or an empty name, is refused with 400.
+    # @param structure_in [StructureIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FormationView, Integer, Hash)>] FormationView data, response status code and response headers
+    def put_company_structure_with_http_info(structure_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.put_company_structure ...'
+      end
+      # verify the required parameter 'structure_in' is set
+      if @api_client.config.client_side_validation && structure_in.nil?
+        fail ArgumentError, "Missing the required parameter 'structure_in' when calling CompanyApi.put_company_structure"
+      end
+      # resource path
+      local_var_path = '/v1/company/structure'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(structure_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FormationView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.put_company_structure",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#put_company_structure\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end