bandwidth-sdk 6.2.0 → 9.0.0

data/lib/bandwidth/voice_lib/voice/controllers/api_controller.rb

@@ -11,12 +11,12 @@ module Voice
       super(config, http_call_back: http_call_back)
     end
 
-    # Creates an outbound call
+    # Creates an outbound phone call.
     # @param [String] account_id Required parameter: Example:
-    # @param [ApiCreateCallRequest] body Optional parameter: Example:
-    # @return [ApiCallResponse] response from the API call
+    # @param [CreateCallRequest] body Required parameter: Example:
+    # @return [CreateCallResponse] response from the API call
     def create_call(account_id,
-                    body: nil)
+                    body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls'
@@ -42,42 +42,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -87,16 +88,16 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: ApiCallResponse.from_hash(decoded)
+        _response, data: CreateCallResponse.from_hash(decoded)
       )
     end
 
-    # Returns near-realtime metadata about the specified call
+    # Returns near-realtime metadata about the specified call.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
-    # @return [ApiCallStateResponse] response from the API call
-    def get_call_state(account_id,
-                       call_id)
+    # @return [CallState] response from the API call
+    def get_call(account_id,
+                 call_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}'
@@ -121,42 +122,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -166,18 +168,18 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: ApiCallStateResponse.from_hash(decoded)
+        _response, data: CallState.from_hash(decoded)
       )
     end
 
-    # Interrupts and replaces an active call's BXML document
+    # Interrupts and replaces an active call's BXML document.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
-    # @param [ApiModifyCallRequest] body Optional parameter: Example:
+    # @param [ModifyCallRequest] body Required parameter: Example:
     # @return [void] response from the API call
     def modify_call(account_id,
                     call_id,
-                    body: nil)
+                    body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}'
@@ -203,42 +205,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -249,14 +252,14 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Pauses or resumes a recording
+    # Pauses or resumes a recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
-    # @param [ModifyCallRecordingState] body Optional parameter: Example:
+    # @param [ModifyCallRecordingRequest] body Required parameter: Example:
     # @return [void] response from the API call
     def modify_call_recording_state(account_id,
                                     call_id,
-                                    body: nil)
+                                    body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recording'
@@ -282,42 +285,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -329,12 +333,12 @@ module Voice
     end
 
     # Returns a (potentially empty) list of metadata for the recordings that
-    # took place during the specified call
+    # took place during the specified call.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
-    # @return [List of RecordingMetadataResponse] response from the API call
-    def get_query_metadata_for_account_and_call(account_id,
-                                                call_id)
+    # @return [List of CallRecordingMetadata] response from the API call
+    def get_call_recordings(account_id,
+                            call_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings'
@@ -359,42 +363,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -405,18 +410,18 @@ module Voice
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
         _response,
-        data: decoded.map { |element| RecordingMetadataResponse.from_hash(element) }
+        data: decoded.map { |element| CallRecordingMetadata.from_hash(element) }
       )
     end
 
-    # Returns metadata for the specified recording
+    # Returns metadata for the specified recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
-    # @return [RecordingMetadataResponse] response from the API call
-    def get_metadata_for_recording(account_id,
-                                   call_id,
-                                   recording_id)
+    # @return [CallRecordingMetadata] response from the API call
+    def get_call_recording(account_id,
+                           call_id,
+                           recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}'
@@ -442,42 +447,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -487,11 +493,11 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: RecordingMetadataResponse.from_hash(decoded)
+        _response, data: CallRecordingMetadata.from_hash(decoded)
       )
     end
 
-    # Deletes the specified recording
+    # Deletes the specified recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
@@ -518,42 +524,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -564,14 +571,14 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Downloads the specified recording
+    # Downloads the specified recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
-    # @return [Binary] response from the API call
-    def get_stream_recording_media(account_id,
-                                   call_id,
-                                   recording_id)
+    # @return [Mixed] response from the API call
+    def get_download_call_recording(account_id,
+                                    call_id,
+                                    recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/media'
@@ -583,50 +590,57 @@ module Voice
       )
       _query_url = APIHelper.clean_url _query_builder
 
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
       # Prepare and execute HttpRequest.
       _request = config.http_client.get(
-        _query_url
+        _query_url,
+        headers: _headers
       )
       VoiceBasicAuth.apply(config, _request)
