candidhealth 1.3.1 → 1.5.0

data/lib/candidhealth/pre_encounter/appointments/v_1/types/mutable_appointment.rb

@@ -40,6 +40,8 @@ module CandidApiClient
             attr_reader :estimated_patient_responsibility_cents
             # @return [Integer]
             attr_reader :patient_deposit_cents
+            # @return [String]
+            attr_reader :appointment_details
             # @return [DateTime] The timestamp when the patient checked in for their appointment. If status is
             #  CHECKED_IN, checked_in_timestamp must be set. If checked_in_timestamp is set,
             #  status must be CHECKED_IN.
@@ -81,6 +83,7 @@ module CandidApiClient
             # @param estimated_copay_cents [Integer]
             # @param estimated_patient_responsibility_cents [Integer]
             # @param patient_deposit_cents [Integer]
+            # @param appointment_details [String]
             # @param checked_in_timestamp [DateTime] The timestamp when the patient checked in for their appointment. If status is
             #  CHECKED_IN, checked_in_timestamp must be set. If checked_in_timestamp is set,
             #  status must be CHECKED_IN.
@@ -97,7 +100,7 @@ module CandidApiClient
             # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::MutableAppointment]
             def initialize(patient_id:, start_timestamp:, service_duration:, services:, status: OMIT,
-                           placer_appointment_id: OMIT, attending_doctor: OMIT, estimated_copay_cents: OMIT, estimated_patient_responsibility_cents: OMIT, patient_deposit_cents: OMIT, checked_in_timestamp: OMIT, notes: OMIT, location_resource_id: OMIT, automated_eligibility_check_complete: OMIT, work_queue: OMIT, additional_properties: nil)
+                           placer_appointment_id: OMIT, attending_doctor: OMIT, estimated_copay_cents: OMIT, estimated_patient_responsibility_cents: OMIT, patient_deposit_cents: OMIT, appointment_details: OMIT, checked_in_timestamp: OMIT, notes: OMIT, location_resource_id: OMIT, automated_eligibility_check_complete: OMIT, work_queue: OMIT, additional_properties: nil)
               @patient_id = patient_id
               @start_timestamp = start_timestamp
               @status = status if status != OMIT
@@ -110,6 +113,7 @@ module CandidApiClient
                 @estimated_patient_responsibility_cents = estimated_patient_responsibility_cents
               end
               @patient_deposit_cents = patient_deposit_cents if patient_deposit_cents != OMIT
+              @appointment_details = appointment_details if appointment_details != OMIT
               @checked_in_timestamp = checked_in_timestamp if checked_in_timestamp != OMIT
               @notes = notes if notes != OMIT
               @location_resource_id = location_resource_id if location_resource_id != OMIT
@@ -129,6 +133,7 @@ module CandidApiClient
                 "estimated_copay_cents": estimated_copay_cents,
                 "estimated_patient_responsibility_cents": estimated_patient_responsibility_cents,
                 "patient_deposit_cents": patient_deposit_cents,
+                "appointment_details": appointment_details,
                 "checked_in_timestamp": checked_in_timestamp,
                 "notes": notes,
                 "location_resource_id": location_resource_id,
@@ -166,6 +171,7 @@ module CandidApiClient
               estimated_copay_cents = struct["estimated_copay_cents"]
               estimated_patient_responsibility_cents = struct["estimated_patient_responsibility_cents"]
               patient_deposit_cents = struct["patient_deposit_cents"]
+              appointment_details = struct["appointment_details"]
               checked_in_timestamp = unless parsed_json["checked_in_timestamp"].nil?
                                        DateTime.parse(parsed_json["checked_in_timestamp"])
                                      end
@@ -184,6 +190,7 @@ module CandidApiClient
                 estimated_copay_cents: estimated_copay_cents,
                 estimated_patient_responsibility_cents: estimated_patient_responsibility_cents,
                 patient_deposit_cents: patient_deposit_cents,
+                appointment_details: appointment_details,
                 checked_in_timestamp: checked_in_timestamp,
                 notes: notes,
                 location_resource_id: location_resource_id,
