factorial_api 3.0.1

data/lib/factorial_api/api/contracts_contract_template_api.rb

@@ -0,0 +1,151 @@
+=begin
+#Factorial API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 2026-10-01
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module F::Api
+  class ContractsContractTemplateApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Reads all Contract templates
+    # Read Contract Template
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids Filter by contract template IDs
+    # @option opts [String] :company_id Filter by company ID
+    # @option opts [String] :contract_version_type Filter by contract version type (e.g., es for Spain, fr for France)
+    # @return [ContractsContractTemplatesGet200Response]
+    def contracts_contract_templates_get(opts = {})
+      data, _status_code, _headers = contracts_contract_templates_get_with_http_info(opts)
+      data
+    end
+
+    # Reads all Contract templates
+    # Read Contract Template
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids Filter by contract template IDs
+    # @option opts [String] :company_id Filter by company ID
+    # @option opts [String] :contract_version_type Filter by contract version type (e.g., es for Spain, fr for France)
+    # @return [Array<(ContractsContractTemplatesGet200Response, Integer, Hash)>] ContractsContractTemplatesGet200Response data, response status code and response headers
+    def contracts_contract_templates_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractTemplateApi.contracts_contract_templates_get ...'
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_templates'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ids[]'] = @api_client.build_collection_param(opts[:'ids'], :multi) if !opts[:'ids'].nil?
+      query_params[:'company_id'] = opts[:'company_id'] if !opts[:'company_id'].nil?
+      query_params[:'contract_version_type'] = opts[:'contract_version_type'] if !opts[:'contract_version_type'].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] || 'ContractsContractTemplatesGet200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractTemplateApi.contracts_contract_templates_get",
+        :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: ContractsContractTemplateApi#contracts_contract_templates_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reads a single Contract template
+    # Read Contract Template
+    # @param id [String] Filter by contract template IDs
+    # @param [Hash] opts the optional parameters
+    # @return [ContractsContractTemplate]
+    def contracts_contract_templates_id_get(id, opts = {})
+      data, _status_code, _headers = contracts_contract_templates_id_get_with_http_info(id, opts)
+      data
+    end
+
+    # Reads a single Contract template
+    # Read Contract Template
+    # @param id [String] Filter by contract template IDs
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ContractsContractTemplate, Integer, Hash)>] ContractsContractTemplate data, response status code and response headers
+    def contracts_contract_templates_id_get_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractTemplateApi.contracts_contract_templates_id_get ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ContractsContractTemplateApi.contracts_contract_templates_id_get"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_templates/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # 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] || 'ContractsContractTemplate'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractTemplateApi.contracts_contract_templates_id_get",
+        :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: ContractsContractTemplateApi#contracts_contract_templates_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/factorial_api/api/contracts_contract_version_api.rb

