recurly 3.17.0 → 4.1.0

data/GETTING_STARTED.md

@@ -5,7 +5,7 @@ This repository houses the official ruby client for Recurly's V3 API.
 In your Gemfile, add `recurly` as a dependency.
 
 ```ruby
-gem 'recurly', '~> 3.17'
+gem 'recurly', '~> 4.1'
 ```
 
 > *Note*: We try to follow [semantic versioning](https://semver.org/) and will only apply breaking changes to major versions.
@@ -106,17 +106,19 @@ plans.each_page.each_with_index do |data, page_num|
 end
 ```
 
-Pagination endpoints take a number of options to sort and filter the results. They can be passed in as keyword arguments.
+Pagination endpoints take a number of options to sort and filter the results. They can be passed in as a hash provided by the `:params` keyword argument.
 The names, types, and descriptions of these arguments are listed in the rubydocs for each method:
 
 ```ruby
 options = {
-  limit: 200, # number of items per page
-  state: :active, # only active plans
-  sort: :updated_at,
-  order: :asc,
-  begin_time: DateTime.new(2017,1,1), # January 1st 2017,
-  end_time: DateTime.now
+  params: {
+    limit: 200, # number of items per page
+    state: :active, # only active plans
+    sort: :updated_at,
+    order: :asc,
+    begin_time: DateTime.new(2017,1,1), # January 1st 2017,
+    end_time: DateTime.now
+  }
 }
 
 plans = client.list_plans(**options)
@@ -200,12 +202,11 @@ plan = client.create_plan(body: plan_data)
 
 # Error Handling
 
-This library currently throws 2 types of exceptions. {Recurly::Errors::APIError} and {Recurly::Errors::NetworkError}. See these 2 files for the types of exceptions you can catch:
+All errors thrown by this library are based off of the `Recurly::Errors::APIError`. There 
 
-1. [API Errors](./lib/recurly/errors/api_errors.rb)
-2. [Network Errors](./lib/recurly/errors/network_errors.rb)
+This library throws one main type of exception, `Recurly::Errors::APIError`. There exists an additional hierarchy of errors to facilitate the process of rescuing various classes of errors. More detail can be found in the [Api Errors Module](./lib/recurly/errors/api_errors.rb).
 
-You will normally be working with {Recurly::Errors::APIError}. You can catch specific or generic versions of these exceptions. Example:
+You can catch specific or generic versions of these exceptions. Example:
 
 ```ruby
 begin
@@ -233,15 +234,17 @@ rescue Recurly::Errors::ValidationError => ex
   #=> #<Recurly::Error:0x007fbbdf8a32c8 @attributes={:type=>"validation", :message=>"Code 'iexistalready' already exists", :params=>[{"param"=>"code", "message"=>"'iexistalready' already exists"}]}>
   puts ex.status_code
   #=> 422
+rescue Recurly::Errors::TimeoutError => ex
+  # catch a specific server error
+rescue Recurly::Errors::ServerError => ex
+  # catch a generic server error
 rescue Recurly::Errors::APIError => ex
   # catch a generic api error
-rescue Recurly::Errors::TimeoutError => ex
-  # catch a specific network error
-rescue Recurly::Errors::NetworkError => ex
-  # catch a generic network error
 end
 ```
 
+`Recurly::Errors::APIError` instances provide access to the response via the `#get_response` method.
+
 # HTTP Metadata
 
 Sometimes you might want to get some additional information about the underlying HTTP request and response. Instead of
@@ -266,7 +269,7 @@ response = @client.remove_line_item(
   line_item_id: "a959576b2b10b012"
 ).get_response
 ```
-And it can be captured on exceptions through the {Recurly::ApiError} object:
+And it can be captured on exceptions through the {Recurly::APIError} object:
 
 ```ruby
 begin

data/lib/recurly/client.rb

@@ -20,7 +20,14 @@ module Recurly
     MAX_RETRIES = 3
     LOG_LEVELS = %i(debug info warn error fatal).freeze
     BASE36_ALPHABET = (("0".."9").to_a + ("a".."z").to_a).freeze
-    REQUEST_OPTIONS = [:headers].freeze
+    ALLOWED_OPTIONS = [
+      :site_id,
+      :open_timeout,
+      :read_timeout,
+      :body,
+      :params,
+      :headers,
+    ].freeze
 
     # Initialize a client. It requires an API key.
     #
@@ -47,8 +54,9 @@ module Recurly
     #
     # @param api_key [String] The private API key
     # @param logger [Logger] A logger to use. Defaults to creating a new STDOUT logger with level WARN.
-    def initialize(api_key:, site_id: nil, subdomain: nil, logger: nil)
-      set_site_id(site_id, subdomain)
+    def initialize(api_key:, logger: nil)
+      raise ArgumentError, "'api_key' must be set to a non-nil value" if api_key.nil?
+
       set_api_key(api_key)
 
       if logger.nil?
@@ -90,6 +98,7 @@ module Recurly
     end
 
     def head(path, **options)
+      validate_options!(**options)
       request = Net::HTTP::Head.new build_url(path, options)
       set_headers(request, options[:headers])
       http_response = run_request(request, options)
@@ -97,6 +106,7 @@ module Recurly
     end
 
     def get(path, **options)
+      validate_options!(**options)
       request = Net::HTTP::Get.new build_url(path, options)
       set_headers(request, options[:headers])
       http_response = run_request(request, options)
@@ -104,6 +114,7 @@ module Recurly
     end
 
     def post(path, request_data, request_class, **options)
+      validate_options!(**options)
       request_class.new(request_data).validate!
       request = Net::HTTP::Post.new build_url(path, options)
       request.set_content_type(JSON_CONTENT_TYPE)
@@ -114,6 +125,7 @@ module Recurly
     end
 
     def put(path, request_data = nil, request_class = nil, **options)
+      validate_options!(**options)
       request = Net::HTTP::Put.new build_url(path, options)
       request.set_content_type(JSON_CONTENT_TYPE)
       set_headers(request, options[:headers])
@@ -127,6 +139,7 @@ module Recurly
     end
 
     def delete(path, **options)
+      validate_options!(**options)
       request = Net::HTTP::Delete.new build_url(path, options)
       set_headers(request, options[:headers])
       http_response = run_request(request, options)
@@ -194,7 +207,7 @@ module Recurly
           end
 
           raise Recurly::Errors::ConnectionFailedError, "Failed to connect to Recurly: #{ex.message}"
-        rescue Net::ReadTimeout, Timeout::Error
+        rescue Timeout::Error
           raise Recurly::Errors::TimeoutError, "Request timed out"
         rescue OpenSSL::SSL::SSLError => ex
           raise Recurly::Errors::SSLError, ex.message
@@ -240,7 +253,7 @@ module Recurly
           elsif BINARY_TYPES.include?(http_response.content_type)
             FileParser.parse(response.body)
           else
-            raise Recurly::Errors::InvalidResponseError, "Unexpected content type: #{http_response.content_type}"
+            raise Recurly::Errors::InvalidContentTypeError, "Unexpected content type: #{http_response.content_type}"
           end
         else
           Resources::Empty.new
@@ -255,10 +268,10 @@ module Recurly
         error = JSONParser.parse(self, response.body)
         begin
           error_class = Errors::APIError.error_class(error.type)
-          raise error_class.new(response, error)
+          raise error_class.new(error.message, response, error)
         rescue NameError
           error_class = Errors::APIError.from_response(http_response)
-          raise error_class.new(response, error)
+          raise error_class.new("Unknown Error", response, error)
         end
       end
 
@@ -266,7 +279,7 @@ module Recurly
 
       if error_class <= Recurly::Errors::APIError
         error = Recurly::Resources::Error.new(message: "#{http_response.code}: #{http_response.message}")
-        raise error_class.new(response, error)
+        raise error_class.new(error.message, response, error)
       else
         raise error_class, "#{http_response.code}: #{http_response.message}"
       end
@@ -279,6 +292,17 @@ module Recurly
       response
     end
 
+    def validate_options!(**options)
+      invalid_options = options.keys.reject do |k|
+        ALLOWED_OPTIONS.include?(k)
+      end
+      if invalid_options.any?
+        joinedKeys = invalid_options.join(", ")
+        joinedOptions = ALLOWED_OPTIONS.join(", ")
+        raise ArgumentError, "Invalid options: '#{joinedKeys}'. Allowed options: '#{joinedOptions}'"
+      end
+    end
+
     def validate_path_parameters!(**options)
       # Check to see that we are passing the correct data types
       # This prevents a confusing error if the user passes in a non-primitive by mistake
@@ -299,7 +323,7 @@ module Recurly
     end
 
     def interpolate_path(path, **options)
-      validate_path_parameters!(options)
+      validate_path_parameters!(**options)
       options.each do |k, v|
         # We need to encode the values for the url
         options[k] = ERB::Util.url_encode(v.to_s)
@@ -308,21 +332,13 @@ module Recurly
       path % options
     end
 
-    def set_site_id(site_id, subdomain)
-      if site_id
-        @site_id = site_id
-      elsif subdomain
-        @site_id = "subdomain-#{subdomain}"
-      end
-    end
-
     def set_api_key(api_key)
-      @api_key = api_key
+      @api_key = api_key.to_s
     end
 
     def build_url(path, options)
       path = scope_by_site(path, options)
-      query_params = options.reject { |k, _| REQUEST_OPTIONS.include?(k.to_sym) }
+      query_params = map_array_params(options.fetch(:params, {}))
       if query_params.any?
         "#{path}?#{URI.encode_www_form(query_params)}"
       else
@@ -330,7 +346,16 @@ module Recurly
       end
     end
 
-    def scope_by_site(path, **options)
+    # Converts array parameters to CSV strings to maintain consistency with
+    # how the server expects the request to be formatted while providing the
+    # developer with an array type to maintain developer happiness!
+    def map_array_params(params)
+      params.map do |key, param|
+        [key, param.is_a?(Array) ? param.join(",") : param]
+      end.to_h
+    end
+
+    def scope_by_site(path, options)
       if site = site_id || options[:site_id]
         # Ensure that we are only including the site_id once because the Pager operations
         # will use the cursor returned from the API which may already have these components

data/lib/recurly/client/operations.rb

@@ -5,14 +5,15 @@
 module Recurly
   class Client
     def api_version
-      "v2019-10-10"
+      "v2021-02-25"
     end
 
     # List sites
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_sites list_sites api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_sites list_sites api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -24,17 +25,20 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param state [String] Filter by state.
+    #        :state [String] Filter by state.
     #
     # @return [Pager<Resources::Site>] A list of sites.
     # @example
-    #   sites = @client.list_sites(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   sites = @client.list_sites(params: params)
     #   sites.each do |site|
     #     puts "Site: #{site.subdomain}"
     #   end
@@ -46,9 +50,10 @@ module Recurly
 
     # Fetch a site
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_site get_site api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_site get_site api documenation}
     #
     # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
     #
     # @return [Resources::Site] A site.
     # @example