@@ -217,6 +224,7 @@ module CandidApiClient
               obj.estimated_copay_cents&.is_a?(Integer) != false || raise("Passed value for field obj.estimated_copay_cents is not the expected type, validation failed.")
               obj.estimated_patient_responsibility_cents&.is_a?(Integer) != false || raise("Passed value for field obj.estimated_patient_responsibility_cents is not the expected type, validation failed.")
               obj.patient_deposit_cents&.is_a?(Integer) != false || raise("Passed value for field obj.patient_deposit_cents is not the expected type, validation failed.")
+              obj.appointment_details&.is_a?(String) != false || raise("Passed value for field obj.appointment_details is not the expected type, validation failed.")
               obj.checked_in_timestamp&.is_a?(DateTime) != false || raise("Passed value for field obj.checked_in_timestamp is not the expected type, validation failed.")
               obj.notes&.is_a?(String) != false || raise("Passed value for field obj.notes is not the expected type, validation failed.")
               obj.location_resource_id&.is_a?(String) != false || raise("Passed value for field obj.location_resource_id is not the expected type, validation failed.")

data/lib/candidhealth/pre_encounter/appointments/v_1/types/visit.rb

@@ -3,6 +3,7 @@
 require_relative "../../../patients/v_1/types/mutable_patient_with_mrn"
 require "date"
 require_relative "appointment_status"
+require_relative "../../../coverages/v_1/types/mutable_coverage"
 require "ostruct"
 require "json"
 
@@ -21,6 +22,8 @@ module CandidApiClient
             attr_reader :start_time
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus]
             attr_reader :status
+            # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::MutableCoverage]
+            attr_reader :primary_coverage
             # @return [OpenStruct] Additional properties unmapped to the current class definition
             attr_reader :additional_properties
             # @return [Object]
@@ -33,15 +36,26 @@ module CandidApiClient
             # @param patient [CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn]
             # @param start_time [DateTime]
             # @param status [CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus]
+            # @param primary_coverage [CandidApiClient::PreEncounter::Coverages::V1::Types::MutableCoverage]
             # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
             # @return [CandidApiClient::PreEncounter::Appointments::V1::Types::Visit]
-            def initialize(patient_id:, patient:, start_time:, status:, additional_properties: nil)
+            def initialize(patient_id:, patient:, start_time:, status:, primary_coverage: OMIT,
+                           additional_properties: nil)
               @patient_id = patient_id
               @patient = patient
               @start_time = start_time
               @status = status
+              @primary_coverage = primary_coverage if primary_coverage != OMIT
               @additional_properties = additional_properties
-              @_field_set = { "patient_id": patient_id, "patient": patient, "start_time": start_time, "status": status }
+              @_field_set = {
+                "patient_id": patient_id,
+                "patient": patient,
+                "start_time": start_time,
+                "status": status,
+                "primary_coverage": primary_coverage
+              }.reject do |_k, v|
+                v == OMIT
+              end
             end
 
             # Deserialize a JSON object to an instance of Visit
@@ -60,11 +74,18 @@ module CandidApiClient
               end
               start_time = (DateTime.parse(parsed_json["start_time"]) unless parsed_json["start_time"].nil?)
               status = struct["status"]
+              if parsed_json["primary_coverage"].nil?
+                primary_coverage = nil
+              else
+                primary_coverage = parsed_json["primary_coverage"].to_json
+                primary_coverage = CandidApiClient::PreEncounter::Coverages::V1::Types::MutableCoverage.from_json(json_object: primary_coverage)
+              end
               new(
                 patient_id: patient_id,
                 patient: patient,
                 start_time: start_time,
                 status: status,
+                primary_coverage: primary_coverage,
                 additional_properties: struct
               )
             end
@@ -87,6 +108,7 @@ module CandidApiClient
               CandidApiClient::PreEncounter::Patients::V1::Types::MutablePatientWithMrn.validate_raw(obj: obj.patient)
               obj.start_time.is_a?(DateTime) != false || raise("Passed value for field obj.start_time is not the expected type, validation failed.")
               obj.status.is_a?(CandidApiClient::PreEncounter::Appointments::V1::Types::AppointmentStatus) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
+              obj.primary_coverage.nil? || CandidApiClient::PreEncounter::Coverages::V1::Types::MutableCoverage.validate_raw(obj: obj.primary_coverage)
             end
           end
         end

data/lib/candidhealth/pre_encounter/common/types/base_model.rb

@@ -14,7 +14,7 @@ module CandidApiClient
           # @return [Boolean] True if the object is deactivated.  Deactivated objects are not returned in
           #  search results but are returned in all other endpoints including scan.
           attr_reader :deactivated