@@ -0,0 +1,361 @@
+=begin
+#Factorial API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 2026-10-01
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module F::Api
+  class ContractsContractVersionApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Reads all Contract versions
+    # Reads all Contract versions
+    # @param job_catalog_tree_node_uuids [Array<String>] the uuid of nodes in the job catalog tree. As only level nodes are accepted and persisted, so filtering with other node types will return no results. Refer to job_catalog/tree_nodes endpoint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids Return only the contract versions with these ids.
+    # @option opts [Array<String>] :employee_ids Return only the contract versions of these employees.
+    # @option opts [String] :date filters contracts of employees with effective_on date less or equal than the given date.
+    # @option opts [String] :updated_at_gteq Filter contract versions updated on or after this timestamp (ISO 8601). 
+    # @option opts [String] :updated_at_lteq Filter contract versions updated on or before this timestamp (ISO 8601). 
+    # @return [ContractsContractVersionsGet200Response]
+    def contracts_contract_versions_get(job_catalog_tree_node_uuids, opts = {})
+      data, _status_code, _headers = contracts_contract_versions_get_with_http_info(job_catalog_tree_node_uuids, opts)
+      data
+    end
+
+    # Reads all Contract versions
+    # Reads all Contract versions
+    # @param job_catalog_tree_node_uuids [Array<String>] the uuid of nodes in the job catalog tree. As only level nodes are accepted and persisted, so filtering with other node types will return no results. Refer to job_catalog/tree_nodes endpoint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids Return only the contract versions with these ids.
+    # @option opts [Array<String>] :employee_ids Return only the contract versions of these employees.
+    # @option opts [String] :date filters contracts of employees with effective_on date less or equal than the given date.
+    # @option opts [String] :updated_at_gteq Filter contract versions updated on or after this timestamp (ISO 8601). 
+    # @option opts [String] :updated_at_lteq Filter contract versions updated on or before this timestamp (ISO 8601). 
+    # @return [Array<(ContractsContractVersionsGet200Response, Integer, Hash)>] ContractsContractVersionsGet200Response data, response status code and response headers
+    def contracts_contract_versions_get_with_http_info(job_catalog_tree_node_uuids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionApi.contracts_contract_versions_get ...'
+      end
+      # verify the required parameter 'job_catalog_tree_node_uuids' is set
+      if @api_client.config.client_side_validation && job_catalog_tree_node_uuids.nil?
+        fail ArgumentError, "Missing the required parameter 'job_catalog_tree_node_uuids' when calling ContractsContractVersionApi.contracts_contract_versions_get"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_versions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'job_catalog_tree_node_uuids[]'] = @api_client.build_collection_param(job_catalog_tree_node_uuids, :multi)
+      query_params[:'ids[]'] = @api_client.build_collection_param(opts[:'ids'], :multi) if !opts[:'ids'].nil?
+      query_params[:'employee_ids[]'] = @api_client.build_collection_param(opts[:'employee_ids'], :multi) if !opts[:'employee_ids'].nil?
+      query_params[:'date'] = opts[:'date'] if !opts[:'date'].nil?
+      query_params[:'updated_at_gteq'] = opts[:'updated_at_gteq'] if !opts[:'updated_at_gteq'].nil?
+      query_params[:'updated_at_lteq'] = opts[:'updated_at_lteq'] if !opts[:'updated_at_lteq'].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] || 'ContractsContractVersionsGet200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionApi.contracts_contract_versions_get",
+        :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: ContractsContractVersionApi#contracts_contract_versions_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deletes a Contract version
+    # Deletes a Contract version
+    # @param id [String] contract version identifier.
+    # @param [Hash] opts the optional parameters
+    # @return [ContractsContractVersion]
+    def contracts_contract_versions_id_delete(id, opts = {})
+      data, _status_code, _headers = contracts_contract_versions_id_delete_with_http_info(id, opts)
+      data
+    end
+
+    # Deletes a Contract version
+    # Deletes a Contract version
+    # @param id [String] contract version identifier.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ContractsContractVersion, Integer, Hash)>] ContractsContractVersion data, response status code and response headers
+    def contracts_contract_versions_id_delete_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionApi.contracts_contract_versions_id_delete ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ContractsContractVersionApi.contracts_contract_versions_id_delete"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_versions/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # 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] || 'ContractsContractVersion'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionApi.contracts_contract_versions_id_delete",
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContractsContractVersionApi#contracts_contract_versions_id_delete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reads a single Contract version
+    # Reads a single Contract version
+    # @param id [String] Return only the contract versions with these ids.
+    # @param [Hash] opts the optional parameters
+    # @return [ContractsContractVersion]
+    def contracts_contract_versions_id_get(id, opts = {})
+      data, _status_code, _headers = contracts_contract_versions_id_get_with_http_info(id, opts)
+      data
+    end
+
+    # Reads a single Contract version
+    # Reads a single Contract version
+    # @param id [String] Return only the contract versions with these ids.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ContractsContractVersion, Integer, Hash)>] ContractsContractVersion data, response status code and response headers
+    def contracts_contract_versions_id_get_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionApi.contracts_contract_versions_id_get ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ContractsContractVersionApi.contracts_contract_versions_id_get"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_versions/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # 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] || 'ContractsContractVersion'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionApi.contracts_contract_versions_id_get",
+        :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: ContractsContractVersionApi#contracts_contract_versions_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Updates a Contract version
+    # Updates a Contract version
+    # @param id [String] contract version identifier.
+    # @param [Hash] opts the optional parameters
+    # @option opts [ContractsContractVersionsIdPutRequest] :contracts_contract_versions_id_put_request 
+    # @return [ContractsContractVersion]
+    def contracts_contract_versions_id_put(id, opts = {})
+      data, _status_code, _headers = contracts_contract_versions_id_put_with_http_info(id, opts)
+      data
+    end
+
+    # Updates a Contract version
+    # Updates a Contract version
+    # @param id [String] contract version identifier.
+    # @param [Hash] opts the optional parameters
+    # @option opts [ContractsContractVersionsIdPutRequest] :contracts_contract_versions_id_put_request 
+    # @return [Array<(ContractsContractVersion, Integer, Hash)>] ContractsContractVersion data, response status code and response headers
+    def contracts_contract_versions_id_put_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionApi.contracts_contract_versions_id_put ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ContractsContractVersionApi.contracts_contract_versions_id_put"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_versions/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # 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(opts[:'contracts_contract_versions_id_put_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ContractsContractVersion'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionApi.contracts_contract_versions_id_put",
+        :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: ContractsContractVersionApi#contracts_contract_versions_id_put\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Creates a Contract version
+    # Creates a Contract version
+    # @param [Hash] opts the optional parameters
+    # @option opts [ContractsContractVersionsPostRequest] :contracts_contract_versions_post_request 
+    # @return [ContractsContractVersion]
+    def contracts_contract_versions_post(opts = {})
+      data, _status_code, _headers = contracts_contract_versions_post_with_http_info(opts)
+      data
+    end
+
+    # Creates a Contract version
+    # Creates a Contract version
+    # @param [Hash] opts the optional parameters
+    # @option opts [ContractsContractVersionsPostRequest] :contracts_contract_versions_post_request 
+    # @return [Array<(ContractsContractVersion, Integer, Hash)>] ContractsContractVersion data, response status code and response headers
+    def contracts_contract_versions_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionApi.contracts_contract_versions_post ...'
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_versions'
+
+      # 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(opts[:'contracts_contract_versions_post_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ContractsContractVersion'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionApi.contracts_contract_versions_post",
+        :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: ContractsContractVersionApi#contracts_contract_versions_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/factorial_api/api/contracts_contract_version_history_api.rb

