sdksio-verizon-apis-sdk 1.5.0 → 1.5.1

data/lib/verizon/controllers/device_monitoring_controller.rb

@@ -9,7 +9,7 @@ module Verizon
     # TODO: type endpoint description here
     # @param [NotificationReportRequest] body Required parameter: Create
     # Reachability Report Request
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def device_reachability(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -21,18 +21,18 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Error Response',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error Response',
+                                 RestErrorResponseException))
         .execute
     end
 
     # TODO: type endpoint description here
     # @param [StopMonitorRequest] body Optional parameter: Example:
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def stop_device_reachability(body: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::DELETE,
@@ -44,12 +44,12 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Error Response',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error Response',
+                                 RestErrorResponseException))
         .execute
     end
   end

data/lib/verizon/controllers/device_profile_management_controller.rb

@@ -9,7 +9,7 @@ module Verizon
     # Uses the profile to bring the device under management.
     # @param [ActivateDeviceProfileRequest] body Required parameter: Device
     # Profile Query
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def activate_device_through_profile(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -21,18 +21,18 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 RestErrorResponseException))
         .execute
     end
 
     # Uses the profile to activate the device.
     # @param [ProfileRequest] body Required parameter: Device Profile Query
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def profile_to_activate_device(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -44,19 +44,19 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 RestErrorResponseException))
         .execute
     end
 
     # Uses the profile to deactivate the device.
     # @param [DeactivateDeviceProfileRequest] body Required parameter: Device
     # Profile Query
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def profile_to_deactivate_device(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -68,19 +68,19 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 RestErrorResponseException))
         .execute
     end
 
     # Allows the profile to set the fallback attribute to the device.
     # @param [SetFallbackAttributeRequest] body Required parameter: Device
     # Profile Query
-    # @return [RequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def profile_to_set_fallback_attribute(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -92,12 +92,12 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(RequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request',
-                                RestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 RestErrorResponseException))
         .execute
     end
   end

data/lib/verizon/controllers/device_reports_controller.rb

@@ -11,7 +11,7 @@ module Verizon
     # devices (Max 10) and date range (Max 180 days).
     # @param [AggregateSessionReportRequest] body Required parameter: Aggregated
     # report request.
-    # @return [AggregateSessionReport] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def calculate_aggregated_report_synchronous(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -23,27 +23,27 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(AggregateSessionReport.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('401',
-                                'Unauthorized request. Access token is missing or invalid.',
-                                HyperPreciseLocationResultException)
-                   .local_error('403',
-                                'Forbidden request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('404',
-                                'Bad request. Not found.',
-                                HyperPreciseLocationResultException)
-                   .local_error('409',
-                                'Bad request. Conflict state.',
-                                HyperPreciseLocationResultException)
-                   .local_error('500',
-                                'Internal Server Error.',
-                                HyperPreciseLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(AggregateSessionReport.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('401',
+                                 'Unauthorized request. Access token is missing or invalid.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('403',
+                                 'Forbidden request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('404',
+                                 'Bad request. Not found.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('409',
+                                 'Bad request. Conflict state.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('500',
+                                 'Internal Server Error.',
+                                 HyperPreciseLocationResultException))
         .execute
     end
 
@@ -52,7 +52,7 @@ module Verizon
     # list of devices (Max 10000) and date range (Max 180 days).
     # @param [AggregateSessionReportRequest] body Required parameter: Aggregated
     # session report request.
-    # @return [AggregatedReportCallbackResult] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def calculate_aggregated_report_asynchronous(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -64,27 +64,27 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(AggregatedReportCallbackResult.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('401',
-                                'Unauthorized request. Access token is missing or invalid.',
-                                HyperPreciseLocationResultException)
-                   .local_error('403',
-                                'Forbidden request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('404',
-                                'Bad request. Not found.',
-                                HyperPreciseLocationResultException)
-                   .local_error('409',
-                                'Bad request. Conflict state.',
-                                HyperPreciseLocationResultException)
-                   .local_error('500',
-                                'Internal Server Error.',
-                                HyperPreciseLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(AggregatedReportCallbackResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('401',
+                                 'Unauthorized request. Access token is missing or invalid.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('403',
+                                 'Forbidden request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('404',
+                                 'Bad request. Not found.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('409',
+                                 'Bad request. Conflict state.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('500',
+                                 'Internal Server Error.',
+                                 HyperPreciseLocationResultException))
         .execute
     end
 
@@ -92,7 +92,7 @@ module Verizon
     # day.
     # @param [SessionReportRequest] body Required parameter: Request for
     # sessions report.
-    # @return [SessionReport] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def get_sessions_report(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -104,27 +104,27 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(SessionReport.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('401',
-                                'Unauthorized request. Access token is missing or invalid.',
-                                HyperPreciseLocationResultException)
-                   .local_error('403',
-                                'Forbidden request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('404',
-                                'Bad request. Not found.',
-                                HyperPreciseLocationResultException)
-                   .local_error('409',
-                                'Bad request. Conflict state.',
-                                HyperPreciseLocationResultException)
-                   .local_error('500',
-                                'Internal Server Error.',
-                                HyperPreciseLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SessionReport.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('401',
+                                 'Unauthorized request. Access token is missing or invalid.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('403',
+                                 'Forbidden request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('404',
+                                 'Bad request. Not found.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('409',
+                                 'Bad request. Conflict state.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('500',
+                                 'Internal Server Error.',
+                                 HyperPreciseLocationResultException))
         .execute
     end
   end