-          # @return [Integer] The version of the object.  Any update to any property of an object object will
+          # @return [Integer] The version of the object. Any update to any property of an object object will
           #  create a new version.
           attr_reader :version
           # @return [DateTime]
@@ -32,7 +32,7 @@ module CandidApiClient
           # @param organization_id [String] The organization that owns this object.
           # @param deactivated [Boolean] True if the object is deactivated.  Deactivated objects are not returned in
           #  search results but are returned in all other endpoints including scan.
-          # @param version [Integer] The version of the object.  Any update to any property of an object object will
+          # @param version [Integer] The version of the object. Any update to any property of an object object will
           #  create a new version.
           # @param updated_at [DateTime]
           # @param updating_user_id [String] The user ID of the user who last updated the object.

data/lib/candidhealth/pre_encounter/coverages/v_1/client.rb

@@ -193,8 +193,10 @@ module CandidApiClient
             CandidApiClient::PreEncounter::Coverages::V1::Types::Coverage.from_json(json_object: response.body)
           end
 
-          # Updates a Coverage.  The path must contain the most recent version to prevent
-          #  race conditions.  Updating historic versions is not supported.
+          # Updates a Coverage. The path must contain the next version number to prevent
+          #  race conditions. For example, if the current version of the coverage is n, you
+          #  will need to send a request to this endpoint with `/{id}/n+1` to update the
+          #  coverage. Updating historic versions is not supported.
           #
           # @param id [String]
           # @param version [String]
@@ -776,8 +778,10 @@ module CandidApiClient
             end
           end
 
-          # Updates a Coverage.  The path must contain the most recent version to prevent
-          #  race conditions.  Updating historic versions is not supported.
+          # Updates a Coverage. The path must contain the next version number to prevent
+          #  race conditions. For example, if the current version of the coverage is n, you
+          #  will need to send a request to this endpoint with `/{id}/n+1` to update the
+          #  coverage. Updating historic versions is not supported.
           #
           # @param id [String]
           # @param version [String]

data/lib/candidhealth/pre_encounter/coverages/v_1/types/coverage.rb

@@ -25,7 +25,7 @@ module CandidApiClient
             # @return [Boolean] True if the object is deactivated.  Deactivated objects are not returned in
             #  search results but are returned in all other endpoints including scan.
             attr_reader :deactivated
-            # @return [Integer] The version of the object.  Any update to any property of an object object will
+            # @return [Integer] The version of the object. Any update to any property of an object object will
             #  create a new version.
             attr_reader :version
             # @return [DateTime]
@@ -41,7 +41,8 @@ module CandidApiClient
             # @return [CandidApiClient::PreEncounter::Common::Types::Relationship] The relationship of beneficiary (patient) to the subscriber.
             #  https://hl7.org/fhir/valueset-relationship.html
             attr_reader :relationship
-            # @return [String] The patient who benefits from the insurance coverage
+            # @return [String] The canonical Candid patient UUID corresponding with the patient who benefits
+            #  from the insurance coverage
             attr_reader :patient
             # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::InsurancePlan]
             attr_reader :insurance_plan
@@ -65,7 +66,7 @@ module CandidApiClient
             # @param organization_id [String] The organization that owns this object.
             # @param deactivated [Boolean] True if the object is deactivated.  Deactivated objects are not returned in
             #  search results but are returned in all other endpoints including scan.
-            # @param version [Integer] The version of the object.  Any update to any property of an object object will
+            # @param version [Integer] The version of the object. Any update to any property of an object object will
             #  create a new version.
             # @param updated_at [DateTime]
             # @param updating_user_id [String] The user ID of the user who last updated the object.
@@ -75,7 +76,8 @@ module CandidApiClient
             #  their family is due.
             # @param relationship [CandidApiClient::PreEncounter::Common::Types::Relationship] The relationship of beneficiary (patient) to the subscriber.
             #  https://hl7.org/fhir/valueset-relationship.html
-            # @param patient [String] The patient who benefits from the insurance coverage
+            # @param patient [String] The canonical Candid patient UUID corresponding with the patient who benefits
+            #  from the insurance coverage
             # @param insurance_plan [CandidApiClient::PreEncounter::Coverages::V1::Types::InsurancePlan]
             # @param verified [Boolean] A boolean indicating if the coverage has been verified by a user.
             # @param eligibility_checks [Array<CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckMetadata>] A list of eligibility check metadata that have been initiated on this coverage.

