recurly 3.8.0 → 3.13.0

data/lib/recurly/resources/add_on.rb

@@ -10,6 +10,18 @@ module Recurly
       #   @return [String] Accounting code for invoice line items for this add-on. If no value is provided, it defaults to add-on's code.
       define_attribute :accounting_code, String
 
+      # @!attribute add_on_type
+      #   @return [String] Whether the add-on type is fixed, or usage-based.
+      define_attribute :add_on_type, String
+
+      # @!attribute avalara_service_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the add-on is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_service_type, Integer
+
+      # @!attribute avalara_transaction_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the add-on is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_transaction_type, Integer
+
       # @!attribute code
       #   @return [String] The unique identifier for the add-on within its plan.
       define_attribute :code, String
@@ -46,6 +58,10 @@ module Recurly
       #   @return [ItemMini] Just the important parts.
       define_attribute :item, :ItemMini
 
+      # @!attribute measured_unit_id
+      #   @return [String] System-generated unique identifier for an measured unit associated with the add-on.
+      define_attribute :measured_unit_id, String
+
       # @!attribute name
       #   @return [String] Describes your add-on and will appear in subscribers' invoices.
       define_attribute :name, String
@@ -85,6 +101,14 @@ module Recurly
       # @!attribute updated_at
       #   @return [DateTime] Last updated at
       define_attribute :updated_at, DateTime
+
+      # @!attribute usage_percentage
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0.
+      define_attribute :usage_percentage, Float
+
+      # @!attribute usage_type
+      #   @return [String] Type of usage, returns usage type if `add_on_type` is `usage`.
+      define_attribute :usage_type, String
     end
   end
 end

data/lib/recurly/resources/add_on_mini.rb

@@ -10,6 +10,10 @@ module Recurly
       #   @return [String] Accounting code for invoice line items for this add-on. If no value is provided, it defaults to add-on's code.
       define_attribute :accounting_code, String
 
+      # @!attribute add_on_type
+      #   @return [String] Whether the add-on type is fixed, or usage-based.
+      define_attribute :add_on_type, String
+
       # @!attribute code
       #   @return [String] The unique identifier for the add-on within its plan.
       define_attribute :code, String
@@ -26,6 +30,10 @@ module Recurly
       #   @return [String] Item ID
       define_attribute :item_id, String
 
+      # @!attribute measured_unit_id
+      #   @return [String] System-generated unique identifier for an measured unit associated with the add-on.
+      define_attribute :measured_unit_id, String
+
       # @!attribute name
       #   @return [String] Describes your add-on and will appear in subscribers' invoices.
       define_attribute :name, String
@@ -33,6 +41,14 @@ module Recurly
       # @!attribute object
       #   @return [String] Object type
       define_attribute :object, String
+
+      # @!attribute usage_percentage
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0.
+      define_attribute :usage_percentage, Float
+
+      # @!attribute usage_type
+      #   @return [String] Type of usage, returns usage type if `add_on_type` is `usage`.
+      define_attribute :usage_type, String
     end
   end
 end

data/lib/recurly/resources/coupon.rb

@@ -14,6 +14,14 @@ module Recurly
       #   @return [Boolean] The coupon is valid for one-time, non-plan charges if true.
       define_attribute :applies_to_non_plan_charges, :Boolean
 
+      # @!attribute bulk_coupon_code
+      #   @return [String] The Coupon code of the parent Bulk Coupon
+      define_attribute :bulk_coupon_code, String
+
+      # @!attribute bulk_coupon_id
+      #   @return [String] The Coupon ID of the parent Bulk Coupon
+      define_attribute :bulk_coupon_id, String
+
       # @!attribute code
       #   @return [String] The code the customer enters to redeem the coupon.
       define_attribute :code, String
@@ -79,7 +87,7 @@ module Recurly
       define_attribute :plans, Array, { :item_type => :PlanMini }
 
       # @!attribute plans_names
-      #   @return [Array[String]] TODO
+      #   @return [Array[String]] A list of plan names for which this coupon applies.
       define_attribute :plans_names, Array, { :item_type => String }
 
       # @!attribute redeem_by

data/lib/recurly/resources/export_dates.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class ExportDates < Resource
+
+      # @!attribute dates
+      #   @return [Array[String]] An array of dates that have available exports.
+      define_attribute :dates, Array, { :item_type => String }
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/resources/export_file.rb

@@ -0,0 +1,22 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class ExportFile < Resource
+
+      # @!attribute href
+      #   @return [String] A presigned link to download the export file.
+      define_attribute :href, String
+
+      # @!attribute md5sum
+      #   @return [String] MD5 hash of the export file.
+      define_attribute :md5sum, String
+
+      # @!attribute name
+      #   @return [String] Name of the export file.
+      define_attribute :name, String
+    end
+  end
+end

data/lib/recurly/resources/export_files.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class ExportFiles < Resource
+
+      # @!attribute files
+      #   @return [Array[ExportFile]]
+      define_attribute :files, Array, { :item_type => :ExportFile }
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/resources/item.rb

@@ -10,6 +10,14 @@ module Recurly
       #   @return [String] Accounting code for invoice line items.
       define_attribute :accounting_code, String
 
+      # @!attribute avalara_service_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the item is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_service_type, Integer
+
+      # @!attribute avalara_transaction_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the item is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_transaction_type, Integer
+
       # @!attribute code
       #   @return [String] Unique code to identify the item.
       define_attribute :code, String

data/lib/recurly/resources/line_item.rb

@@ -26,6 +26,14 @@ module Recurly
       #   @return [Float] `(quantity * unit_amount) - (discount + tax)`
       define_attribute :amount, Float
 
+      # @!attribute avalara_service_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the line item is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_service_type, Integer
+
+      # @!attribute avalara_transaction_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the line item is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_transaction_type, Integer
+
       # @!attribute created_at
       #   @return [DateTime] When the line item was created.
       define_attribute :created_at, DateTime

data/lib/recurly/resources/measured_unit.rb

@@ -0,0 +1,46 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class MeasuredUnit < Resource
+
+      # @!attribute created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime
+
+      # @!attribute deleted_at
+      #   @return [DateTime] Deleted at
+      define_attribute :deleted_at, DateTime
+
+      # @!attribute description
+      #   @return [String] Optional internal description.
+      define_attribute :description, String
+
+      # @!attribute display_name
+      #   @return [String] Display name for the measured unit. Can only contain spaces, underscores and must be alphanumeric.
+      define_attribute :display_name, String
+
+      # @!attribute id
+      #   @return [String] Item ID
+      define_attribute :id, String
+
+      # @!attribute name
+      #   @return [String] Unique internal name of the measured unit on your site.
+      define_attribute :name, String
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+
+      # @!attribute state
+      #   @return [String] The current state of the measured unit.
+      define_attribute :state, String
+
+      # @!attribute updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime
+    end
+  end
+end

data/lib/recurly/resources/plan.rb

@@ -18,6 +18,14 @@ module Recurly
       #   @return [Boolean] Subscriptions will automatically inherit this value once they are active. If `auto_renew` is `true`, then a subscription will automatically renew its term at renewal. If `auto_renew` is `false`, then a subscription will expire at the end of its term. `auto_renew` can be overridden on the subscription record itself.
       define_attribute :auto_renew, :Boolean
 
+      # @!attribute avalara_service_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the plan is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_service_type, Integer
+
+      # @!attribute avalara_transaction_type
+      #   @return [Integer] Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the plan is taxed. Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.
+      define_attribute :avalara_transaction_type, Integer
+
       # @!attribute code
       #   @return [String] Unique code to identify the plan. This is used in Hosted Payment Page URLs and in the invoice exports.
       define_attribute :code, String

data/lib/recurly/resources/subscription_add_on.rb

@@ -47,7 +47,7 @@ module Recurly
       define_attribute :tier_type, String
 
       # @!attribute tiers
-      #   @return [Array[SubscriptionAddOnTier]] Empty unless `tier_type` is `tiered`, `volume`, or `stairstep`.
+      #   @return [Array[SubscriptionAddOnTier]] If tiers are provided in the request, all existing tiers on the Subscription Add-on will be removed and replaced by the tiers in the request.
       define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
 
       # @!attribute unit_amount
@@ -57,6 +57,10 @@ module Recurly
       # @!attribute updated_at
       #   @return [DateTime] Updated at
       define_attribute :updated_at, DateTime
+
+      # @!attribute usage_percentage
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0. Required if add_on_type is usage and usage_type is percentage.
+      define_attribute :usage_percentage, Float
     end
   end
 end