@@ -61,16 +66,17 @@ module Recurly
     #     puts "Resource Not Found"
     #   end
     #
-    def get_site(site_id:)
+    def get_site(site_id:, **options)
       path = interpolate_path("/sites/{site_id}", site_id: site_id)
-      get(path)
+      get(path, **options)
     end
 
     # List a site's accounts
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_accounts list_accounts api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_accounts list_accounts api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -82,28 +88,31 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param email [String] Filter for accounts with this exact email address. A blank value will return accounts with both +null+ and +""+ email addresses. Note that multiple accounts can share one email address.
-    # @param subscriber [Boolean] Filter for accounts with or without a subscription in the +active+,
+    #        :email [String] Filter for accounts with this exact email address. A blank value will return accounts with both +null+ and +""+ email addresses. Note that multiple accounts can share one email address.
+    #        :subscriber [Boolean] Filter for accounts with or without a subscription in the +active+,
     #   +canceled+, or +future+ state.
     #
-    # @param past_due [String] Filter for accounts with an invoice in the +past_due+ state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :past_due [String] Filter for accounts with an invoice in the +past_due+ state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Account>] A list of the site's accounts.
     # @example
-    #   accounts = @client.list_accounts(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   accounts = @client.list_accounts(params: params)
     #   accounts.each do |account|
     #     puts "Account: #{account.code}"
     #   end
@@ -115,10 +124,11 @@ module Recurly
 
     # Create an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_account create_account api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_account create_account api documenation}
     #
     # @param body [Requests::AccountCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Account] An account.
     # @example
@@ -164,10 +174,11 @@ module Recurly
 
     # Fetch an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_account get_account api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_account get_account api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Account] An account.
     # @example
@@ -185,13 +196,14 @@ module Recurly
       get(path, **options)
     end
 
-    # Modify an account
+    # Update an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_account update_account api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_account update_account api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::AccountUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Account] An account.
     # @example
@@ -218,10 +230,11 @@ module Recurly
 
     # Deactivate an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_account deactivate_account api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/deactivate_account deactivate_account api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Account] An account.
     # @example
@@ -241,10 +254,11 @@ module Recurly
 
     # Fetch an account's acquisition data
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_account_acquisition get_account_acquisition api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_account_acquisition get_account_acquisition api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AccountAcquisition] An account's acquisition data.
     # @example
@@ -264,11 +278,12 @@ module Recurly
 
     # Update an account's acquisition data
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_account_acquisition update_account_acquisition api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_account_acquisition update_account_acquisition api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param body [Requests::AccountAcquisitionUpdatable] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountAcquisitionUpdatable}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param body [Requests::AccountAcquisitionUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountAcquisitionUpdate}
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AccountAcquisition] An account's updated acquisition data.
     # @example
@@ -295,15 +310,16 @@ module Recurly
     #
     def update_account_acquisition(account_id:, body:, **options)
       path = interpolate_path("/accounts/{account_id}/acquisition", account_id: account_id)
-      put(path, body, Requests::AccountAcquisitionUpdatable, **options)
+      put(path, body, Requests::AccountAcquisitionUpdate, **options)
     end
 
     # Remove an account's acquisition data
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_account_acquisition remove_account_acquisition api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_account_acquisition remove_account_acquisition api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Acquisition data was succesfully deleted.
     # @example
@@ -323,10 +339,11 @@ module Recurly
 
     # Reactivate an inactive account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/reactivate_account reactivate_account api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/reactivate_account reactivate_account api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Account] An account.
     # @example
@@ -346,10 +363,11 @@ module Recurly
 
     # Fetch an account's balance and past due status
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_account_balance get_account_balance api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_account_balance get_account_balance api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AccountBalance] An account's balance.
     # @example
@@ -369,10 +387,11 @@ module Recurly
 
     # Fetch an account's billing information
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_billing_info get_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_billing_info get_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BillingInfo] An account's billing information.
     # @example
@@ -392,11 +411,12 @@ module Recurly
 
     # Set an account's billing information
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_billing_info update_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_billing_info update_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::BillingInfoCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::BillingInfoCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BillingInfo] Updated billing information.
     # @example
@@ -423,10 +443,11 @@ module Recurly
 
     # Remove an account's billing information
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_billing_info remove_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_billing_info remove_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Billing information deleted
     # @example
@@ -446,10 +467,11 @@ module Recurly
 
     # Get the list of billing information associated with an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_billing_infos list_billing_infos api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_billing_infos list_billing_infos api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -461,17 +483,17 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::BillingInfo>] A list of the the billing information for an account's
     #
@@ -482,11 +504,12 @@ module Recurly
 
     # Set an account's billing information when the wallet feature is enabled
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_billing_info create_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_billing_info create_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::BillingInfoCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::BillingInfoCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BillingInfo] Updated billing information.
     #