data/lib/candidhealth/pre_encounter/coverages/v_1/types/mutable_coverage.rb

@@ -25,7 +25,8 @@ module CandidApiClient
             # @return [CandidApiClient::PreEncounter::Common::Types::Relationship] The relationship of beneficiary (patient) to the subscriber.
             #  https://hl7.org/fhir/valueset-relationship.html
             attr_reader :relationship
-            # @return [String] The patient who benefits from the insurance coverage
+            # @return [String] The canonical Candid patient UUID corresponding with the patient who benefits
+            #  from the insurance coverage
             attr_reader :patient
             # @return [CandidApiClient::PreEncounter::Coverages::V1::Types::InsurancePlan]
             attr_reader :insurance_plan
@@ -51,7 +52,8 @@ module CandidApiClient
             #  their family is due.
             # @param relationship [CandidApiClient::PreEncounter::Common::Types::Relationship] The relationship of beneficiary (patient) to the subscriber.
             #  https://hl7.org/fhir/valueset-relationship.html
-            # @param patient [String] The patient who benefits from the insurance coverage
+            # @param patient [String] The canonical Candid patient UUID corresponding with the patient who benefits
+            #  from the insurance coverage
             # @param insurance_plan [CandidApiClient::PreEncounter::Coverages::V1::Types::InsurancePlan]
             # @param verified [Boolean] A boolean indicating if the coverage has been verified by a user.
             # @param eligibility_checks [Array<CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckMetadata>] A list of eligibility check metadata that have been initiated on this coverage.

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/client.rb

@@ -5,6 +5,10 @@ require_relative "types/eligibility_request"
 require_relative "types/eligibility_response"
 require_relative "types/batch_eligibility_response"
 require_relative "types/eligibility_check_page"
+require_relative "types/payer_search_response"
+require_relative "types/eligibility_recommendation"
+require "json"
+require_relative "types/post_eligibility_recommendation_request"
 require "async"
 
 module CandidApiClient
@@ -22,10 +26,6 @@ module CandidApiClient
           end
 
           # Sends real-time eligibility checks to payers through Stedi.
-          #  <Warning>Please only send one concurrent request to this endpoint. Batch
-          #  requests must be made in succession, otherwise, it will cause this service to
-          #  fail. A batch endpoint is in development - please reach out to the Candid team
-          #  for more information.</Warning>
           #
           # @param request [Hash] Request of type CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRequest, as a Hash
           #   * :submitter_transaction_identifier (String)
@@ -106,17 +106,15 @@ module CandidApiClient
           end
 
           # Polls the status of a batch eligibility check.
-          #  <Note>Batch eligibility checks are not yet available. Please reach out to the
-          #  Candid team for more information.</Note>
-          #  path-parameters:
           #
           # @param batch_id [String]
+          # @param page_token [String]
           # @param request_options [CandidApiClient::RequestOptions]
           # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckPage]
           # @example
           #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
           #  api.pre_encounter.eligibility_checks.v_1.poll_batch(batch_id: "batch_id")
-          def poll_batch(batch_id:, request_options: nil)
+          def poll_batch(batch_id:, page_token: nil, request_options: nil)
             response = @request_client.conn.get do |req|
               req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
               req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
@@ -125,11 +123,105 @@ module CandidApiClient
             **@request_client.get_headers,
             **(request_options&.additional_headers || {})
               }.compact
+              req.params = { **(request_options&.additional_query_parameters || {}), "page_token": page_token }.compact
               req.url "#{@request_client.get_url(environment: PreEncounter,
                                                  request_options: request_options)}/eligibility-checks/v1/batch/#{batch_id}"
             end
             CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckPage.from_json(json_object: response.body)
           end