-      _response = execute_request(_request, binary: true)
+      _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -634,12 +648,15 @@ module Voice
       validate_response(_response)
 
       # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body) unless
+        _response.raw_body.nil? ||
+        _response.raw_body.to_s.strip.empty?
       ApiResponse.new(
-        _response, data: _response.raw_body
+        _response, data: decoded
       )
     end
 
-    # Deletes the specified recording's media
+    # Deletes the specified recording's media.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
@@ -666,42 +683,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -712,14 +730,14 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Downloads the specified transcription
+    # Downloads the specified transcription.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
     # @return [TranscriptionResponse] response from the API call
-    def get_recording_transcription(account_id,
-                                    call_id,
-                                    recording_id)
+    def get_call_transcription(account_id,
+                               call_id,
+                               recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
@@ -745,42 +763,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -794,16 +813,16 @@ module Voice
       )
     end
 
-    # Requests that the specified recording be transcribed
+    # Requests that the specified recording be transcribed.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
-    # @param [ApiTranscribeRecordingRequest] body Optional parameter: Example:
+    # @param [TranscribeRecordingRequest] body Required parameter: Example:
     # @return [void] response from the API call
-    def create_transcribe_recording(account_id,
-                                    call_id,
-                                    recording_id,
-                                    body: nil)
+    def create_transcribe_call_recording(account_id,
+                                         call_id,
+                                         recording_id,
+                                         body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
@@ -830,48 +849,49 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 410
-        raise ApiErrorResponseException.new(
+      when 410
+        raise ApiErrorException.new(
           'The media for this recording has been deleted, so we can\'t' \
           ' transcribe it',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -882,14 +902,14 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Deletes the specified recording's transcription
+    # Deletes the specified recording's transcription.
     # @param [String] account_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
     # @return [void] response from the API call
-    def delete_recording_transcription(account_id,
-                                       call_id,
-                                       recording_id)
+    def delete_call_transcription(account_id,
+                                  call_id,
+                                  recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription'
@@ -909,42 +929,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -955,20 +976,20 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Returns information about the conferences in the account
+    # Returns information about the conferences in the account.
     # @param [String] account_id Required parameter: Example:
-    # @param [Integer] page_size Optional parameter: Example:1000
-    # @param [String] page_token Optional parameter: Example:
     # @param [String] name Optional parameter: Example:
     # @param [String] min_created_time Optional parameter: Example:
     # @param [String] max_created_time Optional parameter: Example:
-    # @return [List of ConferenceDetail] response from the API call
-    def get_conferences_by_account(account_id,
-                                   page_size: 1000,
-                                   page_token: nil,
-                                   name: nil,
-                                   min_created_time: nil,
-                                   max_created_time: nil)
+    # @param [Integer] page_size Optional parameter: Example:1000
+    # @param [String] page_token Optional parameter: Example:
+    # @return [List of ConferenceState] response from the API call
+    def get_conferences(account_id,
+                        name: nil,
+                        min_created_time: nil,
+                        max_created_time: nil,
+                        page_size: 1000,
+                        page_token: nil)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences'
@@ -978,11 +999,11 @@ module Voice
       )
       _query_builder = APIHelper.append_url_with_query_parameters(
         _query_builder,
-        'pageSize' => page_size,
-        'pageToken' => page_token,
         'name' => name,
         'minCreatedTime' => min_created_time,
-        'maxCreatedTime' => max_created_time
+        'maxCreatedTime' => max_created_time,
+        'pageSize' => page_size,
+        'pageToken' => page_token
       )
       _query_url = APIHelper.clean_url _query_builder
 
@@ -1000,42 +1021,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1046,16 +1068,16 @@ module Voice
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
         _response,
-        data: decoded.map { |element| ConferenceDetail.from_hash(element) }
+        data: decoded.map { |element| ConferenceState.from_hash(element) }
       )
     end
 
-    # Returns information about the specified conference
+    # Returns information about the specified conference.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
-    # @return [ConferenceDetail] response from the API call
-    def get_conference_by_id(account_id,
-                             conference_id)
+    # @return [ConferenceState] response from the API call
+    def get_conference(account_id,
+                       conference_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}'
@@ -1080,42 +1102,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1125,18 +1148,18 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: ConferenceDetail.from_hash(decoded)
+        _response, data: ConferenceState.from_hash(decoded)
       )
     end
 
-    # Modify the conference state
+    # Modify the conference state.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
-    # @param [ApiModifyConferenceRequest] body Optional parameter: Example:
+    # @param [ModifyConferenceRequest] body Required parameter: Example:
     # @return [void] response from the API call
     def modify_conference(account_id,
                           conference_id,
-                          body: nil)
+                          body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}'
@@ -1162,42 +1185,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1208,16 +1232,16 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Updates settings for a particular conference member
+    # Updates settings for a particular conference member.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
     # @param [String] call_id Required parameter: Example:
-    # @param [ConferenceMemberDetail] body Optional parameter: Example:
+    # @param [ConferenceMemberState] body Required parameter: Example:
     # @return [void] response from the API call
     def modify_conference_member(account_id,
                                  conference_id,
                                  call_id,
-                                 body: nil)
+                                 body)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/members/{callId}'
@@ -1244,42 +1268,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1290,11 +1315,11 @@ module Voice
       ApiResponse.new(_response)
     end
 
-    # Returns information about the specified conference member
+    # Returns information about the specified conference member.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
     # @param [String] member_id Required parameter: Example:
-    # @return [ConferenceMemberDetail] response from the API call
+    # @return [ConferenceMemberState] response from the API call
     def get_conference_member(account_id,
                               conference_id,
                               member_id)
@@ -1323,42 +1348,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1368,7 +1394,7 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: ConferenceMemberDetail.from_hash(decoded)
+        _response, data: ConferenceMemberState.from_hash(decoded)
       )
     end
 
@@ -1376,9 +1402,9 @@ module Voice
     # took place during the specified conference
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
-    # @return [List of ConferenceRecordingMetadataResponse] response from the API call
-    def get_query_metadata_for_account_and_conference(account_id,
-                                                      conference_id)
+    # @return [List of ConferenceRecordingMetadata] response from the API call
+    def get_conference_recordings(account_id,
+                                  conference_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings'
@@ -1403,42 +1429,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1449,18 +1476,18 @@ module Voice
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
         _response,
-        data: decoded.map { |element| ConferenceRecordingMetadataResponse.from_hash(element) }
+        data: decoded.map { |element| ConferenceRecordingMetadata.from_hash(element) }
       )
     end
 
-    # Returns metadata for the specified recording
+    # Returns metadata for the specified recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
-    # @return [RecordingMetadataResponse] response from the API call
-    def get_metadata_for_conference_recording(account_id,
-                                              conference_id,
-                                              recording_id)
+    # @return [CallRecordingMetadata] response from the API call
+    def get_conference_recording(account_id,
+                                 conference_id,
+                                 recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings/{recordingId}'
@@ -1486,42 +1513,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1531,18 +1559,18 @@ module Voice
       # Return appropriate response type.
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
-        _response, data: RecordingMetadataResponse.from_hash(decoded)
+        _response, data: CallRecordingMetadata.from_hash(decoded)
       )
     end
 
-    # Downloads the specified recording
+    # Downloads the specified recording.
     # @param [String] account_id Required parameter: Example:
     # @param [String] conference_id Required parameter: Example:
     # @param [String] recording_id Required parameter: Example:
-    # @return [Binary] response from the API call
-    def get_stream_conference_recording_media(account_id,
-                                              conference_id,
-                                              recording_id)
+    # @return [Mixed] response from the API call
+    def get_download_conference_recording(account_id,
+                                          conference_id,
+                                          recording_id)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/conferences/{conferenceId}/recordings/{recordingId}/media'
@@ -1554,50 +1582,57 @@ module Voice
       )
       _query_url = APIHelper.clean_url _query_builder
 
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
       # Prepare and execute HttpRequest.
       _request = config.http_client.get(
-        _query_url
+        _query_url,
+        headers: _headers
       )
       VoiceBasicAuth.apply(config, _request)
-      _response = execute_request(_request, binary: true)
+      _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1605,8 +1640,11 @@ module Voice
       validate_response(_response)
 
       # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body) unless
+        _response.raw_body.nil? ||
+        _response.raw_body.to_s.strip.empty?
       ApiResponse.new(
-        _response, data: _response.raw_body
+        _response, data: decoded
       )
     end
 
@@ -1619,12 +1657,12 @@ module Voice
     # @param [String] to Optional parameter: Example:
     # @param [String] min_start_time Optional parameter: Example:
     # @param [String] max_start_time Optional parameter: Example:
-    # @return [List of RecordingMetadataResponse] response from the API call
-    def get_query_metadata_for_account(account_id,
-                                       from: nil,
-                                       to: nil,
-                                       min_start_time: nil,
-                                       max_start_time: nil)
+    # @return [List of CallRecordingMetadata] response from the API call
+    def get_query_call_recordings(account_id,
+                                  from: nil,
+                                  to: nil,
+                                  min_start_time: nil,
+                                  max_start_time: nil)
       # Prepare query url.
       _query_builder = config.get_base_uri(Server::VOICEDEFAULT)
       _query_builder << '/api/v2/accounts/{accountId}/recordings'
@@ -1655,42 +1693,43 @@ module Voice
       _response = execute_request(_request)
 
       # Validate response against endpoint and global error codes.
-      if _response.status_code == 400
-        raise ApiErrorResponseException.new(
+      case _response.status_code
+      when 400
+        raise ApiErrorException.new(
           'Something\'s not quite right... Your request is invalid. Please' \
           ' fix it before trying again.',
           _response
         )
-      elsif _response.status_code == 401
+      when 401
         raise APIException.new(
           'Your credentials are invalid. Please use your Bandwidth dashboard' \
           ' credentials to authenticate to the API.',
           _response
         )
-      elsif _response.status_code == 403
-        raise ApiErrorResponseException.new(
+      when 403
+        raise ApiErrorException.new(
           'User unauthorized to perform this action.',
           _response
         )
-      elsif _response.status_code == 404
-        raise ApiErrorResponseException.new(
+      when 404
+        raise ApiErrorException.new(
           'The resource specified cannot be found or does not belong to you.',
           _response
         )
-      elsif _response.status_code == 415
-        raise ApiErrorResponseException.new(
+      when 415
+        raise ApiErrorException.new(
           'We don\'t support that media type. If a request body is required,' \
           ' please send it to us as `application/json`.',
           _response
         )
-      elsif _response.status_code == 429
-        raise ApiErrorResponseException.new(
+      when 429
+        raise ApiErrorException.new(
           'You\'re sending requests to this endpoint too frequently. Please' \
           ' slow your request rate down and try again.',
           _response
         )
-      elsif _response.status_code == 500
-        raise ApiErrorResponseException.new(
+      when 500
+        raise ApiErrorException.new(
           'Something unexpected happened. Please try again.',
           _response
         )
@@ -1701,7 +1740,7 @@ module Voice
       decoded = APIHelper.json_deserialize(_response.raw_body)
       ApiResponse.new(
         _response,
-        data: decoded.map { |element| RecordingMetadataResponse.from_hash(element) }
+        data: decoded.map { |element| CallRecordingMetadata.from_hash(element) }
       )
     end
   end