@@ -497,11 +520,12 @@ module Recurly
 
     # Fetch a billing info
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_a_billing_info get_a_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_a_billing_info get_a_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param billing_info_id [String] Billing Info ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BillingInfo] A billing info.
     #
@@ -512,12 +536,13 @@ module Recurly
 
     # Update an account's billing information
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_a_billing_info update_a_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_a_billing_info update_a_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param billing_info_id [String] Billing Info ID.
     # @param body [Requests::BillingInfoCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::BillingInfoCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BillingInfo] Updated billing information.
     #
@@ -528,11 +553,12 @@ module Recurly
 
     # Remove an account's billing information
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_a_billing_info remove_a_billing_info api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_a_billing_info remove_a_billing_info api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param billing_info_id [String] Billing Info ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Billing information deleted
     #
@@ -543,10 +569,11 @@ module Recurly
 
     # Show the coupon redemptions for an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_coupon_redemptions list_account_coupon_redemptions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_coupon_redemptions list_account_coupon_redemptions api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -558,24 +585,27 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CouponRedemption>] A list of the the coupon redemptions on an account.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   redemptions = @client.list_account_coupon_redemptions(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   redemptions.each do |redemption|
     #     puts "CouponRedemption: #{redemption.id}"
@@ -586,36 +616,37 @@ module Recurly
       pager(path, **options)
     end
 
-    # Show the coupon redemption that is active on an account
+    # Show the coupon redemptions that are active on an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_active_coupon_redemption get_active_coupon_redemption api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_active_coupon_redemptions list_active_coupon_redemptions api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
-    # @return [Resources::CouponRedemption] An active coupon redemption on an account.
+    # @return [Pager<Resources::CouponRedemption>] Active coupon redemptions on an account.
     # @example
-    #   begin
-    #     redemption = @client.get_active_coupon_redemption(account_id: account_id)
-    #     puts "Got CouponRedemption #{redemption}"
-    #   rescue Recurly::Errors::NotFoundError
-    #     # If the resource was not found, you may want to alert the user or
-    #     # just return nil
-    #     puts "Resource Not Found"
+    #   params = {
+    #     limit: 200
+    #   }
+    #   redemptions = @client.list_active_coupon_redemptions(account_id: account_id, params: params)
+    #   redemptions.each do |redemption|
+    #     puts "Redemption: #{redemption.id}"
     #   end
     #
-    def get_active_coupon_redemption(account_id:, **options)
+    def list_active_coupon_redemptions(account_id:, **options)
       path = interpolate_path("/accounts/{account_id}/coupon_redemptions/active", account_id: account_id)
-      get(path, **options)
+      pager(path, **options)
     end
 
-    # Generate an active coupon redemption on an account
+    # Generate an active coupon redemption on an account or subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_coupon_redemption create_coupon_redemption api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_coupon_redemption create_coupon_redemption api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::CouponRedemptionCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponRedemptionCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::CouponRedemption] Returns the new coupon redemption.
     # @example
@@ -642,10 +673,11 @@ module Recurly
 
     # Delete the active coupon redemption from an account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_coupon_redemption remove_coupon_redemption api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_coupon_redemption remove_coupon_redemption api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::CouponRedemption] Coupon redemption deleted.
     # @example
@@ -665,28 +697,32 @@ module Recurly
 
     # List an account's credit payments
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_credit_payments list_account_credit_payments api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_credit_payments list_account_credit_payments api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    # @param params [Hash] Optional query string parameters:
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CreditPayment>] A list of the account's credit payments.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   payments = @client.list_account_credit_payments(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   payments.each do |payment|
     #     puts "CreditPayment: #{payment.id}"
@@ -699,10 +735,11 @@ module Recurly
 
     # List an account's invoices
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_invoices list_account_invoices api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_invoices list_account_invoices api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -714,31 +751,34 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param type [String] Filter by type when:
+    #        :type [String] Filter by type when:
     #   - +type=charge+, only charge invoices will be returned.
     #   - +type=credit+, only credit invoices will be returned.
     #   - +type=non-legacy+, only charge and credit invoices will be returned.
     #   - +type=legacy+, only legacy invoices will be returned.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Invoice>] A list of the account's invoices.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   invoices = @client.list_account_invoices(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   invoices.each do |invoice|
     #     puts "Invoice: #{invoice.number}"
@@ -751,11 +791,12 @@ module Recurly
 
     # Create an invoice for pending line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_invoice create_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_invoice create_invoice api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::InvoiceCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::InvoiceCollection] Returns the new invoices.
     # @example
@@ -782,11 +823,12 @@ module Recurly
 
     # Preview new invoice for pending line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/preview_invoice preview_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/preview_invoice preview_invoice api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::InvoiceCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::InvoiceCollection] Returns the invoice previews.
     # @example
@@ -813,10 +855,11 @@ module Recurly
 
     # List an account's line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_line_items list_account_line_items api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_line_items list_account_line_items api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -828,28 +871,31 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param original [String] Filter by original field.
-    # @param state [String] Filter by state field.
-    # @param type [String] Filter by type field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :original [String] Filter by original field.
+    #        :state [String] Filter by state field.
+    #        :type [String] Filter by type field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::LineItem>] A list of the account's line items.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   line_items = @client.list_account_line_items(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   line_items.each do |line_item|
     #     puts "LineItem: #{line_item.id}"
@@ -862,11 +908,12 @@ module Recurly
 
     # Create a new line item for the account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_line_item create_line_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_line_item create_line_item api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::LineItemCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::LineItemCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::LineItem] Returns the new line item.
     # @example
@@ -894,10 +941,11 @@ module Recurly
 
     # Fetch a list of an account's notes
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_notes list_account_notes api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_notes list_account_notes api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -909,11 +957,14 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::AccountNote>] A list of an account's notes.
     # @example
-    #   account_notes = @client.list_account_notes(account_id: account_id, limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   account_notes = @client.list_account_notes(account_id: account_id, params: params)
     #   account_notes.each do |note|
     #     puts "AccountNote: #{note.message}"
     #   end
@@ -925,11 +976,12 @@ module Recurly
 
     # Fetch an account note
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_account_note get_account_note api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_account_note get_account_note api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param account_note_id [String] Account Note ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AccountNote] An account note.
     # @example
@@ -952,10 +1004,11 @@ module Recurly
 
     # Fetch a list of an account's shipping addresses
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_shipping_addresses list_shipping_addresses api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_shipping_addresses list_shipping_addresses api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -967,25 +1020,28 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::ShippingAddress>] A list of an account's shipping addresses.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   shipping_addresses = @client.list_shipping_addresses(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   shipping_addresses.each do |addr|
     #     puts "ShippingAddress: #{addr.nickname} - #{addr.street1}"
@@ -998,11 +1054,12 @@ module Recurly
 
     # Create a new shipping address for the account
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_shipping_address create_shipping_address api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_shipping_address create_shipping_address api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param body [Requests::ShippingAddressCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingAddressCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingAddress] Returns the new shipping address.
     # @example
@@ -1032,11 +1089,12 @@ module Recurly
 
     # Fetch an account's shipping address
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_shipping_address get_shipping_address api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_shipping_address get_shipping_address api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param shipping_address_id [String] Shipping Address ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingAddress] A shipping address.
     # @example
@@ -1059,12 +1117,13 @@ module Recurly
 
     # Update an account's shipping address
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_shipping_address update_shipping_address api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_shipping_address update_shipping_address api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param shipping_address_id [String] Shipping Address ID.
     # @param body [Requests::ShippingAddressUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingAddressUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingAddress] The updated shipping address.
     # @example
@@ -1093,11 +1152,12 @@ module Recurly
 
     # Remove an account's shipping address
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_shipping_address remove_shipping_address api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_shipping_address remove_shipping_address api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
     # @param shipping_address_id [String] Shipping Address ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Shipping address deleted.
     # @example