data/lib/recurly/resources/subscription_change.rb

@@ -22,6 +22,10 @@ module Recurly
       #   @return [DateTime] Created at
       define_attribute :created_at, DateTime
 
+      # @!attribute custom_fields
+      #   @return [Array[CustomField]] The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.
+      define_attribute :custom_fields, Array, { :item_type => :CustomField }
+
       # @!attribute deleted_at
       #   @return [DateTime] Deleted at
       define_attribute :deleted_at, DateTime
@@ -30,6 +34,10 @@ module Recurly
       #   @return [String] The ID of the Subscription Change.
       define_attribute :id, String
 
+      # @!attribute invoice_collection
+      #   @return [InvoiceCollection] Invoice Collection
+      define_attribute :invoice_collection, :InvoiceCollection
+
       # @!attribute object
       #   @return [String] Object type
       define_attribute :object, String

data/lib/recurly/resources/subscription_change_preview.rb

@@ -22,6 +22,10 @@ module Recurly
       #   @return [DateTime] Created at
       define_attribute :created_at, DateTime
 
+      # @!attribute custom_fields
+      #   @return [Array[CustomField]] The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.
+      define_attribute :custom_fields, Array, { :item_type => :CustomField }
+
       # @!attribute deleted_at
       #   @return [DateTime] Deleted at
       define_attribute :deleted_at, DateTime
@@ -31,7 +35,7 @@ module Recurly
       define_attribute :id, String
 
       # @!attribute invoice_collection
-      #   @return [InvoiceCollection] Invoice collection
+      #   @return [InvoiceCollection] Invoice Collection
       define_attribute :invoice_collection, :InvoiceCollection
 
       # @!attribute object

data/lib/recurly/resources/unique_coupon_code.rb

@@ -6,6 +6,14 @@ module Recurly
   module Resources
     class UniqueCouponCode < Resource
 
+      # @!attribute bulk_coupon_code
+      #   @return [String] The Coupon code of the parent Bulk Coupon
+      define_attribute :bulk_coupon_code, String
+
+      # @!attribute bulk_coupon_id
+      #   @return [String] The Coupon ID of the parent Bulk Coupon
+      define_attribute :bulk_coupon_id, String
+
       # @!attribute code
       #   @return [String] The code the customer enters to redeem the coupon.
       define_attribute :code, String

data/lib/recurly/resources/usage.rb

@@ -0,0 +1,70 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class Usage < Resource
+
+      # @!attribute amount
+      #   @return [Float] The amount of usage. Can be positive, negative, or 0. No decimals allowed, we will strip them. If the usage-based add-on is billed with a percentage, your usage will be a monetary amount you will want to format in cents. (e.g., $5.00 is "500").
+      define_attribute :amount, Float
+
+      # @!attribute billed_at
+      #   @return [DateTime] When the usage record was billed on an invoice.
+      define_attribute :billed_at, DateTime
+
+      # @!attribute created_at
+      #   @return [DateTime] When the usage record was created in Recurly.
+      define_attribute :created_at, DateTime
+
+      # @!attribute id
+      #   @return [String]
+      define_attribute :id, String
+
+      # @!attribute measured_unit_id
+      #   @return [String] The ID of the measured unit associated with the add-on the usage record is for.
+      define_attribute :measured_unit_id, String
+
+      # @!attribute merchant_tag
+      #   @return [String] Custom field for recording the id in your own system associated with the usage, so you can provide auditable usage displays to your customers using a GET on this endpoint.
+      define_attribute :merchant_tag, String
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+
+      # @!attribute recording_timestamp
+      #   @return [DateTime] When the usage was recorded in your system.
+      define_attribute :recording_timestamp, DateTime
+
+      # @!attribute tier_type
+      #   @return [String] The pricing model for the add-on.  For more information, [click here](https://docs.recurly.com/docs/billing-models#section-quantity-based).
+      define_attribute :tier_type, String
+
+      # @!attribute tiers
+      #   @return [Array[SubscriptionAddOnTier]] The tiers and prices of the subscription based on the usage_timestamp. If tier_type = flat, tiers = null
+      define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
+
+      # @!attribute unit_amount
+      #   @return [Float] Unit price
+      define_attribute :unit_amount, Float
+
+      # @!attribute updated_at
+      #   @return [DateTime] When the usage record was billed on an invoice.
+      define_attribute :updated_at, DateTime
+
+      # @!attribute usage_percentage
+      #   @return [Float] The percentage taken of the monetary amount of usage tracked. This can be up to 4 decimal places. A value between 0.0 and 100.0.
+      define_attribute :usage_percentage, Float
+
+      # @!attribute usage_timestamp
+      #   @return [DateTime] When the usage actually happened. This will define the line item dates this usage is billed under and is important for revenue recognition.
+      define_attribute :usage_timestamp, DateTime
+
+      # @!attribute usage_type
+      #   @return [String] Type of usage, returns usage type if `add_on_type` is `usage`.
+      define_attribute :usage_type, String
+    end
+  end
+end

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "3.8.0"
+  VERSION = "3.13.0"
 end

data/openapi/api.yaml

@@ -157,11 +157,14 @@ x-tagGroups:
   - subscription_change
   - shipping_address
   - purchase
+  - usage
+  - automated_exports
 - name: Products and Promotions
   tags:
   - item
   - plan
   - add-on
+  - measured_unit
   - coupon
   - coupon_redemption
   - unique_coupon_code
@@ -198,6 +201,11 @@ tags:
   x-displayName: Add-on
   description: An add-on is a charge billed each billing period in addition to a subscription’s
     base charge. Each plan may have one or more add-ons associated with it.
+- name: measured_unit
+  x-displayName: Measured Unit
+  description: A measured unit describes a usage-based add-on's usage. If different
+    usage-based add-ons share the same measured unit, you can report on customer usage
+    for those add-ons at the aggregated measured unit level.
 - name: account
   x-displayName: Account
   description: Accounts are core to managing your customers inside of Recurly. The
@@ -250,6 +258,11 @@ tags:
   description: A purchase is a checkout containing at least one or more subscriptions
     or one-time charges (line items) and supports both coupon and gift card redemptions.
     All items purchased will be on one invoice and paid for with one transaction.
+- name: usage
+  x-displayName: Usage
+  description: Send Recurly your customer usage and we will automatically bill them
+    in arrears at the end of the billing cycle. For more info on usage-based billing,
+    [click here](https://docs.recurly.com/docs/usage-based-billing).
 - name: transaction
   x-displayName: Transaction
   description: Purchasing information is sent to your payment gateway in an action
@@ -270,15 +283,20 @@ tags:
 - name: shipping_method
   x-displayName: Shipping Method
   description: Shipping methods offered to send products to customers.
+- name: automated_exports
+  x-displayName: Automated Exports
+  description: Automated exports of customer data.
 paths:
   "/sites":
     get:
       operationId: list_sites
       summary: List sites
+      description: |
+        This route is most useful for finding a site's ID for subsequent requests.
+
+        See the [Pagination Guide](/guides/pagination.html) to learn how to use pagination in the API and Client Libraries.
       tags:
       - site
-      description: This route is most useful for finding a site's ID for subsequent
-        requests.
       parameters:
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -475,6 +493,8 @@ paths:
       - account
       operationId: list_accounts
       summary: List a site's accounts
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -768,7 +788,7 @@ paths:
       - lang: PHP
         source: |
           try {
-              $account_create = array(
+              $account_create = [
                   "code" => $account_code,
                   "first_name" => "Douglas",
                   "last_name" => "DuMonde",
@@ -783,7 +803,7 @@ paths:
                           "country" => "US"
                       ]
                   ]
-              );
+              ];
 
               $account = $client->createAccount($account_create);
 
@@ -1062,10 +1082,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $account_update = array(
+              $account_update = [
                   "first_name" => "Douglas",
                   "last_name" => "Du Monde",
-              );
+              ];
 
               $account = $client->updateAccount($account_id, $account_update);
 