+
+          # Searches for payers that match the query parameters.
+          #
+          # @param page_size [Integer]
+          # @param page_token [String]
+          # @param query [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PayerSearchResponse]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.payer_search
+          def payer_search(page_size: nil, page_token: nil, query: nil, request_options: nil)
+            response = @request_client.conn.get do |req|
+              req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+              req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.params = {
+                **(request_options&.additional_query_parameters || {}),
+                "page_size": page_size,
+                "page_token": page_token,
+                "query": query
+              }.compact
+              req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                 request_options: request_options)}/eligibility-checks/v1/payer/search"
+            end
+            CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PayerSearchResponse.from_json(json_object: response.body)
+          end
+
+          # Gets recommendation for eligibility checks based on the request.
+          #
+          # @param filters [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [Array<CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation>]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.recommendation
+          def recommendation(filters: nil, request_options: nil)
+            response = @request_client.conn.get do |req|
+              req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+              req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.params = { **(request_options&.additional_query_parameters || {}), "filters": filters }.compact
+              req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                 request_options: request_options)}/eligibility-checks/v1/recommendation"
+            end
+            parsed_json = JSON.parse(response.body)
+            parsed_json&.map do |item|
+              item = item.to_json
+              CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation.from_json(json_object: item)
+            end
+          end
+
+          # Create an eligibiilty recommendation based on the request.
+          #
+          # @param request [Hash] Request of type CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PostEligibilityRecommendationRequest, as a Hash
+          #   * :eligibility_check_id (String)
+          #   * :patient (Hash)
+          #     * :id (String)
+          #     * :mrn (String)
+          #     * :organization_id (String)
+          #     * :last_name (String)
+          #     * :first_name (String)
+          #     * :date_of_birth (Date)
+          #     * :member_id (String)
+          #   * :recommendation (Hash)
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.create_recommendation(request: { eligibility_check_id: "eligibility_check_id", patient: {  } })
+          def create_recommendation(request:, request_options: nil)
+            response = @request_client.conn.post do |req|
+              req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+              req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
+              req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+              req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                 request_options: request_options)}/eligibility-checks/v1/recommendation"
+            end
+            CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation.from_json(json_object: response.body)
+          end
         end
 
         class AsyncV1Client
@@ -143,10 +235,6 @@ module CandidApiClient
           end
 
           # Sends real-time eligibility checks to payers through Stedi.
-          #  <Warning>Please only send one concurrent request to this endpoint. Batch
-          #  requests must be made in succession, otherwise, it will cause this service to
-          #  fail. A batch endpoint is in development - please reach out to the Candid team
-          #  for more information.</Warning>
           #
           # @param request [Hash] Request of type CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRequest, as a Hash
           #   * :submitter_transaction_identifier (String)
@@ -231,17 +319,15 @@ module CandidApiClient
           end
 
           # Polls the status of a batch eligibility check.
-          #  <Note>Batch eligibility checks are not yet available. Please reach out to the
-          #  Candid team for more information.</Note>
-          #  path-parameters:
           #
           # @param batch_id [String]
+          # @param page_token [String]
           # @param request_options [CandidApiClient::RequestOptions]
           # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckPage]
           # @example
           #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
           #  api.pre_encounter.eligibility_checks.v_1.poll_batch(batch_id: "batch_id")
-          def poll_batch(batch_id:, request_options: nil)
+          def poll_batch(batch_id:, page_token: nil, request_options: nil)
             Async do
               response = @request_client.conn.get do |req|
                 req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -251,12 +337,115 @@ module CandidApiClient
               **@request_client.get_headers,
               **(request_options&.additional_headers || {})
                 }.compact
+                req.params = {
+                  **(request_options&.additional_query_parameters || {}),
+                  "page_token": page_token
+                }.compact
                 req.url "#{@request_client.get_url(environment: PreEncounter,
                                                    request_options: request_options)}/eligibility-checks/v1/batch/#{batch_id}"
               end
               CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityCheckPage.from_json(json_object: response.body)
             end
           end