@@ -1120,10 +1180,11 @@ module Recurly
 
     # List an account's subscriptions
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_subscriptions list_account_subscriptions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_subscriptions list_account_subscriptions api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1135,31 +1196,34 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
+    #        :state [String] Filter by state.
     #
     #   - When +state=active+, +state=canceled+, +state=expired+, or +state=future+, subscriptions with states that match the query and only those subscriptions will be returned.
     #   - When +state=in_trial+, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned.
     #   - When +state=live+, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Subscription>] A list of the account's subscriptions.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   subscriptions = @client.list_account_subscriptions(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   subscriptions.each do |subscription|
     #     puts "Subscription: #{subscription.uuid}"
@@ -1172,10 +1236,11 @@ module Recurly
 
     # List an account's transactions
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_transactions list_account_transactions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_transactions list_account_transactions api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1187,27 +1252,30 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param type [String] Filter by type field. The value +payment+ will return both +purchase+ and +capture+ transactions.
-    # @param success [String] Filter by success field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :type [String] Filter by type field. The value +payment+ will return both +purchase+ and +capture+ transactions.
+    #        :success [String] Filter by success field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Transaction>] A list of the account's transactions.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   transactions = @client.list_account_transactions(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   transactions.each do |transaction|
     #     puts "Transaction: #{transaction.uuid}"
@@ -1220,10 +1288,11 @@ module Recurly
 
     # List an account's child accounts
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_child_accounts list_child_accounts api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_child_accounts list_child_accounts api documenation}
     #
     # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1235,30 +1304,33 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param email [String] Filter for accounts with this exact email address. A blank value will return accounts with both +null+ and +""+ email addresses. Note that multiple accounts can share one email address.
-    # @param subscriber [Boolean] Filter for accounts with or without a subscription in the +active+,
+    #        :email [String] Filter for accounts with this exact email address. A blank value will return accounts with both +null+ and +""+ email addresses. Note that multiple accounts can share one email address.
+    #        :subscriber [Boolean] Filter for accounts with or without a subscription in the +active+,
     #   +canceled+, or +future+ state.
     #
-    # @param past_due [String] Filter for accounts with an invoice in the +past_due+ state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :past_due [String] Filter for accounts with an invoice in the +past_due+ state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Account>] A list of an account's child accounts.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   child_accounts = @client.list_child_accounts(
     #     account_id: account_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   child_accounts.each do |child|
     #     puts "Account: #{child.code}"
@@ -1271,9 +1343,10 @@ module Recurly
 
     # List a site's account acquisition data
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_account_acquisition list_account_acquisition api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_acquisition list_account_acquisition api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1285,23 +1358,26 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::AccountAcquisition>] A list of the site's account acquisition data.
     # @example
-    #   acquisitions = @client.list_account_acquisition(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   acquisitions = @client.list_account_acquisition(params: params)
     #   acquisitions.each do |acquisition|
     #     puts "AccountAcquisition: #{acquisition.cost}"
     #   end
@@ -1313,9 +1389,10 @@ module Recurly
 
     # List a site's coupons
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_coupons list_coupons api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_coupons list_coupons api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1327,23 +1404,26 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Coupon>] A list of the site's coupons.
     # @example
-    #   coupons = @client.list_coupons(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   coupons = @client.list_coupons(params: params)
     #   coupons.each do |coupon|
     #     puts "coupon: #{coupon.code}"
     #   end
@@ -1355,10 +1435,11 @@ module Recurly
 
     # Create a new coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_coupon create_coupon api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_coupon create_coupon api documenation}
     #
     # @param body [Requests::CouponCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Coupon] A new coupon.
     # @example
@@ -1391,10 +1472,11 @@ module Recurly
 
     # Fetch a coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_coupon get_coupon api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_coupon get_coupon api documenation}
     #
     # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Coupon] A coupon.
     # @example
@@ -1414,11 +1496,12 @@ module Recurly
 
     # Update an active coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_coupon update_coupon api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_coupon update_coupon api documenation}
     #
     # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
     # @param body [Requests::CouponUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Coupon] The updated coupon.
     # @example
@@ -1441,10 +1524,11 @@ module Recurly
 
     # Expire a coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_coupon deactivate_coupon api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/deactivate_coupon deactivate_coupon api documenation}
     #
     # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Coupon] The expired Coupon
     # @example
@@ -1462,26 +1546,32 @@ module Recurly
       delete(path, **options)
     end
 
+    # Generate unique coupon codes
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/generate_unique_coupon_codes generate_unique_coupon_codes api documenation}
+    #
+    # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
+    # @param body [Requests::CouponBulkCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponBulkCreate}
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #
+    # @return [Resources::UniqueCouponCodeParams] A set of parameters that can be passed to the `list_unique_coupon_codes` endpoint to obtain only the newly generated `UniqueCouponCodes`.
+    #
+    def generate_unique_coupon_codes(coupon_id:, body:, **options)
+      path = interpolate_path("/coupons/{coupon_id}/generate", coupon_id: coupon_id)
+      post(path, body, Requests::CouponBulkCreate, **options)
+    end
+
     # Restore an inactive coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/restore_coupon restore_coupon api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/restore_coupon restore_coupon api documenation}
     #
     # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
     # @param body [Requests::CouponUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Coupon] The restored coupon.
-    # @example
-    #   begin
-    #     coupon = @client.restore_coupon(coupon_id: coupon_id, body: {
-    #       name: "New Coupon Name"
-    #     })
-    #     puts "Restored coupon #{coupon}"
-    #   rescue Recurly::Errors::NotFoundError
-    #     # If the resource was not found, you may want to alert the user or
-    #     # just return nil
-    #     puts "Resource Not Found"
-    #   end
     #
     def restore_coupon(coupon_id:, body:, **options)
       path = interpolate_path("/coupons/{coupon_id}/restore", coupon_id: coupon_id)
@@ -1490,10 +1580,11 @@ module Recurly
 
     # List unique coupon codes associated with a bulk coupon
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_unique_coupon_codes list_unique_coupon_codes api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_unique_coupon_codes list_unique_coupon_codes api documenation}
     #
     # @param coupon_id [String] Coupon ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-10off+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1505,19 +1596,19 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::UniqueCouponCode>] A list of unique coupon codes that were generated
     #
@@ -1528,25 +1619,29 @@ module Recurly
 
     # List a site's credit payments
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_credit_payments list_credit_payments api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_credit_payments list_credit_payments api documenation}
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    # @param params [Hash] Optional query string parameters:
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CreditPayment>] A list of the site's credit payments.
     # @example
-    #   payments = @client.list_credit_payments(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   payments = @client.list_credit_payments(params: params)
     #   payments.each do |payment|
     #     puts "CreditPayment: #{payment.id}"
     #   end
@@ -1558,10 +1653,11 @@ module Recurly
 
     # Fetch a credit payment
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_credit_payment get_credit_payment api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_credit_payment get_credit_payment api documenation}
     #
     # @param credit_payment_id [String] Credit Payment ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::CreditPayment] A credit payment.
     #
@@ -1572,9 +1668,10 @@ module Recurly
 
     # List a site's custom field definitions
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_custom_field_definitions list_custom_field_definitions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_custom_field_definitions list_custom_field_definitions api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1586,24 +1683,27 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param related_type [String] Filter by related type.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :related_type [String] Filter by related type.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CustomFieldDefinition>] A list of the site's custom field definitions.
     # @example
-    #   custom_fields = @client.list_custom_field_definitions(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   custom_fields = @client.list_custom_field_definitions(params: params)
     #   custom_fields.each do |field|
     #     puts "CustomFieldDefinition: #{field.name}"
     #   end
@@ -1615,10 +1715,11 @@ module Recurly
 
     # Fetch an custom field definition
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_custom_field_definition get_custom_field_definition api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_custom_field_definition get_custom_field_definition api documenation}
     #
     # @param custom_field_definition_id [String] Custom Field Definition ID
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::CustomFieldDefinition] An custom field definition.
     # @example