@@ -0,0 +1,160 @@
+=begin
+#Factorial API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 2026-10-01
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module F::Api
+  class ContractsContractVersionHistoryApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Reads all Contract version histories
+    # Reads all Contract version histories
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids the ids of the contract versions.
+    # @option opts [Array<String>] :contract_version_ids the ids of the contract versions.
+    # @option opts [Array<String>] :employee_ids the ids of the employees.
+    # @option opts [String] :current_on the date to filter the contract version histories.
+    # @option opts [String] :changes_lteq the date to filter the contract version histories.
+    # @option opts [String] :changes_gteq the date to filter the contract version histories.
+    # @return [ContractsContractVersionHistoriesGet200Response]
+    def contracts_contract_version_histories_get(opts = {})
+      data, _status_code, _headers = contracts_contract_version_histories_get_with_http_info(opts)
+      data
+    end
+
+    # Reads all Contract version histories
+    # Reads all Contract version histories
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :ids the ids of the contract versions.
+    # @option opts [Array<String>] :contract_version_ids the ids of the contract versions.
+    # @option opts [Array<String>] :employee_ids the ids of the employees.
+    # @option opts [String] :current_on the date to filter the contract version histories.
+    # @option opts [String] :changes_lteq the date to filter the contract version histories.
+    # @option opts [String] :changes_gteq the date to filter the contract version histories.
+    # @return [Array<(ContractsContractVersionHistoriesGet200Response, Integer, Hash)>] ContractsContractVersionHistoriesGet200Response data, response status code and response headers
+    def contracts_contract_version_histories_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionHistoryApi.contracts_contract_version_histories_get ...'
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_version_histories'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ids[]'] = @api_client.build_collection_param(opts[:'ids'], :multi) if !opts[:'ids'].nil?
+      query_params[:'contract_version_ids[]'] = @api_client.build_collection_param(opts[:'contract_version_ids'], :multi) if !opts[:'contract_version_ids'].nil?
+      query_params[:'employee_ids[]'] = @api_client.build_collection_param(opts[:'employee_ids'], :multi) if !opts[:'employee_ids'].nil?
+      query_params[:'current_on'] = opts[:'current_on'] if !opts[:'current_on'].nil?
+      query_params[:'changes_lteq'] = opts[:'changes_lteq'] if !opts[:'changes_lteq'].nil?
+      query_params[:'changes_gteq'] = opts[:'changes_gteq'] if !opts[:'changes_gteq'].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] || 'ContractsContractVersionHistoriesGet200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionHistoryApi.contracts_contract_version_histories_get",
+        :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: ContractsContractVersionHistoryApi#contracts_contract_version_histories_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reads a single Contract version history
+    # Reads a single Contract version history
+    # @param id [String] the ids of the contract versions.
+    # @param [Hash] opts the optional parameters
+    # @return [ContractsContractVersionHistory]
+    def contracts_contract_version_histories_id_get(id, opts = {})
+      data, _status_code, _headers = contracts_contract_version_histories_id_get_with_http_info(id, opts)
+      data
+    end
+
+    # Reads a single Contract version history
+    # Reads a single Contract version history
+    # @param id [String] the ids of the contract versions.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ContractsContractVersionHistory, Integer, Hash)>] ContractsContractVersionHistory data, response status code and response headers
+    def contracts_contract_version_histories_id_get_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContractsContractVersionHistoryApi.contracts_contract_version_histories_id_get ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ContractsContractVersionHistoryApi.contracts_contract_version_histories_id_get"
+      end
+      # resource path
+      local_var_path = '/api/2026-10-01/resources/contracts/contract_version_histories/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # 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] || 'ContractsContractVersionHistory'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apikey', 'oauth2']
+
+      new_options = opts.merge(
+        :operation => :"ContractsContractVersionHistoryApi.contracts_contract_version_histories_id_get",
+        :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: ContractsContractVersionHistoryApi#contracts_contract_version_histories_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end