+
+          # Searches for payers that match the query parameters.
+          #
+          # @param page_size [Integer]
+          # @param page_token [String]
+          # @param query [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PayerSearchResponse]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.payer_search
+          def payer_search(page_size: nil, page_token: nil, query: nil, request_options: nil)
+            Async do
+              response = @request_client.conn.get do |req|
+                req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+                req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+                req.headers = {
+              **(req.headers || {}),
+              **@request_client.get_headers,
+              **(request_options&.additional_headers || {})
+                }.compact
+                req.params = {
+                  **(request_options&.additional_query_parameters || {}),
+                  "page_size": page_size,
+                  "page_token": page_token,
+                  "query": query
+                }.compact
+                req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                   request_options: request_options)}/eligibility-checks/v1/payer/search"
+              end
+              CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PayerSearchResponse.from_json(json_object: response.body)
+            end
+          end
+
+          # Gets recommendation for eligibility checks based on the request.
+          #
+          # @param filters [String]
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [Array<CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation>]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.recommendation
+          def recommendation(filters: nil, request_options: nil)
+            Async do
+              response = @request_client.conn.get do |req|
+                req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+                req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+                req.headers = {
+              **(req.headers || {}),
+              **@request_client.get_headers,
+              **(request_options&.additional_headers || {})
+                }.compact
+                req.params = { **(request_options&.additional_query_parameters || {}), "filters": filters }.compact
+                req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                   request_options: request_options)}/eligibility-checks/v1/recommendation"
+              end
+              parsed_json = JSON.parse(response.body)
+              parsed_json&.map do |item|
+                item = item.to_json
+                CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation.from_json(json_object: item)
+              end
+            end
+          end
+
+          # Create an eligibiilty recommendation based on the request.
+          #
+          # @param request [Hash] Request of type CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::PostEligibilityRecommendationRequest, as a Hash
+          #   * :eligibility_check_id (String)
+          #   * :patient (Hash)
+          #     * :id (String)
+          #     * :mrn (String)
+          #     * :organization_id (String)
+          #     * :last_name (String)
+          #     * :first_name (String)
+          #     * :date_of_birth (Date)
+          #     * :member_id (String)
+          #   * :recommendation (Hash)
+          # @param request_options [CandidApiClient::RequestOptions]
+          # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation]
+          # @example
+          #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+          #  api.pre_encounter.eligibility_checks.v_1.create_recommendation(request: { eligibility_check_id: "eligibility_check_id", patient: {  } })
+          def create_recommendation(request:, request_options: nil)
+            Async do
+              response = @request_client.conn.post do |req|
+                req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+                req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+                req.headers = {
+              **(req.headers || {}),
+              **@request_client.get_headers,
+              **(request_options&.additional_headers || {})
+                }.compact
+                req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+                req.url "#{@request_client.get_url(environment: PreEncounter,
+                                                   request_options: request_options)}/eligibility-checks/v1/recommendation"
+              end
+              CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::EligibilityRecommendation.from_json(json_object: response.body)
+            end
+          end
         end
       end
     end

data/lib/candidhealth/pre_encounter/eligibility_checks/v_1/types/coordination_of_benefits_recommendation.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module CandidApiClient
+  module PreEncounter
+    module EligibilityChecks
+      module V1
+        module Types
+          # An object representing a Coordination Of Benefits recommendation.
+          class CoordinationOfBenefitsRecommendation
+            # @return [Object]
+            attr_reader :payload
+            # @return [OpenStruct] Additional properties unmapped to the current class definition
+            attr_reader :additional_properties
+            # @return [Object]
+            attr_reader :_field_set
+            protected :_field_set
+
+            OMIT = Object.new
+
+            # @param payload [Object]
+            # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::CoordinationOfBenefitsRecommendation]
+            def initialize(payload:, additional_properties: nil)
+              @payload = payload
+              @additional_properties = additional_properties
+              @_field_set = { "payload": payload }
+            end
+
+            # Deserialize a JSON object to an instance of CoordinationOfBenefitsRecommendation
+            #
+            # @param json_object [String]
+            # @return [CandidApiClient::PreEncounter::EligibilityChecks::V1::Types::CoordinationOfBenefitsRecommendation]
+            def self.from_json(json_object:)
+              struct = JSON.parse(json_object, object_class: OpenStruct)
+              payload = struct["payload"]
+              new(payload: payload, additional_properties: struct)
+            end
+
+            # Serialize an instance of CoordinationOfBenefitsRecommendation to a JSON object
+            #
+            # @return [String]
+            def to_json(*_args)
+              @_field_set&.to_json
+            end
+
+            # Leveraged for Union-type generation, validate_raw attempts to parse the given
+            #  hash and check each fields type against the current object's property
+            #  definitions.
+            #
+            # @param obj [Object]
+            # @return [Void]
+            def self.validate_raw(obj:)
+              obj.payload.is_a?(Object) != false || raise("Passed value for field obj.payload is not the expected type, validation failed.")
+            end
+          end
+        end
+      end
+    end
+  end
+end