@@ -1640,9 +1741,10 @@ module Recurly
 
     # List a site's items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_items list_items api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_items list_items api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1654,24 +1756,27 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Item>] A list of the site's items.
     # @example
-    #   items = @client.list_items(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   items = @client.list_items(params: params)
     #   items.each do |item|
     #     puts "Item: #{item.code}"
     #   end
@@ -1683,10 +1788,11 @@ module Recurly
 
     # Create a new item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_item create_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_item create_item api documenation}
     #
     # @param body [Requests::ItemCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ItemCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Item] A new item.
     # @example
@@ -1718,10 +1824,11 @@ module Recurly
 
     # Fetch an item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_item get_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_item get_item api documenation}
     #
     # @param item_id [String] Item ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-red+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Item] An item.
     # @example
@@ -1741,11 +1848,12 @@ module Recurly
 
     # Update an active item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_item update_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_item update_item api documenation}
     #
     # @param item_id [String] Item ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-red+.
     # @param body [Requests::ItemUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ItemUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Item] The updated item.
     # @example
@@ -1772,10 +1880,11 @@ module Recurly
 
     # Deactivate an item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_item deactivate_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/deactivate_item deactivate_item api documenation}
     #
     # @param item_id [String] Item ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-red+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Item] An item.
     # @example
@@ -1795,10 +1904,11 @@ module Recurly
 
     # Reactivate an inactive item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/reactivate_item reactivate_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/reactivate_item reactivate_item api documenation}
     #
     # @param item_id [String] Item ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-red+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Item] An item.
     # @example
@@ -1818,9 +1928,10 @@ module Recurly
 
     # List a site's measured units
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_measured_unit list_measured_unit api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_measured_unit list_measured_unit api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1832,20 +1943,20 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::MeasuredUnit>] A list of the site's measured units.
     #
@@ -1856,10 +1967,11 @@ module Recurly
 
     # Create a new measured unit
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_measured_unit create_measured_unit api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_measured_unit create_measured_unit api documenation}
     #
     # @param body [Requests::MeasuredUnitCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::MeasuredUnitCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::MeasuredUnit] A new measured unit.
     #
@@ -1870,10 +1982,11 @@ module Recurly
 
     # Fetch a measured unit
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_measured_unit get_measured_unit api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_measured_unit get_measured_unit api documenation}
     #
     # @param measured_unit_id [String] Measured unit ID or name. For ID no prefix is used e.g. +e28zov4fw0v2+. For name use prefix +name-+, e.g. +name-Storage+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::MeasuredUnit] An item.
     #
@@ -1884,11 +1997,12 @@ module Recurly
 
     # Update a measured unit
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_measured_unit update_measured_unit api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_measured_unit update_measured_unit api documenation}
     #
     # @param measured_unit_id [String] Measured unit ID or name. For ID no prefix is used e.g. +e28zov4fw0v2+. For name use prefix +name-+, e.g. +name-Storage+.
     # @param body [Requests::MeasuredUnitUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::MeasuredUnitUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::MeasuredUnit] The updated measured_unit.
     #
@@ -1899,10 +2013,11 @@ module Recurly
 
     # Remove a measured unit
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_measured_unit remove_measured_unit api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_measured_unit remove_measured_unit api documenation}
     #
     # @param measured_unit_id [String] Measured unit ID or name. For ID no prefix is used e.g. +e28zov4fw0v2+. For name use prefix +name-+, e.g. +name-Storage+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::MeasuredUnit] A measured unit.
     #
@@ -1913,9 +2028,10 @@ module Recurly
 
     # List a site's invoices
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_invoices list_invoices api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_invoices list_invoices api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -1927,29 +2043,32 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param type [String] Filter by type when:
+    #        :type [String] Filter by type when:
     #   - +type=charge+, only charge invoices will be returned.
     #   - +type=credit+, only credit invoices will be returned.
     #   - +type=non-legacy+, only charge and credit invoices will be returned.
     #   - +type=legacy+, only legacy invoices will be returned.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Invoice>] A list of the site's invoices.
     # @example
-    #   invoices = @client.list_invoices(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   invoices = @client.list_invoices(params: params)
     #   invoices.each do |invoice|
     #     puts "Invoice: #{invoice.number}"
     #   end
@@ -1961,10 +2080,11 @@ module Recurly
 
     # Fetch an invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_invoice get_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_invoice get_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] An invoice.
     # @example
@@ -1984,11 +2104,12 @@ module Recurly
 
     # Update an invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/put_invoice put_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_invoice update_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param body [Requests::InvoiceUpdatable] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceUpdatable}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param body [Requests::InvoiceUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceUpdate}
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] An invoice.
     # @example
@@ -1997,7 +2118,7 @@ module Recurly
     #       customer_notes: "New Notes",
     #       terms_and_conditions: "New Terms and Conditions"
     #     }
-    #     invoice = @client.put_invoice(invoice_id: invoice_id, body: invoice_update)
+    #     invoice = @client.update_invoice(invoice_id: invoice_id, body: invoice_update)
     #     puts "Updated invoice #{invoice}"
     #   rescue Recurly::Errors::NotFoundError
     #     # If the resource was not found, you may want to alert the user or
@@ -2005,17 +2126,18 @@ module Recurly
     #     puts "Resource Not Found"
     #   end
     #
-    def put_invoice(invoice_id:, body:, **options)
+    def update_invoice(invoice_id:, body:, **options)
       path = interpolate_path("/invoices/{invoice_id}", invoice_id: invoice_id)
-      put(path, body, Requests::InvoiceUpdatable, **options)
+      put(path, body, Requests::InvoiceUpdate, **options)
     end
 
     # Fetch an invoice as a PDF
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_invoice_pdf get_invoice_pdf api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_invoice_pdf get_invoice_pdf api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::BinaryFile] An invoice as a PDF.
     # @example
@@ -2038,11 +2160,12 @@ module Recurly
 
     # Collect a pending or past due, automatic invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/collect_invoice collect_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/collect_invoice collect_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param body [Requests::InvoiceCollect] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCollect}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :body [Requests::InvoiceCollect] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCollect}
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] The updated invoice.
     # @example
@@ -2062,15 +2185,16 @@ module Recurly
 
     # Mark an open invoice as failed
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/fail_invoice fail_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/mark_invoice_failed mark_invoice_failed api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] The updated invoice.
     # @example
     #   begin
-    #     invoice = @client.fail_invoice(invoice_id: invoice_id)
+    #     invoice = @client.mark_invoice_failed(invoice_id: invoice_id)
     #     puts "Failed invoice #{invoice}"
     #   rescue Recurly::Errors::NotFoundError
     #     # If the resource was not found, you may want to alert the user or
@@ -2078,17 +2202,18 @@ module Recurly
     #     puts "Resource Not Found"
     #   end
     #
-    def fail_invoice(invoice_id:, **options)
+    def mark_invoice_failed(invoice_id:, **options)
       path = interpolate_path("/invoices/{invoice_id}/mark_failed", invoice_id: invoice_id)
       put(path, **options)
     end
 
     # Mark an open invoice as successful
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/mark_invoice_successful mark_invoice_successful api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/mark_invoice_successful mark_invoice_successful api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] The updated invoice.
     # @example
@@ -2108,10 +2233,11 @@ module Recurly
 
     # Reopen a closed, manual invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/reopen_invoice reopen_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/reopen_invoice reopen_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] The updated invoice.
     # @example
@@ -2131,10 +2257,11 @@ module Recurly
 
     # Void a credit invoice.
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/void_invoice void_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/void_invoice void_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] The updated invoice.
     # @example
@@ -2154,11 +2281,12 @@ module Recurly
 
     # Record an external payment for a manual invoices.
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/record_external_transaction record_external_transaction api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/record_external_transaction record_external_transaction api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
     # @param body [Requests::ExternalTransaction] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ExternalTransaction}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Transaction] The recorded transaction.
     #