data/lib/verizon/controllers/device_service_management_controller.rb

@@ -11,7 +11,7 @@ module Verizon
     # device.
     # @param [String] account_number Required parameter: A unique identifier for
     # an account.
-    # @return [BullseyeServiceResult] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def get_device_hyper_precise_status(imei,
                                         account_number)
       new_api_call_builder
@@ -23,34 +23,34 @@ module Verizon
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(BullseyeServiceResult.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('401',
-                                'Unauthorized request. Access token is missing or invalid.',
-                                HyperPreciseLocationResultException)
-                   .local_error('403',
-                                'Forbidden request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('404',
-                                'Bad request. Not found.',
-                                HyperPreciseLocationResultException)
-                   .local_error('409',
-                                'Bad request. Conflict state.',
-                                HyperPreciseLocationResultException)
-                   .local_error('500',
-                                'Internal Server Error.',
-                                HyperPreciseLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(BullseyeServiceResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('401',
+                                 'Unauthorized request. Access token is missing or invalid.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('403',
+                                 'Forbidden request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('404',
+                                 'Bad request. Not found.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('409',
+                                 'Bad request. Conflict state.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('500',
+                                 'Internal Server Error.',
+                                 HyperPreciseLocationResultException))
         .execute
     end
 
     # Enable/disable hyper-precise service for a device.
     # @param [BullseyeServiceRequest] body Required parameter: List of devices
     # and hyper-precise required statuses.
-    # @return [BullseyeServiceResult] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def update_device_hyper_precise_status(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::PUT,
@@ -62,27 +62,27 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(BullseyeServiceResult.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Bad request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('401',
-                                'Unauthorized request. Access token is missing or invalid.',
-                                HyperPreciseLocationResultException)
-                   .local_error('403',
-                                'Forbidden request.',
-                                HyperPreciseLocationResultException)
-                   .local_error('404',
-                                'Bad request. Not found.',
-                                HyperPreciseLocationResultException)
-                   .local_error('409',
-                                'Bad request. Conflict state.',
-                                HyperPreciseLocationResultException)
-                   .local_error('500',
-                                'Internal Server Error.',
-                                HyperPreciseLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(BullseyeServiceResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('401',
+                                 'Unauthorized request. Access token is missing or invalid.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('403',
+                                 'Forbidden request.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('404',
+                                 'Bad request. Not found.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('409',
+                                 'Bad request. Conflict state.',
+                                 HyperPreciseLocationResultException)
+                    .local_error('500',
+                                 'Internal Server Error.',
+                                 HyperPreciseLocationResultException))
         .execute
     end
   end

data/lib/verizon/controllers/device_sms_messaging_controller.rb

@@ -11,7 +11,7 @@ module Verizon
     # traffic and routing considerations.
     # @param [GIOSMSSendRequest] body Required parameter: SMS message to an
     # indiividual device.
-    # @return [GIORequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def send_an_sms_message(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -23,12 +23,12 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(GIORequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('default',
-                                'Error response',
-                                GIORestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(GIORequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Error response',
+                                 GIORestErrorResponseException))
         .execute
     end
 
@@ -37,7 +37,7 @@ module Verizon
     # @param [String] account_name Required parameter: Numeric account name
     # @param [String] mnext Optional parameter: Continue the previous query from
     # the pageUrl in Location Header
-    # @return [SmsMessagesResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def get_sms_messages(account_name,
                          mnext: nil)
       new_api_call_builder
@@ -50,18 +50,18 @@ module Verizon
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(SmsMessagesResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('default',
-                                'Error response',
-                                GIORestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SmsMessagesResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Error response',
+                                 GIORestErrorResponseException))
         .execute
     end
 
     # Starts delivery of SMS messages for the specified account.
     # @param [String] account_name Required parameter: Numeric account name
-    # @return [SuccessResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def start_sms_message_delivery(account_name)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::PUT,
@@ -72,19 +72,19 @@ module Verizon
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(SuccessResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('default',
-                                'Error response',
-                                GIORestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SuccessResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Error response',
+                                 GIORestErrorResponseException))
         .execute
     end
 
     # Returns a list of sms history for a given device during a specified time
     # frame.
     # @param [SMSEventHistoryRequest] body Required parameter: Device Query
-    # @return [GIORequestResponse] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def list_sms_message_history(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -96,12 +96,12 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(GIORequestResponse.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('default',
-                                'Error response',
-                                GIORestErrorResponseException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(GIORequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Error response',
+                                 GIORestErrorResponseException))
         .execute
     end
   end

data/lib/verizon/controllers/devices_location_subscriptions_controller.rb

@@ -8,25 +8,25 @@ module Verizon
   class DevicesLocationSubscriptionsController < BaseController
     # This subscriptions endpoint retrieves an account's current location
     # subscription status.
-    # @param [String] account Required parameter: Account identifier in
+    # @param [String] account_name Required parameter: Account identifier in
     # "##########-#####".
-    # @return [DeviceLocationSubscription] response from the API call
-    def get_location_service_subscription_status(account)
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def get_location_service_subscription_status(account_name)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/subscriptions/{account}',
+                                     '/subscriptions/{accountName}',
                                      Server::DEVICE_LOCATION)
-                   .template_param(new_parameter(account, key: 'account')
+                   .template_param(new_parameter(account_name, key: 'accountName')
                                     .should_encode(true))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:custom_type_deserializer))
-                   .deserialize_into(DeviceLocationSubscription.method(:from_hash))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Unexpected error.',
-                                DeviceLocationResultException))
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DeviceLocationSubscription.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Unexpected error.',
+                                 DeviceLocationResultException))
         .execute
     end
 
@@ -34,7 +34,7 @@ module Verizon
     # on the provided date range.
     # @param [BillUsageRequest] body Required parameter: Request to obtain
     # billable usage for accounts.
-    # @return [Object] response from the API call
+    # @return [ApiResponse]  the complete http response with raw body and status code.
     def get_location_service_usage(body)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
@@ -46,11 +46,11 @@ module Verizon
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
         .response(new_response_handler
-                   .deserializer(APIHelper.method(:json_deserialize))
-                   .is_api_response(true)
-                   .local_error('400',
-                                'Unexpected error.',
-                                DeviceLocationResultException))
+                    .deserializer(APIHelper.method(:json_deserialize))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Unexpected error.',
+                                 DeviceLocationResultException))
         .execute
     end
   end