@@ -1458,11 +1478,11 @@ paths:
       - lang: PHP
         source: |
           try {
-              $acquisition_update = array(
+              $acquisition_update = [
                   "campaign" => "big-event-campaign",
                   "channel" => "social_media",
                   "subchannel" => "twitter"
-              );
+              ];
               $acquisition = $client->updateAccountAcquisition($account_id, $acquisition_update);
 
               echo 'Updated AccountAcquisition:' . PHP_EOL;
@@ -2097,10 +2117,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $binfo_update = array(
+              $binfo_update = [
                   "first_name" => "Douglas",
                   "last_name" => "Du Monde",
-              );
+              ];
               $binfo = $client->updateBillingInfo($account_id, $binfo_update);
 
               echo 'Updated BillingInfo:' . PHP_EOL;
@@ -2237,6 +2257,8 @@ paths:
       - coupon_redemption
       operationId: list_account_coupon_redemptions
       summary: Show the coupon redemptions for an account
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -2544,10 +2566,10 @@ paths:
       - lang: PHP
         source: |-
           try {
-              $redemption_create = array(
+              $redemption_create = [
                   "currency" => "USD",
                   "coupon_id" => "code-$coupon_code"
-              );
+              ];
               $redemption = $client->createCouponRedemption($account_id, $redemption_create);
               echo "Created Redemption:" . PHP_EOL;
               var_dump($redemption);
@@ -2689,6 +2711,8 @@ paths:
       - credit_payment
       operationId: list_account_credit_payments
       summary: List an account's credit payments
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -2783,6 +2807,8 @@ paths:
       - account
       operationId: list_account_invoices
       summary: List an account's invoices
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -3016,10 +3042,10 @@ paths:
       - lang: PHP
         source: |-
           try {
-              $invoice_create = array(
+              $invoice_create = [
                   "currency" => "USD",
                   "collection_method" => "automatic"
-              );
+              ];
               $invoice_collection = $client->createInvoice(
                   $account_id,
                   $invoice_create
@@ -3187,10 +3213,10 @@ paths:
       - lang: PHP
         source: |-
           try {
-              $invoice_preview = array(
+              $invoice_preview = [
                   "currency" => "USD",
                   "collection_method" => "automatic"
-              );
+              ];
               $invoice_collection = $client->previewInvoice(
                   $account_id,
                   $invoice_preview
@@ -3220,6 +3246,8 @@ paths:
       - line_item
       operationId: list_account_line_items
       summary: List an account's line items
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -3487,6 +3515,8 @@ paths:
       - note
       operationId: list_account_notes
       summary: Fetch a list of an account's notes
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -3695,6 +3725,8 @@ paths:
       - shipping_address
       operationId: list_shipping_addresses
       summary: Fetch a list of an account's shipping addresses
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -3934,7 +3966,7 @@ paths:
       - lang: PHP
         source: |
           try {
-              $address_create = array(
+              $address_create = [
                   "nickname" => "Work",
                   "street1" => "900 Camp St",
                   "city" => "New Orleans",
@@ -3943,7 +3975,7 @@ paths:
                   "postal_code" => "70115",
                   "first_name" => "Douglas",
                   "last_name" => "Du Monde"
-              );
+              ];
               $shipping_address = $client->createShippingAddress($account_id, $address_create);
 
               echo "Created Shpping Address:" . PHP_EOL;
@@ -4236,10 +4268,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $shad_update = array(
+              $shad_update = [
                   "first_name" => "Douglas",
                   "last_name" => "Du Monde",
-              );
+              ];
               $shad = $client->updateShippingAddress($account_id, $shipping_address_id, $shad_update);
 
               echo 'Updated Shipping Address:' . PHP_EOL;
@@ -4377,6 +4409,8 @@ paths:
       - account
       operationId: list_account_subscriptions
       summary: List an account's subscriptions
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -4472,6 +4506,8 @@ paths:
       - transaction
       operationId: list_account_transactions
       summary: List an account's transactions
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -4568,6 +4604,8 @@ paths:
       - account
       operationId: list_child_accounts
       summary: List an account's child accounts
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/account_id"
@@ -4641,6 +4679,8 @@ paths:
       - account_acquisition
       operationId: list_account_acquisition
       summary: List a site's account acquisition data
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -4731,6 +4771,8 @@ paths:
       - coupon
       operationId: list_coupons
       summary: List a site's coupons
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -4978,7 +5020,7 @@ paths:
       - lang: PHP
         source: |
           try {
-              $coupon_create = array(
+              $coupon_create = [
                   "name" => "Promotional Coupon",
                   "code" => $coupon_code,
                   "discount_type" => "fixed",
@@ -4986,7 +5028,7 @@ paths:
                       "currency" => "USD",
                       "discount" => 10
                   ]
-              );
+              ];
 
               $coupon = $client->createCoupon($coupon_create);
 
@@ -5259,9 +5301,9 @@ paths:
       - lang: PHP
         source: |
           try {
-              $coupon_update = array(
+              $coupon_update = [
                   "name" => "New Coupon Name"
-              );
+              ];
               $coupon = $client->updateCoupon($coupon_id, $coupon_update);
 
               echo 'Updated Coupon:' . PHP_EOL;
@@ -5444,6 +5486,8 @@ paths:
       - unique_coupon_code
       operationId: list_unique_coupon_codes
       summary: List unique coupon codes associated with a bulk coupon
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/coupon_id"
@@ -5479,6 +5523,8 @@ paths:
       - credit_payment
       operationId: list_credit_payments
       summary: List a site's credit payments
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/limit"
@@ -5596,6 +5642,8 @@ paths:
       - custom_field_definition
       operationId: list_custom_field_definitions
       summary: List a site's custom field definitions
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -5812,6 +5860,8 @@ paths:
       - item
       operationId: list_items
       summary: List a site's items
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -6079,11 +6129,11 @@ paths:
       - lang: PHP
         source: |
           try {
-              $item_create = array(
+              $item_create = [
                   "code" => $item_code,
                   "name" => "Coffee Grinder",
                   "description" => "A professional-grade bean grinder."
-              );
+              ];
               $item = $client->createItem($item_create);
 
               echo 'Created Item:' . PHP_EOL;
@@ -6366,10 +6416,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $item_update = array(
+              $item_update = [
                   "name" => "Dark Roast Coffee Beans",
                   "description" => "A special dark roast version.",
-              );
+              ];
               $item = $client->updateItem($item_id, $item_update);
 
               echo 'Updated Item:' . PHP_EOL;
@@ -6632,12 +6682,200 @@ paths:
           validation: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
           Recurly error: %v\", e)\n\treturn nil, err\n}\nfmt.Printf(\"Reactivated
           Item: %s\", item.Id)"
+  "/sites/{site_id}/measured_units":
+    get:
+      tags:
+      - measured_unit
+      operationId: list_measured_unit
+      summary: List a site's measured units
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/ids"
+      - "$ref": "#/components/parameters/limit"
+      - "$ref": "#/components/parameters/order"
+      - "$ref": "#/components/parameters/sort_dates"
+      - "$ref": "#/components/parameters/filter_begin_time"
+      - "$ref": "#/components/parameters/filter_end_time"
+      - "$ref": "#/components/parameters/filter_state"
+      responses:
+        '200':
+          description: A list of the site's measured units.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/MeasuredUnitList"
+        '404':
+          description: Incorrect site ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    post:
+      tags:
+      - measured_unit
+      operationId: create_measured_unit
+      summary: Create a new measured unit
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/MeasuredUnitCreate"
+        required: true
+      responses:
+        '201':
+          description: A new measured unit.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/MeasuredUnit"
+        '400':
+          description: Bad request, perhaps invalid JSON?
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Invalid request parameters.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/sites/{site_id}/measured_units/{measured_unit_id}":
+    get:
+      tags:
+      - measured_unit
+      operationId: get_measured_unit
+      summary: Fetch a measured unit
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/measured_unit_id"
+      responses:
+        '200':
+          description: An item.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/MeasuredUnit"
+        '404':
+          description: Incorrect site or measured unit ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    put:
+      tags:
+      - measured_unit
+      operationId: update_measured_unit
+      summary: Update a measured unit
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/measured_unit_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/MeasuredUnitUpdate"
+        required: true
+      responses:
+        '200':
+          description: The updated measured_unit.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/MeasuredUnit"
+        '400':
+          description: Bad request, perhaps invalid JSON?
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or measured unit ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Invalid request parameters
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    delete:
+      tags:
+      - measured_unit
+      operationId: remove_measured_unit
+      summary: Remove a measured unit
+      description: A mesured unit cannot be deleted if it is used by an active plan.
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/measured_unit_id"
+      responses:
+        '200':
+          description: A measured unit.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/MeasuredUnit"
+        '422':
+          description: Measured unit may already be inactive.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/sites/{site_id}/invoices":
     get:
       tags:
       - invoice
       operationId: list_invoices
       summary: List a site's invoices
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -6964,10 +7202,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $invoice_update =  array(
+              $invoice_update =  [
                 "customer_notes" => "New Notes",
                 "terms_and_conditions" => "New terms and conditions",
-              );
+              ];
               $invoice = $client->putInvoice($invoice_id, $invoice_update);
 
               echo 'Updated Invoice:' . PHP_EOL;
@@ -7817,6 +8055,8 @@ paths:
       - line_item
       operationId: list_invoice_line_items
       summary: List an invoice's line items
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
@@ -7918,6 +8158,8 @@ paths:
       - coupon_redemption
       operationId: list_invoice_coupon_redemptions
       summary: Show the coupon redemptions applied to an invoice
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
@@ -8012,6 +8254,8 @@ paths:
         Related invoices provide a link between credit invoices and the charge invoices that they are refunding.
         For a charge invoice the related invoices will be credit invoices.
         For a credit invoice the related invoices will be charge invoices.
+
+        See the [Pagination Guide](/guides/pagination.html) to learn how to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/invoice_id"
@@ -8230,10 +8474,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $refund = array(
+              $refund = [
                   "type" => "amount",
                   "amount" => 1
-              );
+              ];
               $invoice_collection = $client->refundInvoice($invoice_id, $refund);
 
               echo 'Refunded Invoice:' . PHP_EOL;
@@ -8261,6 +8505,8 @@ paths:
       - line_item
       operationId: list_line_items
       summary: List a site's line items
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -8589,6 +8835,8 @@ paths:
       - plan
       operationId: list_plans
       summary: List a site's plans
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -8837,16 +9085,16 @@ paths:
       - lang: PHP
         source: |
           try {
-              $plan_create = array(
+              $plan_create = [
                   "name" => "Monthly Coffee Subscription",
                   "code" => $plan_code,
                   "currencies" => [
-                      array(
+                      [
                           "currency" => "USD",
                           "unit_amount" => 10000
-                      )
+                      ]
                   ]
-              );
+              ];
 
               $plan = $client->createPlan($plan_create);
 
@@ -9111,9 +9359,9 @@ paths:
       - lang: PHP
         source: |
           try {
-              $plan_update = array(
+              $plan_update = [
                   "name" => "Monthly Tea Subscription"
-              );
+              ];
               $plan = $client->updatePlan($plan_id, $plan_update);
 
               echo 'Updated Plan:' . PHP_EOL;
@@ -9249,6 +9497,8 @@ paths:
       - plan
       operationId: list_plan_add_ons
       summary: List a plan's add-ons
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/plan_id"
@@ -9506,10 +9756,10 @@ paths:
                   "code" => $add_on_code,
                   "name" => "Fresh beans shipped monthly",
                   "currencies" => [
-                      array(
+                      [
                           "currency" => "USD",
                           "unit_amount" => 10
-                      )
+                      ]
                   ]
               ];
 
@@ -9777,9 +10027,9 @@ paths:
       - lang: PHP
         source: |
           try {
-              $add_on_update = array(
+              $add_on_update = [
                   "name" => "New AddOn Name",
-              );
+              ];
               $add_on = $client->updatePlanAddOn($plan_id, $add_on_id, $add_on_update);
 
               echo ' Updated Plan AddOn:' . PHP_EOL;
@@ -9913,6 +10163,8 @@ paths:
       - add-on
       operationId: list_add_ons
       summary: List a site's add-ons
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -10121,6 +10373,8 @@ paths:
       - shipping_method
       operationId: list_shipping_methods
       summary: List a site's shipping methods
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -10370,6 +10624,8 @@ paths:
       - subscription
       operationId: list_subscriptions
       summary: List a site's subscriptions
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/ids"
@@ -10604,13 +10860,13 @@ paths:
       - lang: PHP
         source: |
           try {
-              $sub_create = array(
+              $sub_create = [
                   "plan_code" => $plan_code,
                   "currency" => "USD",
-                  "account" => array(
+                  "account" => [
                       "code" => $account_code
-                  ),
-              );
+                  ],
+              ];
 
               $subscription = $client->createSubscription($sub_create);
 
@@ -10874,10 +11130,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $changes = array(
+              $changes = [
                   "terms_and_conditions" => "Some new terms and conditions",
                   "customer_notes" => "Some new customer notes"
-              );
+              ];
 
               $subscription = $client->modifySubscription($subscription_id, $changes);
 
@@ -11917,10 +12173,10 @@ paths:
       - lang: PHP
         source: |
           try {
-              $change_create = array(
+              $change_create = [
                   "plan_code" => $new_plan_code,
                   "timeframe" => "now"
-              );
+              ];
               $change = $client->createSubscriptionChange($subscription_id, $change_create);
 
               echo 'Created Subscription Change:' . PHP_EOL;
@@ -12108,6 +12364,8 @@ paths:
       - subscription
       operationId: list_subscription_invoices
       summary: List a subscription's invoices
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
@@ -12203,6 +12461,8 @@ paths:
       - subscription
       operationId: list_subscription_line_items
       summary: List a subscription's line items
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
@@ -12301,6 +12561,8 @@ paths:
       - coupon_redemption
       operationId: list_subscription_coupon_redemptions
       summary: Show the coupon redemptions for a subscription
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
       parameters:
       - "$ref": "#/components/parameters/site_id"
       - "$ref": "#/components/parameters/subscription_id"
@@ -12380,29 +12642,32 @@ paths:
           e, ok := err.(*recurly.Error); ok {\n\t\tfmt.Printf(\"Failed to retrieve
           next page: %v\", e)\n\t\tbreak\n\t}\n\tfor i, redemption := range subCouponRedemptions.Data
           {\n\t\tfmt.Printf(\"Subscription Coupon Redemption %3d: %s\\n\",\n\t\t\ti,\n\t\t\tredemption.Id,\n\t\t)\n\t}\n}"
-  "/sites/{site_id}/transactions":
+  "/sites/{site_id}/subscriptions/{subscription_id}/add_ons/{add_on_id}/usage":
     get:
       tags:
-      - transaction
-      operationId: list_transactions
-      summary: List a site's transactions
+      - invoice
+      - subscription
+      - usage
+      operationId: list_usage
+      summary: List a subscription add-on's usage records
       parameters:
       - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/subscription_id"
+      - "$ref": "#/components/parameters/add_on_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
-      - "$ref": "#/components/parameters/sort_dates"
-      - "$ref": "#/components/parameters/filter_begin_time"
-      - "$ref": "#/components/parameters/filter_end_time"
-      - "$ref": "#/components/parameters/filter_transaction_type"
-      - "$ref": "#/components/parameters/filter_transaction_success"
+      - "$ref": "#/components/parameters/usage_sort_dates"
+      - "$ref": "#/components/parameters/filter_usage_begin_time"
+      - "$ref": "#/components/parameters/filter_usage_end_time"
+      - "$ref": "#/components/parameters/billing_status"
       responses:
         '200':
-          description: A list of the site's transactions.
+          description: A list of the subscription add-on's usage records.
           content:
             application/json:
               schema:
-                "$ref": "#/components/schemas/TransactionList"
+                "$ref": "#/components/schemas/UsageList"
         '400':
           description: Invalid or unpermitted parameter.
           content:
@@ -12410,7 +12675,7 @@ paths:
               schema:
                 "$ref": "#/components/schemas/Error"
         '404':
-          description: Incorrect site or subscription ID.
+          description: Incorrect site or subscription ID or add-on id.
           content:
             application/json:
               schema:
@@ -12421,47 +12686,263 @@ paths:
             application/json:
               schema:
                 "$ref": "#/components/schemas/Error"
-      x-code-samples:
-      - lang: Node.js
-        source: |
-          const transactions = client.listTransactions({ limit: 200 })
-
-          for await (const transaction of transactions.each()) {
-            console.log(transaction.uuid)
-          }
-      - lang: Python
-        source: |
-          transactions = client.list_transactions(limit=200).items()
-          for transaction in transactions:
-              print(transaction.uuid)
-      - lang: ".NET"
-        source: |
-          var transactions = client.ListTransactions(limit: 200);
-          foreach(Transaction transaction in transactions)
-          {
-              Console.WriteLine(transaction.Uuid);
-          }
-      - lang: Ruby
-        source: |
-          transactions = @client.list_transactions(limit: 200)
-          transactions.each do |transaction|
-            puts "Transaction: #{transaction.uuid}"
-          end
-      - lang: Java
-        source: |
-          QueryParams params = new QueryParams();
-          params.setLimit(200); // Pull 200 records at a time
-          final Pager<Transaction> transactions = client.listTransactions(params);
-
-          for (Transaction transaction : transactions) {
-              System.out.println(transaction.getUuid());
-          }
-      - lang: PHP
-        source: |
-          $params = ['limit' => 200];
-          $transactions = $client->listTransactions($params);
-
-          foreach($transactions as $transaction) {
+      x-code-samples: []
+    post:
+      tags:
+      - invoice
+      - subscription
+      - usage
+      operationId: create_usage
+      summary: Log a usage record on this subscription add-on
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/subscription_id"
+      - "$ref": "#/components/parameters/add_on_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/UsageCreate"
+        required: true
+      responses:
+        '201':
+          description: The created usage record.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Usage"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or subscription ID or add-on id.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: A validation error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/sites/{site_id}/usage/{usage_id}":
+    get:
+      tags:
+      - invoice
+      - subscription
+      - usage
+      operationId: get_usage
+      summary: Get a usage record
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/usage_id"
+      responses:
+        '200':
+          description: The usage record.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Usage"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or subscription, add-on, or usage ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    put:
+      tags:
+      - invoice
+      - subscription
+      - usage
+      operationId: update_usage
+      summary: Update a usage record
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/usage_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/UsageCreate"
+        required: true
+      responses:
+        '200':
+          description: The updated usage record.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Usage"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or subscription, add-on, or usage ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: A validation error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    delete:
+      tags:
+      - invoice
+      - subscription
+      - usage
+      operationId: remove_usage
+      summary: Delete a usage record.
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/usage_id"
+      responses:
+        '204':
+          description: Usage was successfully deleted.
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or subscription, add-on, or usage ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: A validation error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/sites/{site_id}/transactions":
+    get:
+      tags:
+      - transaction
+      operationId: list_transactions
+      summary: List a site's transactions
+      description: See the [Pagination Guide](/guides/pagination.html) to learn how
+        to use pagination in the API and Client Libraries.
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/ids"
+      - "$ref": "#/components/parameters/limit"
+      - "$ref": "#/components/parameters/order"
+      - "$ref": "#/components/parameters/sort_dates"
+      - "$ref": "#/components/parameters/filter_begin_time"
+      - "$ref": "#/components/parameters/filter_end_time"
+      - "$ref": "#/components/parameters/filter_transaction_type"
+      - "$ref": "#/components/parameters/filter_transaction_success"
+      responses:
+        '200':
+          description: A list of the site's transactions.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/TransactionList"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or subscription ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples:
+      - lang: Node.js
+        source: |
+          const transactions = client.listTransactions({ limit: 200 })
+
+          for await (const transaction of transactions.each()) {
+            console.log(transaction.uuid)
+          }
+      - lang: Python
+        source: |
+          transactions = client.list_transactions(limit=200).items()
+          for transaction in transactions:
+              print(transaction.uuid)
+      - lang: ".NET"
+        source: |
+          var transactions = client.ListTransactions(limit: 200);
+          foreach(Transaction transaction in transactions)
+          {
+              Console.WriteLine(transaction.Uuid);
+          }
+      - lang: Ruby
+        source: |
+          transactions = @client.list_transactions(limit: 200)
+          transactions.each do |transaction|
+            puts "Transaction: #{transaction.uuid}"
+          end
+      - lang: Java
+        source: |
+          QueryParams params = new QueryParams();
+          params.setLimit(200); // Pull 200 records at a time
+          final Pager<Transaction> transactions = client.listTransactions(params);
+
+          for (Transaction transaction : transactions) {
+              System.out.println(transaction.getUuid());
+          }
+      - lang: PHP
+        source: |
+          $params = ['limit' => 200];
+          $transactions = $client->listTransactions($params);
+
+          foreach($transactions as $transaction) {
             echo 'Transaction: ' . $transaction->getUuid() . PHP_EOL;
           }
       - lang: Go
@@ -12880,22 +13361,22 @@ paths:
       - lang: PHP
         source: |
           try {
-              $purchase_create = array(
+              $purchase_create = [
                   "currency" => "USD",
-                  "account" => array(
+                  "account" => [
                       "code" => $account_code,
                       "first_name" => "Douglas",
                       "last_name" => "Du Monde",
-                      "billing_info" => array(
+                      "billing_info" => [
                           "token_id" => $rjs_token_id
-                      ),
-                  ),
+                      ],
+                  ],
                   "subscriptions" => [
-                      array(
+                      [
                           "plan_code" => $plan_code
-                      )
+                      ]
                   ]
-              );
+              ];
               $invoice_collection = $client->createPurchase($purchase_create);
               echo 'Created Invoices:' . PHP_EOL;
               var_dump($invoice_collection);
@@ -13116,22 +13597,22 @@ paths:
       - lang: PHP
         source: |
           try {
-              $purchase_preview = array(
+              $purchase_preview = [
                   "currency" => "USD",
-                  "account" => array(
+                  "account" => [
                       "code" => $account_code,
                       "first_name" => "Douglas",
                       "last_name" => "Du Monde",
-                      "billing_info" => array(
+                      "billing_info" => [
                           "token_id" => $rjs_token_id
-                      ),
-                  ),
+                      ],
+                  ],
                   "subscriptions" => [
-                      array(
+                      [
                           "plan_code" => $plan_code
-                      )
+                      ]
                   ]
-              );
+              ];
               $invoice_collection = $client->previewPurchase($purchase_preview);
               echo 'Preview Invoices:' . PHP_EOL;
               var_dump($invoice_collection);
@@ -13150,6 +13631,79 @@ paths:
           {\n\t\tfmt.Printf(\"Failed validation: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
           Recurly error: %v\", e)\n\treturn nil, err\n}\nfmt.Printf(\"Preview Charge
           Invoice %v\", collection.ChargeInvoice)"
+  "/sites/{site_id}/export_dates":
+    parameters:
+    - "$ref": "#/components/parameters/site_id"
+    get:
+      tags:
+      - automated_exports
+      operationId: get_export_dates
+      summary: List the dates that have an available export to download.
+      description: Returns a list of dates for which export files are available for
+        download.
+      responses:
+        '200':
+          description: Returns a list of dates.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExportDates"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/sites/{site_id}/export_dates/{export_date}/export_files":
+    parameters:
+    - "$ref": "#/components/parameters/site_id"
+    - "$ref": "#/components/parameters/export_date"
+    get:
+      tags:
+      - automated_exports
+      operationId: get_export_files
+      summary: List of the export files that are available to download.
+      description: Returns a list of presigned URLs to download export files for the
+        given date, with their MD5 sums.
+      responses:
+        '200':
+          description: Returns a list of export files to download.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExportFiles"
+        '400':
+          description: Invalid or unpermitted parameter.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site ID or date.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
 servers:
 - url: https://v3.recurly.com
 components:
@@ -13178,6 +13732,13 @@ components:
       required: true
       schema:
         type: string
+    usage_id:
+      name: usage_id
+      in: path
+      description: Usage Record ID.
+      required: true
+      schema:
+        type: string
     coupon_id:
       name: coupon_id
       in: path
@@ -13217,6 +13778,14 @@ components:
       required: true
       schema:
         type: string
+    measured_unit_id:
+      name: measured_unit_id
+      in: path
+      description: Measured unit ID or name. For ID no prefix is used e.g. `e28zov4fw0v2`.
+        For name use prefix `name-`, e.g. `name-Storage`.
+      required: true
+      schema:
+        type: string
     line_item_id:
       name: line_item_id
       in: path
@@ -13324,6 +13893,30 @@ components:
         - created_at
         - updated_at
         default: created_at
+    usage_sort_dates:
+      name: sort
+      in: query
+      description: |
+        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.
+      schema:
+        type: string
+        default: usage_timestamp
+        enum:
+        - recorded_timestamp
+        - usage_timestamp
+    billing_status:
+      name: billing_status
+      in: query
+      description: Filter by usage record's billing status
+      schema:
+        type: string
+        default: unbilled
+        enum:
+        - unbilled
+        - billed
+        - all
     filter_state:
       name: state
       in: query
@@ -13355,7 +13948,7 @@ components:
       name: begin_time
       in: query
       description: |
-        Filter by begin_time when `sort=created_at` or `sort=updated_at`.
+        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.
       schema:
         type: string
@@ -13364,7 +13957,25 @@ components:
       name: end_time
       in: query
       description: |
-        Filter by end_time when `sort=created_at` or `sort=updated_at`.
+        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.
+      schema:
+        type: string
+        format: date-time
+    filter_usage_begin_time:
+      name: begin_time
+      in: query
+      description: |
+        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.
+      schema:
+        type: string
+        format: date-time
+    filter_usage_end_time:
+      name: end_time
+      in: query
+      description: |
+        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.
       schema:
         type: string
@@ -13457,6 +14068,14 @@ components:
         - credit
         - non-legacy
         - legacy
+    export_date:
+      name: export_date
+      in: path
+      description: Date for which to get a list of available automated export files.
+        Date must be in YYYY-MM-DD format.
+      required: true
+      schema:
+        type: string
   securitySchemes:
     api_key:
       type: http
@@ -13642,6 +14261,23 @@ components:
           type: array
           items:
             "$ref": "#/components/schemas/Invoice"
+    MeasuredUnitList:
+      type: object
+      properties:
+        object:
+          type: string
+          title: Object type
+          description: Will always be List.
+        has_more:
+          type: boolean
+          description: Indicates there are more results on subsequent pages.
+        next:
+          type: string
+          description: Path to subsequent page of results.
+        data:
+          type: array
+          items:
+            "$ref": "#/components/schemas/MeasuredUnit"
     LineItemList:
       type: object
       properties:
@@ -14286,6 +14922,32 @@ components:
           title: Name
           description: Describes your add-on and will appear in subscribers' invoices.
           maxLength: 255
+        add_on_type:
+          type: string
+          enum:
+          - fixed
+          - usage
+          title: Add-on Type
+          description: Whether the add-on type is fixed, or usage-based.
+        usage_type:
+          type: string
+          enum:
+          - price
+          - percentage
+          title: Usage Type
+          description: Type of usage, returns usage type if `add_on_type` is `usage`.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0.
+        measured_unit_id:
+          type: string
+          title: Measured Unit ID
+          description: System-generated unique identifier for an measured unit associated
+            with the add-on.
+          maxLength: 13
         item_id:
           type: string
           title: Item ID
@@ -14342,6 +15004,32 @@ components:
           title: Name
           description: Describes your add-on and will appear in subscribers' invoices.
           maxLength: 255
+        add_on_type:
+          type: string
+          enum:
+          - fixed
+          - usage
+          title: Add-on Type
+          description: Whether the add-on type is fixed, or usage-based.
+        usage_type:
+          type: string
+          enum:
+          - price
+          - percentage
+          title: Usage Type
+          description: Type of usage, returns usage type if `add_on_type` is `usage`.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0.
+        measured_unit_id:
+          type: string
+          title: Measured Unit ID
+          description: System-generated unique identifier for an measured unit associated
+            with the add-on.
+          maxLength: 13
         accounting_code:
           type: string
           title: Accounting code
@@ -14360,6 +15048,22 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -14470,6 +15174,47 @@ components:
             If `item_code`/`item_id` is part of the request then `name` must be absent.
             If `item_code`/`item_id` is not present `name` is required.
           maxLength: 255
+        add_on_type:
+          type: string
+          enum:
+          - fixed
+          - usage
+          title: Add-on Type
+          description: Whether the add-on type is fixed, or usage-based.
+          default: fixed
+        usage_type:
+          type: string
+          enum:
+          - price
+          - percentage
+          title: Usage Type
+          description: |
+            Type of usage, required if `add_on_type` is `usage`. See our
+            [Guide](https://developers.recurly.com/guides/usage-based-billing-guide.html)
+            for an overview of how to configure usage add-ons.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
+            if `add_on_type` is usage and `usage_type` is percentage. Must be omitted
+            otherwise. `usage_percentage` does not support tiers.
+        measured_unit_id:
+          type: string
+          title: Measured Unit ID
+          description: System-generated unique identifier for a measured unit to be
+            associated with the add-on. Either `measured_unit_id` or `measured_unit_name`
+            are required when `add_on_type` is `usage`. If `measured_unit_id` and
+            `measured_unit_name` are both present, `measured_unit_id` will be used.
+          maxLength: 13
+        measured_unit_name:
+          type: string
+          title: Measured Unit Name
+          description: Name of a measured unit to be associated with the add-on. Either
+            `measured_unit_id` or `measured_unit_name` are required when `add_on_type`
+            is `usage`. If `measured_unit_id` and `measured_unit_name` are both present,
+            `measured_unit_id` will be used.
         plan_id:
           type: string
           title: Plan ID
@@ -14513,6 +15258,24 @@ components:
             be included when a subscription is created through the Recurly UI. However,
             the add-on will not be included when a subscription is created through
             the API.
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `AddOn`,
+            then the `avalara_transaction_type` must be absent.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `AddOn`,
+            then the `avalara_service_type` must be absent.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -14541,7 +15304,9 @@ components:
           title: Tier type
           description: |
             The pricing model for the add-on.  For more information,
-            [click here](https://docs.recurly.com/docs/billing-models#section-quantity-based).
+            [click here](https://docs.recurly.com/docs/billing-models#section-quantity-based). See
+            our [Guide](https://developers.recurly.com/guides/item-addon-guide.html) for an overview
+            of how to configure quantity-based pricing models.
           default: flat
           enum:
           - flat
@@ -14584,6 +15349,29 @@ components:
           description: Describes your add-on and will appear in subscribers' invoices.
             If an `Item` is associated to the `AddOn` then `name` must be absent.
           maxLength: 255
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
+            if `add_on_type` is usage and `usage_type` is percentage. Must be omitted
+            otherwise. `usage_percentage` does not support tiers.
+        measured_unit_id:
+          type: string
+          title: Measured Unit ID
+          description: System-generated unique identifier for a measured unit to be
+            associated with the add-on. Either `measured_unit_id` or `measured_unit_name`
+            are required when `add_on_type` is `usage`. If `measured_unit_id` and
+            `measured_unit_name` are both present, `measured_unit_id` will be used.
+          maxLength: 13
+        measured_unit_name:
+          type: string
+          title: Measured Unit Name
+          description: Name of a measured unit to be associated with the add-on. Either
+            `measured_unit_id` or `measured_unit_name` are required when `add_on_type`
+            is `usage`. If `measured_unit_id` and `measured_unit_name` are both present,
+            `measured_unit_id` will be used.
         accounting_code:
           type: string
           title: Accounting code
@@ -14603,6 +15391,24 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `AddOn`,
+            then the `avalara_transaction_type` must be absent.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the add-on is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `AddOn`,
+            then the `avalara_service_type` must be absent.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -14955,8 +15761,8 @@ components:
           default: false
         plans_names:
           type: array
-          title: 'Plan names (TODO: decide if this duplicates `plans`)'
-          description: TODO
+          title: Plan names
+          description: A list of plan names for which this coupon applies.
           items:
             type: string
         plans:
@@ -14979,7 +15785,7 @@ components:
           "$ref": "#/components/schemas/CouponDiscount"
         coupon_type:
           type: string
-          title: 'Coupon type (TODO: implement coupon generation)'
+          title: Coupon type
           description: Whether the coupon is "single_code" or "bulk". Bulk coupons
             will require a `unique_code_template` and will generate unique codes through
             the `/generate` endpoint.
@@ -15003,6 +15809,15 @@ components:
           description: The date and time the coupon will expire and can no longer
             be redeemed. Time is always 11:59:59, the end-of-day Pacific time.
           format: date-time
+        bulk_coupon_id:
+          type: string
+          title: Bulk Coupon ID
+          description: The Coupon ID of the parent Bulk Coupon
+          readOnly: true
+        bulk_coupon_code:
+          type: string
+          title: Bulk Coupon code
+          description: The Coupon code of the parent Bulk Coupon
         redeemed_at:
           type: string
           title: Redeemed at
@@ -15081,13 +15896,17 @@ components:
           applies_to_all_plans:
             type: boolean
             title: Applies to all plans?
-            description: The coupon is valid for all plans if true. If false then
+            description: |
+              The coupon is valid for all plans if true. If false then
               `plans` and `plans_names` will list the applicable plans.
             default: true
           plan_codes:
             type: array
             title: Plan codes
-            description: List of plan codes to which this coupon applies. See `applies_to_all_plans`
+            description: |
+              List of plan codes to which this coupon applies. Required
+              if `applies_to_all_plans` is false. Overrides `applies_to_all_plans`
+              when `applies_to_all_plans` is true.
             items:
               type: string
           duration:
@@ -15254,7 +16073,7 @@ components:
           "$ref": "#/components/schemas/CouponDiscount"
         coupon_type:
           type: string
-          title: 'Coupon type (TODO: implement coupon generation)'
+          title: Coupon type
           description: Whether the coupon is "single_code" or "bulk". Bulk coupons
             will require a `unique_code_template` and will generate unique codes through
             the `/generate` endpoint.
@@ -15657,6 +16476,22 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -15730,6 +16565,22 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -15791,6 +16642,22 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the item is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -15843,6 +16710,7 @@ components:
           - credit
           - gift_card
           - write_off
+          - prepayment
         state:
           type: string
           title: Invoice state
@@ -16270,6 +17138,95 @@ components:
           - payment_method
       required:
       - type
+    MeasuredUnit:
+      type: object
+      title: Measured unit
+      properties:
+        id:
+          type: string
+          title: Item ID
+          maxLength: 13
+          readOnly: true
+        object:
+          type: string
+          title: Object type
+          readOnly: true
+        name:
+          type: string
+          title: Name
+          description: Unique internal name of the measured unit on your site.
+        display_name:
+          type: string
+          title: Display name
+          description: Display name for the measured unit. Can only contain spaces,
+            underscores and must be alphanumeric.
+          maxLength: 50
+        state:
+          title: State
+          description: The current state of the measured unit.
+          readOnly: true
+          type: string
+          enum:
+          - active
+          - inactive
+        description:
+          type: string
+          title: Description
+          description: Optional internal description.
+        created_at:
+          type: string
+          format: date-time
+          title: Created at
+          readOnly: true
+        updated_at:
+          type: string
+          format: date-time
+          title: Last updated at
+          readOnly: true
+        deleted_at:
+          type: string
+          format: date-time
+          title: Deleted at
+          readOnly: true
+    MeasuredUnitCreate:
+      type: object
+      properties:
+        name:
+          type: string
+          title: Name
+          description: Unique internal name of the measured unit on your site.
+          maxLength: 255
+        display_name:
+          type: string
+          title: Display name
+          description: Display name for the measured unit.
+          pattern: "/^[\\w ]+$/"
+          maxLength: 50
+        description:
+          type: string
+          title: Description
+          description: Optional internal description.
+      required:
+      - name
+      - display_name
+    MeasuredUnitUpdate:
+      type: object
+      properties:
+        name:
+          type: string
+          title: Name
+          description: Unique internal name of the measured unit on your site.
+          maxLength: 255
+        display_name:
+          type: string
+          title: Display name
+          description: Display name for the measured unit.
+          pattern: "/^[\\w ]+$/"
+          maxLength: 50
+        description:
+          type: string
+          title: Description
+          description: Optional internal description.
     LineItem:
       type: object
       title: Line item
@@ -16502,6 +17459,22 @@ components:
             If not defined, then defaults to the Plan and Site settings. This attribute
             does not work for credits (negative line items). Credits are always applied
             post-tax. Pre-tax discounts should use the Coupons feature."
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the line item is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the line item is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -16667,6 +17640,24 @@ components:
             If not defined, then defaults to the Plan and Site settings. This attribute
             does not work for credits (negative line items). Credits are always applied
             post-tax. Pre-tax discounts should use the Coupons feature."
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the line item is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `LineItem`,
+            then the `avalara_transaction_type` must be absent.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the line item is taxed.
+            Refer to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types. If an `Item` is associated to the `LineItem`,
+            then the `avalara_service_type` must be absent.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -16688,12 +17679,16 @@ components:
         origin:
           type: string
           title: Origin
-          description: Only allowed if the Gift Cards feature is enabled on your site
-            and `type` is `credit`. Can only have a value of `external_gift_card`.
-            Set this value in order to track gift card credits from external gift
-            cards (like InComm). It also skips billing information requirements.
+          description: Origin `external_gift_card` is allowed if the Gift Cards feature
+            is enabled on your site and `type` is `credit`. Set this value in order
+            to track gift card credits from external gift cards (like InComm). It
+            also skips billing information requirements.  Origin `prepayment` is only
+            allowed if `type` is `charge` and `tax_exempt` is left blank or set to
+            true.  This origin creates a charge and opposite credit on the account
+            to be used for future invoices.
           enum:
           - external_gift_card
+          - prepayment
         start_date:
           type: string
           format: date-time
@@ -16855,6 +17850,22 @@ components:
             fee. If no value is provided, it defaults to plan's accounting code.
           pattern: "/^[a-z0-9_+-]+$/"
           maxLength: 20
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -17003,6 +18014,22 @@ components:
             fee. If no value is provided, it defaults to plan's accounting code.
           pattern: "/^[a-z0-9_+-]+$/"
           maxLength: 20
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -17182,6 +18209,22 @@ components:
             fee. If no value is provided, it defaults to plan's accounting code.
           pattern: "/^[a-z0-9_+-]+$/"
           maxLength: 20
+        avalara_transaction_type:
+          type: integer
+          title: Avalara Transaction Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
+        avalara_service_type:
+          type: integer
+          title: Avalara Service Type
+          description: Used by Avalara for Communications taxes. The transaction type
+            in combination with the service type describe how the plan is taxed. Refer
+            to [the documentation](https://help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types)
+            for more available t/s types.
+          minimum: 0
         tax_code:
           type: string
           title: Tax code
@@ -17948,6 +18991,9 @@ components:
             `plan` has `allow_any_item_on_subscriptions` set to `true` and this field is set to `item`, then
             the associated add-on data will be pulled from the site's item catalog.
           default: plan_add_on
+          enum:
+          - plan_add_on
+          - item
         quantity:
           type: integer
           title: Add-on quantity
@@ -17981,7 +19027,16 @@ components:
           items:
             "$ref": "#/components/schemas/SubscriptionAddOnTier"
           minItems: 1
-          description: Empty unless `tier_type` is `tiered`, `volume`, or `stairstep`.
+          description: |
+            If tiers are provided in the request, all existing tiers on the Subscription Add-on will be
+            removed and replaced by the tiers in the request.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
+            if add_on_type is usage and usage_type is percentage.
         created_at:
           type: string
           format: date-time
@@ -18001,6 +19056,9 @@ components:
           type: string
           title: Add-on code
           maxLength: 50
+          description: |
+            If `add_on_source` is set to `plan_add_on` or left blank, then plan's add-on `code` should be used.
+            If `add_on_source` is set to `item`, then the `code` from the associated item should be used.
         add_on_source:
           type: string
           title: Add-on source
@@ -18010,6 +19068,9 @@ components:
             `plan` has `allow_any_item_on_subscriptions` set to `true` and this field is set to `item`, then
             the associated add-on data will be pulled from the site's item catalog.
           default: plan_add_on
+          enum:
+          - plan_add_on
+          - item
         quantity:
           type: integer
           title: Quantity
@@ -18033,7 +19094,17 @@ components:
             If the plan add-on's `tier_type` is `flat`, then `tiers` must be absent. The `tiers` object
             must include one to many tiers with `ending_quantity` and `unit_amount`.
             There must be one tier with an `ending_quantity` of 999999999 which is the
-            default if not provided.
+            default if not provided. See our [Guide](https://developers.recurly.com/guides/item-addon-guide.html)
+            for an overview of how to configure quantity-based pricing models.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
+            if `add_on_type` is usage and `usage_type` is percentage. Must be omitted
+            otherwise. `usage_percentage` does not support tiers. See our [Guide](https://developers.recurly.com/guides/usage-based-billing-guide.html)
+            for an overview of how to configure usage add-ons.
         revenue_schedule_type:
           type: string
           title: Revenue schedule type
@@ -18061,7 +19132,21 @@ components:
           description: |
             If a code is provided without an id, the subscription add-on attributes
             will be set to the current value for those attributes on the plan add-on
-            unless provided in the request.
+            unless provided in the request. If `add_on_source` is set to `plan_add_on`
+            or left blank, then plan's add-on `code` should be used. If `add_on_source`
+            is set to `item`, then the `code` from the associated item should be used.
+        add_on_source:
+          type: string
+          title: Add-on source
+          description: |
+            Used to determine where the associated add-on data is pulled from. If this value is set to
+            `plan_add_on` or left blank, then add_on data will be pulled from the plan's add-ons. If the associated
+            `plan` has `allow_any_item_on_subscriptions` set to `true` and this field is set to `item`, then
+            the associated add-on data will be pulled from the site's item catalog.
+          default: plan_add_on
+          enum:
+          - plan_add_on
+          - item
         quantity:
           type: integer
           title: Quantity
@@ -18083,6 +19168,13 @@ components:
             must include one to many tiers with `ending_quantity` and `unit_amount`.
             There must be one tier with an `ending_quantity` of 999999999 which is the
             default if not provided.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0. Required
+            if add_on_type is usage and usage_type is percentage.
         revenue_schedule_type:
           type: string
           title: Revenue schedule type
@@ -18178,6 +19270,11 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        invoice_collection:
+          title: Invoice Collection
+          "$ref": "#/components/schemas/InvoiceCollection"
+        custom_fields:
+          "$ref": "#/components/schemas/CustomFields"
         created_at:
           type: string
           format: date-time
@@ -18253,10 +19350,11 @@ components:
           type: array
           title: Add-ons
           description: |
-            If you provide a value for this field it will replace any
-            existing add-ons. So, when adding or modifying an add-on, you need to
-            include the existing subscription add-ons. Unchanged add-ons can be included
-            just using the subscription add-on's ID: `{"id": "abc123"}`.
+            If this value is omitted your existing add-ons will be removed. If you provide
+            a value for this field it will replace any existing add-ons. So, when adding or
+            modifying an add-on, you need to include the existing subscription add-ons.
+            Unchanged add-ons can be included just using the subscription add-on's ID:
+            `{"id": "abc123"}`.
 
             If a subscription add-on's `code` is supplied without the `id`,
             `{"code": "def456"}`, the subscription add-on attributes will be set to the
@@ -18285,6 +19383,8 @@ components:
           - evenly
           - at_range_end
           - at_range_start
+        custom_fields:
+          "$ref": "#/components/schemas/CustomFields"
         po_number:
           type: string
           title: Purchase order number
@@ -18309,12 +19409,9 @@ components:
           enum:
           - moto
     SubscriptionChangePreview:
+      type: object
       allOf:
       - "$ref": "#/components/schemas/SubscriptionChange"
-      type: object
-      properties:
-        invoice_collection:
-          "$ref": "#/components/schemas/InvoiceCollection"
     SubscriptionChangeShippingCreate:
       type: object
       title: Shipping details that will be changed on a subscription
@@ -18541,6 +19638,13 @@ components:
           title: Trial ends at
           description: If set, overrides the default trial behavior for the subscription.
             The date must be in the future.
+        starts_at:
+          type: string
+          format: date-time
+          title: Start date
+          description: If set, the subscription will begin in the future on this date.
+            The subscription will apply the setup fee and trial period, unless the
+            plan has no trial.
         next_bill_date:
           type: string
           format: date-time
@@ -19044,6 +20148,7 @@ components:
             to current datetime.
     UniqueCouponCode:
       type: object
+      description: A unique coupon code for a bulk coupon.
       properties:
         id:
           type: string
@@ -19066,6 +20171,15 @@ components:
           - maxed_out
           - expired
           - inactive
+        bulk_coupon_id:
+          type: string
+          title: Bulk Coupon ID
+          description: The Coupon ID of the parent Bulk Coupon
+          readOnly: true
+        bulk_coupon_code:
+          type: string
+          title: Bulk Coupon code
+          description: The Coupon code of the parent Bulk Coupon
         created_at:
           type: string
           title: Created at
@@ -19105,6 +20219,128 @@ components:
           type: array
           items:
             "$ref": "#/components/schemas/UniqueCouponCode"
+    Usage:
+      type: object
+      properties:
+        id:
+          type: string
+        object:
+          type: string
+          title: Object type
+        merchant_tag:
+          type: string
+          description: Custom field for recording the id in your own system associated
+            with the usage, so you can provide auditable usage displays to your customers
+            using a GET on this endpoint.
+        amount:
+          type: number
+          format: float
+          description: The amount of usage. Can be positive, negative, or 0. No decimals
+            allowed, we will strip them. If the usage-based add-on is billed with
+            a percentage, your usage will be a monetary amount you will want to format
+            in cents. (e.g., $5.00 is "500").
+        usage_type:
+          type: string
+          enum:
+          - price
+          - percentage
+          title: Usage Type
+          description: Type of usage, returns usage type if `add_on_type` is `usage`.
+        tier_type:
+          type: string
+          title: Tier type
+          description: |
+            The pricing model for the add-on.  For more information,
+            [click here](https://docs.recurly.com/docs/billing-models#section-quantity-based).
+          default: flat
+          enum:
+          - flat
+          - tiered
+          - stairstep
+          - volume
+        tiers:
+          type: array
+          title: Tiers
+          items:
+            "$ref": "#/components/schemas/SubscriptionAddOnTier"
+          description: The tiers and prices of the subscription based on the usage_timestamp.
+            If tier_type = flat, tiers = null
+        measured_unit_id:
+          type: string
+          description: The ID of the measured unit associated with the add-on the
+            usage record is for.
+        recording_timestamp:
+          type: string
+          format: date-time
+          description: When the usage was recorded in your system.
+        usage_timestamp:
+          type: string
+          format: date-time
+          description: When the usage actually happened. This will define the line
+            item dates this usage is billed under and is important for revenue recognition.
+        usage_percentage:
+          type: number
+          format: float
+          title: Usage Percentage
+          description: The percentage taken of the monetary amount of usage tracked.
+            This can be up to 4 decimal places. A value between 0.0 and 100.0.
+        unit_amount:
+          type: number
+          format: float
+          title: Unit price
+        billed_at:
+          type: string
+          format: date-time
+          description: When the usage record was billed on an invoice.
+        created_at:
+          type: string
+          format: date-time
+          description: When the usage record was created in Recurly.
+        updated_at:
+          type: string
+          format: date-time
+          description: When the usage record was billed on an invoice.
+    UsageCreate:
+      type: object
+      properties:
+        merchant_tag:
+          type: string
+          description: Custom field for recording the id in your own system associated
+            with the usage, so you can provide auditable usage displays to your customers
+            using a GET on this endpoint.
+        amount:
+          type: number
+          format: float
+          description: The amount of usage. Can be positive, negative, or 0. No decimals
+            allowed, we will strip them. If the usage-based add-on is billed with
+            a percentage, your usage will be a monetary amount you will want to format
+            in cents. (e.g., $5.00 is "500").
+        recording_timestamp:
+          type: string
+          format: date-time
+          description: When the usage was recorded in your system.
+        usage_timestamp:
+          type: string
+          format: date-time
+          description: When the usage actually happened. This will define the line
+            item dates this usage is billed under and is important for revenue recognition.
+    UsageList:
+      type: object
+      properties:
+        object:
+          type: string
+          title: Object type
+          description: Will always be List.
+        has_more:
+          type: boolean
+          description: Indicates there are more results on subsequent pages.
+        next:
+          type: string
+          description: Path to subsequent page of results.
+        data:
+          type: array
+          items:
+            "$ref": "#/components/schemas/Usage"
     User:
       type: object
       properties:
@@ -19201,8 +20437,8 @@ components:
               type: string
               title: Shipping address ID
               description: Assign a shipping address from the account's existing shipping
-                addresses. If this and `shipping_address` are both present, `shipping_address`
-                will take precedence.
+                addresses. If this and `address` are both present, `address` will
+                take precedence.
               maxLength: 13
             address:
               "$ref": "#/components/schemas/ShippingAddressCreate"
@@ -19394,6 +20630,7 @@ components:
                 title: Category
                 enum:
                 - 3d_secure_required
+                - 3d_secure_action_required
                 - amazon
                 - api_error
                 - approved
@@ -19546,3 +20783,41 @@ components:
                   a transaction. Pass this value to Recurly.js so it can continue
                   the challenge flow.
                 maxLength: 22
+    ExportDates:
+      type: object
+      properties:
+        object:
+          type: string
+          title: Object type
+          readOnly: true
+        dates:
+          type: array
+          items:
+            type: string
+          title: An array of dates that have available exports.
+    ExportFiles:
+      type: object
+      properties:
+        object:
+          type: string
+          title: Object type
+          readOnly: true
+        files:
+          type: array
+          items:
+            "$ref": "#/components/schemas/ExportFile"
+    ExportFile:
+      type: object
+      properties:
+        name:
+          type: string
+          title: Filename
+          description: Name of the export file.
+        md5sum:
+          type: string
+          title: MD5 hash of the export file
+          description: MD5 hash of the export file.
+        href:
+          type: string
+          title: A link to the export file
+          description: A presigned link to download the export file.