maxio-advanced-billing-sdk 0.0.3 → 0.0.4

data/lib/advanced_billing/controllers/customers_controller.rb

@@ -0,0 +1,246 @@
+# advanced_billing
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module AdvancedBilling
+  # CustomersController
+  class CustomersController < BaseController
+    # You may create a new Customer at any time, or you may create a Customer at
+    # the same time you create a Subscription. The only validation restriction
+    # is that you may only create one customer for a given reference value.
+    # If provided, the `reference` value must be unique. It represents a unique
+    # identifier for the customer from your own app, i.e. the customer’s ID.
+    # This allows you to retrieve a given customer via a piece of shared
+    # information. Alternatively, you may choose to leave `reference` blank, and
+    # store Chargify’s unique ID for the customer, which is in the `id`
+    # attribute.
+    # Full documentation on how to locate, create and edit Customers in the
+    # Chargify UI can be located
+    # [here](https://chargify.zendesk.com/hc/en-us/articles/4407659914267).
+    # ## Required Country Format
+    # Chargify requires that you use the ISO Standard Country codes when
+    # formatting country attribute of the customer.
+    # Countries should be formatted as 2 characters. For more information,
+    # please see the following wikipedia article on
+    # [ISO_3166-1.](http://en.wikipedia.org/wiki/ISO_3166-1#Current_codes)
+    # ## Required State Format
+    # Chargify requires that you use the ISO Standard State codes when
+    # formatting state attribute of the customer.
+    # + US States (2 characters):
+    # [ISO_3166-2](https://en.wikipedia.org/wiki/ISO_3166-2:US)
+    # + States Outside the US (2-3 characters): To find the correct state codes
+    # outside of the US, please go to
+    # [ISO_3166-1](http://en.wikipedia.org/wiki/ISO_3166-1#Current_codes) and
+    # click on the link in the “ISO 3166-2 codes” column next to country you
+    # wish to populate.
+    # ## Locale
+    # Chargify allows you to attribute a language/region to your customer to
+    # deliver invoices in any required language.
+    # For more: [Customer
+    # Locale](https://chargify.zendesk.com/hc/en-us/articles/4407870384283#custo
+    # mer-locale)
+    # @param [CreateCustomerRequest] body Optional parameter: Example:
+    # @return [CustomerResponse] response from the API call
+    def create_customer(body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/customers.json',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(CustomerResponse.method(:from_hash))
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         CustomerErrorResponseException))
+        .execute
+    end
+
+    # This request will by default list all customers associated with your Site.
+    # ## Find Customer
+    # Use the search feature with the `q` query parameter to retrieve an array
+    # of customers that matches the search query.
+    # Common use cases are:
+    # + Search by an email
+    # + Search by a Chargify ID
+    # + Search by an organization
+    # + Search by a reference value from your application
+    # + Search by a first or last name
+    # To retrieve a single, exact match by reference, please use the [lookup
+    # endpoint](https://developers.chargify.com/docs/api-docs/b710d8fbef104-read
+    # -customer-by-reference).
+    # @param [SortingDirection] direction Optional parameter: Direction to sort
+    # customers by time of creation
+    # @param [Integer] page Optional parameter: Result records are organized in
+    # pages. By default, the first page of results is displayed. The page
+    # parameter specifies a page number of results to fetch. You can start
+    # navigating through the pages to consume the results. You do this by
+    # passing in a page parameter. Retrieve the next page by adding ?page=2 to
+    # the query string. If there are no results to return, then an empty result
+    # set will be returned. Use in query `page=1`.
+    # @param [Integer] per_page Optional parameter: This parameter indicates how
+    # many records to fetch in each request. Default value is 50. The maximum
+    # allowed values is 200; any per_page value over 200 will be changed to 200.
+    # Use in query `per_page=200`.
+    # @param [BasicDateField] date_field Optional parameter: The type of filter
+    # you would like to apply to your search. Use in query:
+    # `date_field=created_at`.
+    # @param [String] start_date Optional parameter: The start date (format
+    # YYYY-MM-DD) with which to filter the date_field. Returns subscriptions
+    # with a timestamp at or after midnight (12:00:00 AM) in your site’s time
+    # zone on the date specified.
+    # @param [String] end_date Optional parameter: The end date (format
+    # YYYY-MM-DD) with which to filter the date_field. Returns subscriptions
+    # with a timestamp up to and including 11:59:59PM in your site’s time zone
+    # on the date specified.
+    # @param [String] start_datetime Optional parameter: The start date and time
+    # (format YYYY-MM-DD HH:MM:SS) with which to filter the date_field. Returns
+    # subscriptions with a timestamp at or after exact time provided in query.
+    # You can specify timezone in query - otherwise your site's time zone will
+    # be used. If provided, this parameter will be used instead of start_date.
+    # @param [String] end_datetime Optional parameter: The end date and time
+    # (format YYYY-MM-DD HH:MM:SS) with which to filter the date_field. Returns
+    # subscriptions with a timestamp at or before exact time provided in query.
+    # You can specify timezone in query - otherwise your site's time zone will
+    # be used. If provided, this parameter will be used instead of end_date.
+    # @param [String] q Optional parameter: A search query by which to filter
+    # customers (can be an email, an ID, a reference, organization)
+    # @return [Array[CustomerResponse]] response from the API call
+    def list_customers(options = {})
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/customers.json',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(options['direction'], key: 'direction'))
+                   .query_param(new_parameter(options['page'], key: 'page'))
+                   .query_param(new_parameter(options['per_page'], key: 'per_page'))
+                   .query_param(new_parameter(options['date_field'], key: 'date_field'))
+                   .query_param(new_parameter(options['start_date'], key: 'start_date'))
+                   .query_param(new_parameter(options['end_date'], key: 'end_date'))
+                   .query_param(new_parameter(options['start_datetime'], key: 'start_datetime'))
+                   .query_param(new_parameter(options['end_datetime'], key: 'end_datetime'))
+                   .query_param(new_parameter(options['q'], key: 'q'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(CustomerResponse.method(:from_hash))
+                   .is_response_array(true))
+        .execute
+    end
+
+    # This method allows to retrieve the Customer properties by
+    # Chargify-generated Customer ID.
+    # @param [Integer] id Required parameter: The Chargify id of the customer
+    # @return [CustomerResponse] response from the API call
+    def read_customer(id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/customers/{id}.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(CustomerResponse.method(:from_hash)))
+        .execute
+    end
+
+    # This method allows to update the Customer.
+    # @param [Integer] id Required parameter: The Chargify id of the customer
+    # @param [UpdateCustomerRequest] body Optional parameter: Example:
+    # @return [CustomerResponse] response from the API call
+    def update_customer(id,
+                        body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/customers/{id}.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(CustomerResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         CustomerErrorResponseException))
+        .execute
+    end
+
+    # This method allows you to delete the Customer.
+    # @param [Integer] id Required parameter: The Chargify id of the customer
+    # @return [void] response from the API call
+    def delete_customer(id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/customers/{id}.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .is_response_void(true))
+        .execute
+    end
+
+    # Use this method to return the customer object if you have the unique
+    # **Reference ID (Your App)** value handy. It will return a single match.
+    # @param [String] reference Required parameter: Customer reference
+    # @return [CustomerResponse] response from the API call
+    def read_customer_by_reference(reference)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/customers/lookup.json',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(reference, key: 'reference')
+                                 .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(CustomerResponse.method(:from_hash)))
+        .execute
+    end
+
+    # This method lists all subscriptions that belong to a customer.
+    # @param [Integer] customer_id Required parameter: The Chargify id of the
+    # customer
+    # @return [Array[SubscriptionResponse]] response from the API call
+    def list_customer_subscriptions(customer_id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/customers/{customer_id}/subscriptions.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(customer_id, key: 'customer_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(SubscriptionResponse.method(:from_hash))
+                   .is_response_array(true))
+        .execute
+    end
+  end
+end

data/lib/advanced_billing/controllers/events_based_billing_segments_controller.rb

@@ -0,0 +1,298 @@
+# advanced_billing
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module AdvancedBilling
+  # EventsBasedBillingSegmentsController
+  class EventsBasedBillingSegmentsController < BaseController
+    # This endpoint creates a new Segment for a Component with segmented Metric.
+    # It allows you to specify properties to bill upon and prices for each
+    # Segment. You can only pass as many "property_values" as the related Metric
+    # has segmenting properties defined.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle for the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle for the
+    # Price Point belonging to the Component
+    # @param [CreateSegmentRequest] body Optional parameter: Example:
+    # @return [SegmentResponse] response from the API call
+    def create_segment(component_id,
+                       price_point_id,
+                       body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(component_id, key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(price_point_id, key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(SegmentResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         EventBasedBillingSegmentErrorsException))
+        .execute
+    end
+
+    # This endpoint allows you to fetch Segments created for a given Price
+    # Point. They will be returned in the order of creation.
+    # You can pass `page` and `per_page` parameters in order to access all of
+    # the segments. By default it will return `30` records. You can set
+    # `per_page` to `200` at most.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle for the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle for the
+    # Price Point belonging to the Component
+    # @param [Integer] page Optional parameter: Result records are organized in
+    # pages. By default, the first page of results is displayed. The page
+    # parameter specifies a page number of results to fetch. You can start
+    # navigating through the pages to consume the results. You do this by
+    # passing in a page parameter. Retrieve the next page by adding ?page=2 to
+    # the query string. If there are no results to return, then an empty result
+    # set will be returned. Use in query `page=1`.
+    # @param [Integer] per_page Optional parameter: This parameter indicates how
+    # many records to fetch in each request. Default value is 30. The maximum
+    # allowed values is 200; any per_page value over 200 will be changed to 200.
+    # Use in query `per_page=200`.
+    # @param [String] filter_segment_property_1_value Optional parameter: The
+    # value passed here would be used to filter segments. Pass a value related
+    # to `segment_property_1` on attached Metric. If empty string is passed,
+    # this filter would be rejected. Use in query
+    # `filter[segment_property_1_value]=EU`.
+    # @param [String] filter_segment_property_2_value Optional parameter: The
+    # value passed here would be used to filter segments. Pass a value related
+    # to `segment_property_2` on attached Metric. If empty string is passed,
+    # this filter would be rejected.
+    # @param [String] filter_segment_property_3_value Optional parameter: The
+    # value passed here would be used to filter segments. Pass a value related
+    # to `segment_property_3` on attached Metric. If empty string is passed,
+    # this filter would be rejected.
+    # @param [String] filter_segment_property_4_value Optional parameter: The
+    # value passed here would be used to filter segments. Pass a value related
+    # to `segment_property_4` on attached Metric. If empty string is passed,
+    # this filter would be rejected.
+    # @return [ListSegmentsResponse] response from the API call
+    def list_segments_for_price_point(options = {})
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(options['component_id'], key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(options['price_point_id'], key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .query_param(new_parameter(options['page'], key: 'page'))
+                   .query_param(new_parameter(options['per_page'], key: 'per_page'))
+                   .query_param(new_parameter(options['filter_segment_property_1_value'], key: 'filter[segment_property_1_value]'))
+                   .query_param(new_parameter(options['filter_segment_property_2_value'], key: 'filter[segment_property_2_value]'))
+                   .query_param(new_parameter(options['filter_segment_property_3_value'], key: 'filter[segment_property_3_value]'))
+                   .query_param(new_parameter(options['filter_segment_property_4_value'], key: 'filter[segment_property_4_value]'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(ListSegmentsResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         EventBasedBillingListSegmentsErrorsException))
+        .execute
+    end
+
+    # This endpoint updates a single Segment for a Component with a segmented
+    # Metric. It allows you to update the pricing for the segment.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle of the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle of the
+    # Price Point belonging to the Component
+    # @param [Float] id Required parameter: The ID of the Segment
+    # @param [UpdateSegmentRequest] body Optional parameter: Example:
+    # @return [SegmentResponse] response from the API call
+    def update_segment(component_id,
+                       price_point_id,
+                       id,
+                       body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments/{id}.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(component_id, key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(price_point_id, key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(SegmentResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         EventBasedBillingSegmentErrorsException))
+        .execute
+    end
+
+    # This endpoint allows you to delete a Segment with specified ID.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle of the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle of the
+    # Price Point belonging to the Component
+    # @param [Float] id Required parameter: The ID of the Segment
+    # @return [void] response from the API call
+    def delete_segment(component_id,
+                       price_point_id,
+                       id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments/{id}.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(component_id, key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(price_point_id, key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .is_response_void(true)
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         APIException))
+        .execute
+    end
+
+    # This endpoint allows you to create multiple segments in one request. The
+    # array of segments can contain up to `2000` records.
+    # If any of the records contain an error the whole request would fail and
+    # none of the requested segments get created. The error response contains a
+    # message for only the one segment that failed validation, with the
+    # corresponding index in the array.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle for the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle for the
+    # Price Point belonging to the Component
+    # @param [BulkCreateSegments] body Optional parameter: Example:
+    # @return [ListSegmentsResponse] response from the API call
+    def create_segments(component_id,
+                        price_point_id,
+                        body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments/bulk.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(component_id, key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(price_point_id, key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(ListSegmentsResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         EventBasedBillingSegmentException))
+        .execute
+    end
+
+    # This endpoint allows you to update multiple segments in one request. The
+    # array of segments can contain up to `1000` records.
+    # If any of the records contain an error the whole request would fail and
+    # none of the requested segments get updated. The error response contains a
+    # message for only the one segment that failed validation, with the
+    # corresponding index in the array.
+    # You may specify component and/or price point by using either the numeric
+    # ID or the `handle:gold` syntax.
+    # @param [String] component_id Required parameter: ID or Handle for the
+    # Component
+    # @param [String] price_point_id Required parameter: ID or Handle for the
+    # Price Point belonging to the Component
+    # @param [BulkUpdateSegments] body Optional parameter: Example:
+    # @return [ListSegmentsResponse] response from the API call
+    def update_segments(component_id,
+                        price_point_id,
+                        body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/components/{component_id}/price_points/{price_point_id}/segments/bulk.json',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(component_id, key: 'component_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(price_point_id, key: 'price_point_id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:custom_type_deserializer))
+                   .deserialize_into(ListSegmentsResponse.method(:from_hash))
+                   .local_error_template('404',
+                                         'Not Found:\'{$response.body}\'',
+                                         APIException)
+                   .local_error_template('422',
+                                         'HTTP Response Not OK. Status code: {$statusCode}.'\
+                                          ' Response: \'{$response.body}\'.',
+                                         EventBasedBillingSegmentException))
+        .execute
+    end
+  end
+end