@@ -2169,10 +2297,11 @@ module Recurly
 
     # List an invoice's line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_invoice_line_items list_invoice_line_items api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_invoice_line_items list_invoice_line_items api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2184,28 +2313,31 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param original [String] Filter by original field.
-    # @param state [String] Filter by state field.
-    # @param type [String] Filter by type field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :original [String] Filter by original field.
+    #        :state [String] Filter by state field.
+    #        :type [String] Filter by type field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::LineItem>] A list of the invoice's line items.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   line_items = @client.list_invoice_line_items(
     #     invoice_id: invoice_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   line_items.each do |line_item|
     #     puts "Line Item: #{line_item.id}"
@@ -2218,10 +2350,11 @@ module Recurly
 
     # Show the coupon redemptions applied to an invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_invoice_coupon_redemptions list_invoice_coupon_redemptions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_invoice_coupon_redemptions list_invoice_coupon_redemptions api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2233,23 +2366,26 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CouponRedemption>] A list of the the coupon redemptions associated with the invoice.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   coupon_redemptions = @client.list_invoice_coupon_redemptions(
     #     invoice_id: invoice_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   coupon_redemptions.each do |redemption|
     #     puts "CouponRedemption: #{redemption.id}"
@@ -2262,16 +2398,20 @@ module Recurly
 
     # List an invoice's related credit or charge invoices
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_related_invoices list_related_invoices api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_related_invoices list_related_invoices api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Invoice>] A list of the credit or charge invoices associated with the invoice.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   invoices = @client.list_related_invoices(
     #     invoice_id: invoice_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   invoices.each do |invoice|
     #     puts "Invoice: #{invoice.number}"
@@ -2284,11 +2424,12 @@ module Recurly
 
     # Refund an invoice
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/refund_invoice refund_invoice api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/refund_invoice refund_invoice api documenation}
     #
     # @param invoice_id [String] Invoice ID or number. For ID no prefix is used e.g. +e28zov4fw0v2+. For number use prefix +number-+, e.g. +number-1000+.
     # @param body [Requests::InvoiceRefund] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceRefund}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Invoice] Returns the new credit invoice.
     # @example
@@ -2315,9 +2456,10 @@ module Recurly
 
     # List a site's line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_line_items list_line_items api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_line_items list_line_items api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2329,27 +2471,30 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param original [String] Filter by original field.
-    # @param state [String] Filter by state field.
-    # @param type [String] Filter by type field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :original [String] Filter by original field.
+    #        :state [String] Filter by state field.
+    #        :type [String] Filter by type field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::LineItem>] A list of the site's line items.
     # @example
-    #   line_items = @client.list_line_items(
+    #   params = {
     #     limit: 200
+    #   }
+    #   line_items = @client.list_line_items(
+    #     params: params
     #   )
     #   line_items.each do |line_item|
     #     puts "LineItem: #{line_item.id}"
@@ -2362,10 +2507,11 @@ module Recurly
 
     # Fetch a line item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_line_item get_line_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_line_item get_line_item api documenation}
     #
     # @param line_item_id [String] Line Item ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::LineItem] A line item.
     # @example
@@ -2385,10 +2531,11 @@ module Recurly
 
     # Delete an uninvoiced line item
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_line_item remove_line_item api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_line_item remove_line_item api documenation}
     #
     # @param line_item_id [String] Line Item ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Line item deleted.
     # @example
@@ -2410,9 +2557,10 @@ module Recurly
 
     # List a site's plans
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_plans list_plans api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_plans list_plans api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2424,24 +2572,27 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Plan>] A list of plans.
     # @example
-    #   plans = @client.list_plans(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   plans = @client.list_plans(params: params)
     #   plans.each do |plan|
     #     puts "Plan: #{plan.code}"
     #   end
@@ -2453,10 +2604,11 @@ module Recurly
 
     # Create a plan
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_plan create_plan api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_plan create_plan api documenation}
     #
     # @param body [Requests::PlanCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::PlanCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Plan] A plan.
     # @example
@@ -2493,10 +2645,11 @@ module Recurly
 
     # Fetch a plan
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_plan get_plan api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_plan get_plan api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Plan] A plan.
     # @example
@@ -2516,11 +2669,12 @@ module Recurly
 
     # Update a plan
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_plan update_plan api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_plan update_plan api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param body [Requests::PlanUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::PlanUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Plan] A plan.
     # @example
@@ -2543,10 +2697,11 @@ module Recurly
 
     # Remove a plan
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_plan remove_plan api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_plan remove_plan api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Plan] Plan deleted
     # @example
@@ -2566,10 +2721,11 @@ module Recurly
 
     # List a plan's add-ons
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_plan_add_ons list_plan_add_ons api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_plan_add_ons list_plan_add_ons api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2581,26 +2737,29 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::AddOn>] A list of add-ons.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   add_ons = @client.list_plan_add_ons(
     #     plan_id: plan_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   add_ons.each do |add_on|
     #     puts "AddOn: #{add_on.code}"
@@ -2613,11 +2772,12 @@ module Recurly
 
     # Create an add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_plan_add_on create_plan_add_on api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_plan_add_on create_plan_add_on api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param body [Requests::AddOnCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AddOnCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AddOn] An add-on.
     # @example
@@ -2648,11 +2808,12 @@ module Recurly
 
     # Fetch a plan's add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_plan_add_on get_plan_add_on api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_plan_add_on get_plan_add_on api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AddOn] An add-on.
     # @example
@@ -2674,12 +2835,13 @@ module Recurly
 
     # Update an add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_plan_add_on update_plan_add_on api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_plan_add_on update_plan_add_on api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param body [Requests::AddOnUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AddOnUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AddOn] An add-on.
     # @example
@@ -2706,11 +2868,12 @@ module Recurly
 
     # Remove an add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_plan_add_on remove_plan_add_on api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_plan_add_on remove_plan_add_on api documenation}
     #
     # @param plan_id [String] Plan ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AddOn] Add-on deleted
     # @example
@@ -2733,9 +2896,10 @@ module Recurly
 
     # List a site's add-ons
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_add_ons list_add_ons api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_add_ons list_add_ons api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2747,25 +2911,28 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :state [String] Filter by state.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::AddOn>] A list of add-ons.
     # @example
-    #   add_ons = @client.list_add_ons(
+    #   params = {
     #     limit: 200
+    #   }
+    #   add_ons = @client.list_add_ons(
+    #     params: params
     #   )
     #   add_ons.each do |add_on|
     #     puts "AddOn: #{add_on.code}"
@@ -2778,10 +2945,11 @@ module Recurly
 
     # Fetch an add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_add_on get_add_on api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_add_on get_add_on api documenation}
     #
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::AddOn] An add-on.
     # @example
@@ -2801,9 +2969,10 @@ module Recurly
 
     # List a site's shipping methods
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_shipping_methods list_shipping_methods api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_shipping_methods list_shipping_methods api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2815,24 +2984,27 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::ShippingMethod>] A list of the site's shipping methods.
     # @example
-    #   shipping_methods = @client.list_shipping_methods(
+    #   params = {
     #     limit: 200
+    #   }
+    #   shipping_methods = @client.list_shipping_methods(
+    #     params: params
     #   )
     #   shipping_methods.each do |shipping_method|
     #     puts "Shipping Method: #{shipping_method.code}"
@@ -2845,10 +3017,11 @@ module Recurly
 
     # Create a new shipping method
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_shipping_method create_shipping_method api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_shipping_method create_shipping_method api documenation}
     #
     # @param body [Requests::ShippingMethodCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingMethodCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingMethod] A new shipping method.
     #
@@ -2859,25 +3032,27 @@ module Recurly
 
     # Fetch a shipping method
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_shipping_method get_shipping_method api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_shipping_method get_shipping_method api documenation}
     #
-    # @param id [String] Shipping Method ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-usps_2-day+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param shipping_method_id [String] Shipping Method ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-usps_2-day+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingMethod] A shipping method.
     #
-    def get_shipping_method(id:, **options)
-      path = interpolate_path("/shipping_methods/{id}", id: id)
+    def get_shipping_method(shipping_method_id:, **options)
+      path = interpolate_path("/shipping_methods/{shipping_method_id}", shipping_method_id: shipping_method_id)
       get(path, **options)
     end
 
     # Update an active Shipping Method
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_shipping_method update_shipping_method api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_shipping_method update_shipping_method api documenation}
     #
     # @param shipping_method_id [String] Shipping Method ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-usps_2-day+.
     # @param body [Requests::ShippingMethodUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingMethodUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingMethod] The updated shipping method.
     #
@@ -2888,10 +3063,11 @@ module Recurly
 
     # Deactivate a shipping method
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_shipping_method deactivate_shipping_method api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/deactivate_shipping_method deactivate_shipping_method api documenation}
     #
     # @param shipping_method_id [String] Shipping Method ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-usps_2-day+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ShippingMethod] A shipping method.
     #
@@ -2902,9 +3078,10 @@ module Recurly
 
     # List a site's subscriptions
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_subscriptions list_subscriptions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_subscriptions list_subscriptions api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -2916,29 +3093,32 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param state [String] Filter by state.
+    #        :state [String] Filter by state.
     #
     #   - When +state=active+, +state=canceled+, +state=expired+, or +state=future+, subscriptions with states that match the query and only those subscriptions will be returned.
     #   - When +state=in_trial+, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned.
     #   - When +state=live+, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Subscription>] A list of the site's subscriptions.
     # @example
-    #   subscriptions = @client.list_subscriptions(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   subscriptions = @client.list_subscriptions(params: params)
     #   subscriptions.each do |subscription|
     #     puts "Subscription: #{subscription.uuid}"
     #   end
@@ -2950,10 +3130,11 @@ module Recurly
 
     # Create a new subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_subscription create_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_subscription create_subscription api documenation}
     #
     # @param body [Requests::SubscriptionCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     # @example
@@ -2961,8 +3142,7 @@ module Recurly
     #     subscription_create = {
     #       plan_code: plan_code,
     #       currency: "USD",
-    #       # This can be an existing account or
-    #       # a new acocunt
+    #       # This can be an existing account or a new account
     #       account: {
     #         code: account_code,
     #       }
@@ -2984,10 +3164,11 @@ module Recurly
 
     # Fetch a subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_subscription get_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_subscription get_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     # @example
@@ -3007,13 +3188,14 @@ module Recurly
       get(path, **options)
     end
 
-    # Modify a subscription
+    # Update a subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/modify_subscription modify_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_subscription update_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param body [Requests::SubscriptionUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionUpdate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     # @example
@@ -3022,7 +3204,7 @@ module Recurly
     #       customer_notes: "New Notes",
     #       terms_and_conditions: "New ToC"
     #     }
-    #     subscription = @client.modify_subscription(
+    #     subscription = @client.update_subscription(
     #       subscription_id: subscription_id,
     #       body: subscription_update
     #     )
@@ -3033,17 +3215,18 @@ module Recurly
     #     puts "ValidationError: #{e.recurly_error.params}"
     #   end
     #
-    def modify_subscription(subscription_id:, body:, **options)
+    def update_subscription(subscription_id:, body:, **options)
       path = interpolate_path("/subscriptions/{subscription_id}", subscription_id: subscription_id)
       put(path, body, Requests::SubscriptionUpdate, **options)
     end
 
     # Terminate a subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/terminate_subscription terminate_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/terminate_subscription terminate_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param refund [String] The type of refund to perform:
+    # @param params [Hash] Optional query string parameters:
+    #        :refund [String] The type of refund to perform:
     #
     #   * +full+ - Performs a full refund of the last invoice for the current subscription term.
     #   * +partial+ - Prorates a refund based on the amount of time remaining in the current bill cycle.
@@ -3053,8 +3236,8 @@ module Recurly
     #
     #   You may also terminate a subscription with no refund and then manually refund specific invoices.
     #
-    # @param charge [Boolean] Applicable only if the subscription has usage based add-ons and unbilled usage logged for the current billing cycle. If true, current billing cycle unbilled usage is billed on the final invoice. If false, Recurly will create a negative usage record for current billing cycle usage that will zero out the final invoice line items.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :charge [Boolean] Applicable only if the subscription has usage based add-ons and unbilled usage logged for the current billing cycle. If true, current billing cycle unbilled usage is billed on the final invoice. If false, Recurly will create a negative usage record for current billing cycle usage that will zero out the final invoice line items.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] An expired subscription.
     # @example
@@ -3076,11 +3259,12 @@ module Recurly
 
     # Cancel a subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/cancel_subscription cancel_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/cancel_subscription cancel_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param body [Requests::SubscriptionCancel] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionCancel}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :body [Requests::SubscriptionCancel] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionCancel}
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A canceled or failed subscription.
     # @example
@@ -3102,10 +3286,11 @@ module Recurly
 
     # Reactivate a canceled subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/reactivate_subscription reactivate_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/reactivate_subscription reactivate_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] An active subscription.
     # @example
@@ -3127,11 +3312,12 @@ module Recurly
 
     # Pause subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/pause_subscription pause_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/pause_subscription pause_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param body [Requests::SubscriptionPause] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionPause}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     # @example
@@ -3157,10 +3343,11 @@ module Recurly
 
     # Resume subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/resume_subscription resume_subscription api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/resume_subscription resume_subscription api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     # @example
@@ -3182,10 +3369,11 @@ module Recurly
 
     # Convert trial subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/convert_trial convert_trial api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/convert_trial convert_trial api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Subscription] A subscription.
     #
@@ -3196,10 +3384,11 @@ module Recurly
 
     # Fetch a subscription's pending change
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_subscription_change get_subscription_change api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_subscription_change get_subscription_change api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::SubscriptionChange] A subscription's pending change.
     # @example
@@ -3221,11 +3410,12 @@ module Recurly
 
     # Create a new subscription change
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_subscription_change create_subscription_change api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_subscription_change create_subscription_change api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param body [Requests::SubscriptionChangeCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionChangeCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::SubscriptionChange] A subscription change.
     # @example
@@ -3252,10 +3442,11 @@ module Recurly
 
     # Delete the pending subscription change
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_subscription_change remove_subscription_change api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_subscription_change remove_subscription_change api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Subscription change was deleted.
     # @example
@@ -3277,13 +3468,14 @@ module Recurly
 
     # Preview a new subscription change
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/preview_subscription_change preview_subscription_change api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/preview_subscription_change preview_subscription_change api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param body [Requests::SubscriptionChangeCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionChangeCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
-    # @return [Resources::SubscriptionChangePreview] A subscription change.
+    # @return [Resources::SubscriptionChange] A subscription change.
     #
     def preview_subscription_change(subscription_id:, body:, **options)
       path = interpolate_path("/subscriptions/{subscription_id}/change/preview", subscription_id: subscription_id)
@@ -3292,10 +3484,11 @@ module Recurly
 
     # List a subscription's invoices
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_subscription_invoices list_subscription_invoices api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_subscription_invoices list_subscription_invoices api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -3307,31 +3500,34 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param type [String] Filter by type when:
+    #        :type [String] Filter by type when:
     #   - +type=charge+, only charge invoices will be returned.
     #   - +type=credit+, only credit invoices will be returned.
     #   - +type=non-legacy+, only charge and credit invoices will be returned.
     #   - +type=legacy+, only legacy invoices will be returned.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Invoice>] A list of the subscription's invoices.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   invoices = @client.list_subscription_invoices(
     #     subscription_id: subscription_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   invoices.each do |invoice|
     #     puts "Invoice: #{invoice.number}"
@@ -3344,10 +3540,11 @@ module Recurly
 
     # List a subscription's line items
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_subscription_line_items list_subscription_line_items api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_subscription_line_items list_subscription_line_items api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -3359,28 +3556,31 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param original [String] Filter by original field.
-    # @param state [String] Filter by state field.
-    # @param type [String] Filter by type field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :original [String] Filter by original field.
+    #        :state [String] Filter by state field.
+    #        :type [String] Filter by type field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::LineItem>] A list of the subscription's line items.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   line_items = @client.list_subscription_line_items(
     #     subscription_id: subscription_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   line_items.each do |line_item|
     #     puts "LineItem: #{line_item.id}"
@@ -3393,10 +3593,11 @@ module Recurly
 
     # Show the coupon redemptions for a subscription
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_subscription_coupon_redemptions list_subscription_coupon_redemptions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_subscription_coupon_redemptions list_subscription_coupon_redemptions api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -3408,23 +3609,26 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::CouponRedemption>] A list of the the coupon redemptions on a subscription.
     # @example
+    #   params = {
+    #     limit: 200
+    #   }
     #   coupon_redemptions = @client.list_subscription_coupon_redemptions(
     #     subscription_id: subscription_id,
-    #     limit: 200
+    #     params: params
     #   )
     #   coupon_redemptions.each do |redemption|
     #     puts "CouponRedemption: #{redemption.id}"
@@ -3437,11 +3641,12 @@ module Recurly
 
     # List a subscription add-on's usage records
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_usage list_usage api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_usage list_usage api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -3453,20 +3658,20 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +usage_timestamp+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +usage_timestamp+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=usage_timestamp+ or +sort=recorded_timestamp+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=usage_timestamp+ or +sort=recorded_timestamp+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=usage_timestamp+ or +sort=recorded_timestamp+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=usage_timestamp+ or +sort=recorded_timestamp+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param billing_status [String] Filter by usage record's billing status
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :billing_status [String] Filter by usage record's billing status
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Usage>] A list of the subscription add-on's usage records.
     #
@@ -3477,12 +3682,13 @@ module Recurly
 
     # Log a usage record on this subscription add-on
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_usage create_usage api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_usage create_usage api documenation}
     #
     # @param subscription_id [String] Subscription ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
     # @param add_on_id [String] Add-on ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-gold+.
     # @param body [Requests::UsageCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::UsageCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Usage] The created usage record.
     #
@@ -3493,10 +3699,11 @@ module Recurly
 
     # Get a usage record
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_usage get_usage api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_usage get_usage api documenation}
     #
     # @param usage_id [String] Usage Record ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Usage] The usage record.
     #
@@ -3507,11 +3714,12 @@ module Recurly
 
     # Update a usage record
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/update_usage update_usage api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_usage update_usage api documenation}
     #
     # @param usage_id [String] Usage Record ID.
     # @param body [Requests::UsageCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::UsageCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Usage] The updated usage record.
     #
@@ -3522,10 +3730,11 @@ module Recurly
 
     # Delete a usage record.
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/remove_usage remove_usage api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/remove_usage remove_usage api documenation}
     #
     # @param usage_id [String] Usage Record ID.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Empty] Usage was successfully deleted.
     #
@@ -3536,9 +3745,10 @@ module Recurly
 
     # List a site's transactions
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/list_transactions list_transactions api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_transactions list_transactions api documenation}
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    # @param params [Hash] Optional query string parameters:
+    #        :ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
     #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6+.
     #
     #   *Important notes:*
@@ -3550,25 +3760,28 @@ module Recurly
     #   * Records are returned in an arbitrary order. Since results are all
     #     returned at once you can sort the records yourself.
     #
-    # @param limit [Integer] Limit number of records 1-200.
-    # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #        :limit [Integer] Limit number of records 1-200.
+    #        :order [String] Sort order.
+    #        :sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
     #   order. In descending order updated records will move behind the cursor and could
     #   prevent some records from being returned.
     #
-    # @param begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #        :begin_time [DateTime] Inclusively filter by begin_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #        :end_time [DateTime] Inclusively filter by end_time when +sort=created_at+ or +sort=updated_at+.
     #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
     #
-    # @param type [String] Filter by type field. The value +payment+ will return both +purchase+ and +capture+ transactions.
-    # @param success [String] Filter by success field.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    #        :type [String] Filter by type field. The value +payment+ will return both +purchase+ and +capture+ transactions.
+    #        :success [String] Filter by success field.
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Pager<Resources::Transaction>] A list of the site's transactions.
     # @example
-    #   transactions = @client.list_transactions(limit: 200)
+    #   params = {
+    #     limit: 200
+    #   }
+    #   transactions = @client.list_transactions(params: params)
     #   transactions.each do |transaction|
     #     puts "Transaction: #{transaction.uuid}"
     #   end
@@ -3580,10 +3793,11 @@ module Recurly
 
     # Fetch a transaction
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_transaction get_transaction api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_transaction get_transaction api documenation}
     #
     # @param transaction_id [String] Transaction ID or UUID. For ID no prefix is used e.g. +e28zov4fw0v2+. For UUID use prefix +uuid-+, e.g. +uuid-123457890+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::Transaction] A transaction.
     # @example
@@ -3603,10 +3817,11 @@ module Recurly
 
     # Fetch a unique coupon code
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_unique_coupon_code get_unique_coupon_code api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_unique_coupon_code get_unique_coupon_code api documenation}
     #
     # @param unique_coupon_code_id [String] Unique Coupon Code ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-abc-8dh2-def+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     #
@@ -3617,10 +3832,11 @@ module Recurly
 
     # Deactivate a unique coupon code
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/deactivate_unique_coupon_code deactivate_unique_coupon_code api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/deactivate_unique_coupon_code deactivate_unique_coupon_code api documenation}
     #
     # @param unique_coupon_code_id [String] Unique Coupon Code ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-abc-8dh2-def+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     #
@@ -3631,10 +3847,11 @@ module Recurly
 
     # Restore a unique coupon code
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/reactivate_unique_coupon_code reactivate_unique_coupon_code api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/reactivate_unique_coupon_code reactivate_unique_coupon_code api documenation}
     #
     # @param unique_coupon_code_id [String] Unique Coupon Code ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-abc-8dh2-def+.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     #
@@ -3645,10 +3862,11 @@ module Recurly
 
     # Create a new purchase
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/create_purchase create_purchase api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_purchase create_purchase api documenation}
     #
     # @param body [Requests::PurchaseCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::PurchaseCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::InvoiceCollection] Returns the new invoices
     # @example
@@ -3685,10 +3903,11 @@ module Recurly
 
     # Preview a new purchase
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/preview_purchase preview_purchase api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/preview_purchase preview_purchase api documenation}
     #
     # @param body [Requests::PurchaseCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::PurchaseCreate}
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::InvoiceCollection] Returns preview of the new invoices
     # @example
@@ -3725,9 +3944,10 @@ module Recurly
 
     # List the dates that have an available export to download.
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_export_dates get_export_dates api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_export_dates get_export_dates api documenation}
     #
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ExportDates] Returns a list of dates.
     # @example
@@ -3749,10 +3969,11 @@ module Recurly
 
     # List of the export files that are available to download.
     #
-    # {https://developers.recurly.com/api/v2019-10-10#operation/get_export_files get_export_files api documenation}
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_export_files get_export_files api documenation}
     #
     # @param export_date [String] Date for which to get a list of available automated export files. Date must be in YYYY-MM-DD format.
-    # @param site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
+    # @param params [Hash] Optional query string parameters:
+    #        :site_id [String] Site ID or subdomain. For ID no prefix is used e.g. +e28zov4fw0v2+. For subdomain use prefix +subdomain-+, e.g. +subdomain-recurly+.
     #
     # @return [Resources::ExportFiles] Returns a list of export files to download.
     # @example