recurly 3.12.0 → 3.17.0

data/lib/recurly/requests/purchase_create.rb

@@ -10,6 +10,10 @@ module Recurly
       #   @return [AccountPurchase]
       define_attribute :account, :AccountPurchase
 
+      # @!attribute billing_info_id
+      #   @return [String] The `billing_info_id` is the value that represents a specific billing info for an end customer. When `billing_info_id` is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info.
+      define_attribute :billing_info_id, String
+
       # @!attribute collection_method
       #   @return [String] Must be set to manual in order to preview a purchase for an Account that does not have payment information associated with the Billing Info.
       define_attribute :collection_method, String

data/lib/recurly/requests/subscription_add_on_create.rb

@@ -23,7 +23,7 @@ module Recurly
       define_attribute :revenue_schedule_type, String
 
       # @!attribute tiers
-      #   @return [Array[SubscriptionAddOnTier]] 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.
+      #   @return [Array[SubscriptionAddOnTier]] 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. See our [Guide](https://developers.recurly.com/guides/item-addon-guide.html) for an overview of how to configure quantity-based pricing models.
       define_attribute :tiers, Array, { :item_type => :SubscriptionAddOnTier }
 
       # @!attribute unit_amount
@@ -31,7 +31,7 @@ module Recurly
       define_attribute :unit_amount, Float
 
       # @!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. Must be omitted otherwise. `usage_percentage` does not support tiers.
+      #   @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. 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.
       define_attribute :usage_percentage, Float
     end
   end

data/lib/recurly/requests/subscription_create.rb

@@ -18,6 +18,10 @@ module Recurly
       #   @return [Boolean] Whether the subscription renews at the end of its term.
       define_attribute :auto_renew, :Boolean
 
+      # @!attribute billing_info_id
+      #   @return [String] The `billing_info_id` is the value that represents a specific billing info for an end customer. When `billing_info_id` is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info.
+      define_attribute :billing_info_id, String
+
       # @!attribute collection_method
       #   @return [String] Collection method
       define_attribute :collection_method, String

data/lib/recurly/requests/subscription_update.rb

@@ -10,6 +10,10 @@ module Recurly
       #   @return [Boolean] Whether the subscription renews at the end of its term.
       define_attribute :auto_renew, :Boolean
 
+      # @!attribute billing_info_id
+      #   @return [String] The `billing_info_id` is the value that represents a specific billing info for an end customer. When `billing_info_id` is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info.
+      define_attribute :billing_info_id, String
+
       # @!attribute collection_method
       #   @return [String] Change collection method
       define_attribute :collection_method, String

data/lib/recurly/resources/billing_info.rb

@@ -46,6 +46,10 @@ module Recurly
       #   @return [PaymentMethod]
       define_attribute :payment_method, :PaymentMethod
 
+      # @!attribute primary_payment_method
+      #   @return [Boolean] The `primary_payment_method` indicator is used to designate the primary billing info on the account. The first billing info created on an account will always become primary. Adding additional billing infos provides the flexibility to mark another billing info as primary, or adding additional non-primary billing infos. This can be accomplished by passing the `primary_payment_method` indicator. When adding billing infos via the billing_info and /accounts endpoints, this value is not permitted, and will return an error if provided.
+      define_attribute :primary_payment_method, :Boolean
+
       # @!attribute updated_at
       #   @return [DateTime] When the billing information was last changed.
       define_attribute :updated_at, DateTime

data/lib/recurly/resources/coupon.rb

@@ -6,6 +6,10 @@ module Recurly
   module Resources
     class Coupon < Resource
 
+      # @!attribute applies_to_all_items
+      #   @return [Boolean] The coupon is valid for all items if true. If false then `items` will list the applicable items.
+      define_attribute :applies_to_all_items, :Boolean
+
       # @!attribute applies_to_all_plans
       #   @return [Boolean] The coupon is valid for all plans if true. If false then `plans` and `plans_names` will list the applicable plans.
       define_attribute :applies_to_all_plans, :Boolean
@@ -14,6 +18,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
@@ -58,6 +70,10 @@ module Recurly
       #   @return [String] Description of the coupon on the invoice.
       define_attribute :invoice_description, String
 
+      # @!attribute items
+      #   @return [Array[ItemMini]] A list of items for which this coupon applies. This will be `null` if `applies_to_all_items=true`.
+      define_attribute :items, Array, { :item_type => :ItemMini }
+
       # @!attribute max_redemptions
       #   @return [Integer] A maximum number of redemptions for the coupon. The coupon will expire when it hits its maximum redemptions.
       define_attribute :max_redemptions, Integer
@@ -79,7 +95,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/invoice.rb

@@ -18,6 +18,10 @@ module Recurly
       #   @return [Float] The outstanding balance remaining on this invoice.
       define_attribute :balance, Float
 
+      # @!attribute billing_info_id
+      #   @return [String] The `billing_info_id` is the value that represents a specific billing info for an end customer. When `billing_info_id` is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info.
+      define_attribute :billing_info_id, String
+
       # @!attribute closed_at
       #   @return [DateTime] Date invoice was marked paid or failed.
       define_attribute :closed_at, DateTime

data/lib/recurly/resources/subscription.rb

@@ -30,6 +30,10 @@ module Recurly
       #   @return [DateTime] Recurring subscriptions paid with ACH will have this attribute set. This timestamp is used for alerting customers to reauthorize in 3 years in accordance with NACHA rules. If a subscription becomes inactive or the billing info is no longer a bank account, this timestamp is cleared.
       define_attribute :bank_account_authorized_at, DateTime
 
+      # @!attribute billing_info_id
+      #   @return [String] Billing Info ID.
+      define_attribute :billing_info_id, String
+
       # @!attribute canceled_at
       #   @return [DateTime] Canceled at
       define_attribute :canceled_at, DateTime
@@ -39,7 +43,7 @@ module Recurly
       define_attribute :collection_method, String
 
       # @!attribute coupon_redemptions
-      #   @return [Array[CouponRedemptionMini]] Coupon redemptions
+      #   @return [Array[CouponRedemptionMini]] Returns subscription level coupon redemptions that are tied to this subscription.
       define_attribute :coupon_redemptions, Array, { :item_type => :CouponRedemptionMini }
 
       # @!attribute created_at

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

@@ -46,10 +46,18 @@ module Recurly
       #   @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

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "3.12.0"
+  VERSION = "3.17.0"
 end

data/openapi/api.yaml

@@ -158,6 +158,7 @@ x-tagGroups:
   - shipping_address
   - purchase
   - usage
+  - automated_exports
 - name: Products and Promotions
   tags:
   - item
@@ -282,6 +283,9 @@ 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:
@@ -1138,14 +1142,11 @@ paths:
             const account = await client.deactivateAccount(accountId)
             console.log('Deleted account: ', account.code)
           } catch (err) {
-            if (err && err.type === 'not-found') {
+            if (err instanceof recurly.errors.NotFoundError) {
               // If the request was not found, you may want to alert the user or
               // just return null
               console.log('Resource Not Found')
             }
-            // If we don't know what to do with the err, we should
-            // probably re-raise and let our web framework and logger handle it
-            throw err
           }
       - lang: Python
         source: |
@@ -1645,14 +1646,11 @@ paths:
             const account = await client.reactivateAccount(accountId)
             console.log('Reactivated account: ', account.code)
           } catch (err) {
-            if (err && err.type === 'not_found') {
+            if (err instanceof recurly.errors.NotFoundError) {
               // If the request was not found, you may want to alert the user or
               // just return null
               console.log('Resource Not Found')
             }
-            // If we don't know what to do with the err, we should
-            // probably re-raise and let our web framework and logger handle it
-            throw err
           }
       - lang: Python
         source: |
@@ -1970,8 +1968,8 @@ paths:
       summary: Set an account's billing information
       description: |
         If you're using Recurly.js to securely submit data from webforms without sending it through your server,
-        you can associate the billing information with an account by passing in the `token_id`. Be sure to only
-        set this field.
+        you can associate the billing information with an account by passing in the `token_id`. The only other
+        field permitted with `token_id` is `primary_payment_method`.
 
         For credit card payments you'll need the following required fields:
 
@@ -2246,6 +2244,221 @@ paths:
           {\n\t\tfmt.Printf(\"Resource not found: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
           Recurly error: %v\", e)\n\treturn nil, err\n}\n\nfmt.Printf(\"Removed Billing
           Info: %v\", billingInfo)"
+  "/sites/{site_id}/accounts/{account_id}/billing_infos":
+    get:
+      tags:
+      - account
+      - billing_info
+      operationId: list_billing_infos
+      summary: Get the list of billing information associated with 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"
+      - "$ref": "#/components/parameters/ids"
+      - "$ref": "#/components/parameters/sort_dates"
+      - "$ref": "#/components/parameters/filter_begin_time"
+      - "$ref": "#/components/parameters/filter_end_time"
+      responses:
+        '200':
+          description: A list of the the billing information for an account's
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/BillingInfoList"
+        '400':
+          description: Invalid or unpermitted parameter
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or account
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    post:
+      tags:
+      - account
+      - billing_info
+      operationId: create_billing_info
+      summary: Set an account's billing information when the wallet feature is enabled
+      description: |
+        If you're using Recurly.js to securely submit data from webforms without sending it through your server,
+        you can associate the billing information with an account by passing in the `token_id`. The only other
+        field permitted with `token_id` is `primary_payment_method`.
+
+        For credit card payments you'll need the following required fields:
+
+        - first_name
+        - last_name
+        - number
+        - month
+        - year
+
+        For external (not Recurly.js) tokenized payments you'll need the following required fields:
+
+        - first_name
+        - last_name
+        - gateway_token
+        - gateway_code
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/account_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/BillingInfoCreate"
+        required: true
+      responses:
+        '200':
+          description: Updated billing information.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/BillingInfo"
+        '400':
+          description: Bad request, perhaps invalid JSON?
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Invalid billing information, or error running the verification
+            transaction.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ErrorMayHaveTransaction"
+      x-code-samples: []
+  "/sites/{site_id}/accounts/{account_id}/billing_infos/{billing_info_id}":
+    get:
+      tags:
+      - account
+      - billing_info
+      operationId: get_a_billing_info
+      summary: Fetch a billing info
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/account_id"
+      - "$ref": "#/components/parameters/billing_info_id"
+      responses:
+        '200':
+          description: A billing info.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/BillingInfo"
+        '404':
+          description: Incorrect site, account, or billing info ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    put:
+      tags:
+      - account
+      - billing_info
+      operationId: update_a_billing_info
+      summary: Update an account's billing information
+      description: |
+        If you're using Recurly.js to securely submit data from webforms without sending it through your server,
+        you can associate the billing information with an account by passing in the `token_id`. The only other
+        field permitted with `token_id` is `primary_payment_method`.
+
+        For credit card payments you'll need the following required fields:
+
+        - first_name
+        - last_name
+        - number
+        - month
+        - year
+
+        For external (not Recurly.js) tokenized payments you'll need the following required fields:
+
+        - first_name
+        - last_name
+        - gateway_token
+        - gateway_code
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/account_id"
+      - "$ref": "#/components/parameters/billing_info_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/BillingInfoCreate"
+        required: true
+      responses:
+        '200':
+          description: Updated billing information.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/BillingInfo"
+        '400':
+          description: Bad request, perhaps invalid JSON?
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Invalid billing information, or error running the verification
+            transaction.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ErrorMayHaveTransaction"
+      x-code-samples: []
+    delete:
+      tags:
+      - account
+      - billing_info
+      operationId: remove_a_billing_info
+      summary: Remove an account's billing information
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/account_id"
+      - "$ref": "#/components/parameters/billing_info_id"
+      description: You may remove any stored billing information for an account. If
+        the account has a subscription, the renewal will go into dunning unless the
+        billing information is updated before the renewal occurs.
+      responses:
+        '204':
+          description: Billing information deleted
+        '404':
+          description: Account has no billing information, or incorrect site or account
+            ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Billing info cannot be deleted. Please set a new primary billing
+            info before deleting this billing info
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/sites/{site_id}/accounts/{account_id}/coupon_redemptions":
     get:
       tags:
@@ -2262,6 +2475,7 @@ paths:
       - "$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 the coupon redemptions on an account.
@@ -5475,6 +5689,156 @@ paths:
               schema:
                 "$ref": "#/components/schemas/Error"
       x-code-samples: []
+  "/sites/{site_id}/coupons/{coupon_id}/restore":
+    put:
+      tags:
+      - coupon
+      operationId: restore_coupon
+      summary: Restore an inactive coupon
+      description: Make an expired coupon redeemable again. You can change editable
+        fields in this call.
+      parameters:
+      - "$ref": "#/components/parameters/site_id"
+      - "$ref": "#/components/parameters/coupon_id"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/CouponUpdate"
+        required: true
+      responses:
+        '200':
+          description: The restored coupon.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Coupon"
+        '400':
+          description: Bad request, perhaps invalid JSON?
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '404':
+          description: Incorrect site or coupon 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:
+      - lang: Node.js
+        source: |
+          try {
+            const coupon = await client.restoreCoupon(couponId, {
+              name: "New Coupon Name"
+            })
+            console.log('Restored coupon: ', coupon.code)
+          } catch (err) {
+            if (err instanceof recurly.errors.NotFoundError) {
+              // If the request was not found, you may want to alert the user or
+              // just return null
+              console.log('Resource Not Found')
+            }
+
+          }
+      - lang: Python
+        source: |
+          try:
+              coupon = client.restore_coupon(coupon_id, {
+                  "name": "New Coupon Name"
+              })
+              print("Restored Coupon %s" % coupon)
+          except recurly.errors.NotFoundError:
+              # If the resource was not found, you may want to alert the user or
+              # just return nil
+              print("Resource Not Found")
+      - lang: ".NET"
+        source: |
+          try
+          {
+              var couponReq = new CouponUpdate() {
+                  Name = "New Coupon Name"
+              };
+              Coupon coupon = client.RestoreCoupon(couponId, couponReq);
+              Console.WriteLine($"Restored coupon {coupon.Code}");
+          }
+          catch (Recurly.Errors.Validation ex)
+          {
+              // If the request was not valid, you may want to tell your user
+              // why. You can find the invalid params and reasons in ex.Error.Params
+              Console.WriteLine($"Failed validation: {ex.Error.Message}");
+          }
+          catch (Recurly.Errors.ApiError ex)
+          {
+              // Use ApiError to catch a generic error from the API
+              Console.WriteLine($"Unexpected Recurly Error: {ex.Error.Message}");
+          }
+      - lang: Ruby
+        source: |
+          begin
+            coupon = @client.restore_coupon(coupon_id: coupon_id, body: {
+              name: "New Coupon Name"
+            })
+            puts "Restored coupon #{coupon}"
+          rescue Recurly::Errors::NotFoundError
+            # If the resource was not found, you may want to alert the user or
+            # just return nil
+            puts "Resource Not Found"
+          end
+      - lang: Java
+        source: |
+          try {
+              final CouponUpdate couponUpdate = new CouponUpdate();
+              couponUpdate.setName("New Coupon Name");
+
+              final Coupon coupon = client.restoreCoupon(couponId, couponUpdate);
+              System.out.println("Restored coupon: " + coupon.getCode());
+          } catch (ValidationException e) {
+              // If the request was not valid, you may want to tell your user
+              // why. You can find the invalid params and reasons in e.getError().getParams()
+              System.out.println("Failed validation: " + e.getError().getMessage());
+          } catch (ApiException e) {
+              // Use ApiException to catch a generic error from the API
+              System.out.println("Unexpected Recurly Error: " + e.getError().getMessage());
+          }
+      - lang: PHP
+        source: |
+          try {
+              $coupon_update = [
+                  "name" => "New Coupon Name"
+              ];
+              $coupon = $client->restoreCoupon($coupon_id, $coupon_update);
+
+              echo 'Restored Coupon:' . PHP_EOL;
+              var_dump($coupon);
+          } catch (\Recurly\Errors\NotFound $e) {
+              // Could not find the resource, you may want to inform the user
+              // or just return a NULL
+              echo 'Could not find resource.' . PHP_EOL;
+              var_dump($e);
+          } catch (\Recurly\RecurlyError $e) {
+              // Something bad happened... tell the user so that they can fix it?
+              echo 'Some unexpected Recurly error happened. Try again later.' . PHP_EOL;
+          }
+      - lang: Go
+        source: "updateReq := &recurly.CouponUpdate{\n\tName: recurly.String(\"New
+          Coupon Name\"),\n}\ncoupon, err := client.RestoreCoupon(couponId, updateReq)\nif
+          e, ok := err.(*recurly.Error); ok {\n\tif e.Type == recurly.ErrorTypeValidation
+          {\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(\"Restored Coupon:
+          %s\", coupon.Id)"
   "/sites/{site_id}/coupons/{coupon_id}/unique_coupon_codes":
     get:
       tags:
@@ -6473,14 +6837,11 @@ paths:
             const item = await client.deactivateItem(itemId)
             console.log('Deleted item: ', item.code)
           } catch (err) {
-            if (err && err.type === 'not-found') {
+            if (err instanceof recurly.errors.NotFoundError) {
               // If the request was not found, you may want to alert the user or
               // just return null
               console.log('Resource Not Found')
             }
-            // If we don't know what to do with the err, we should
-            // probably re-raise and let our web framework and logger handle it
-            throw err
           }
       - lang: Python
         source: |
@@ -6597,14 +6958,11 @@ paths:
             const item = await client.reactivateItem(itemId)
             console.log('Reactivated item: ', item.code)
           } catch (err) {
-            if (err && err.type === 'not_found') {
+            if (err instanceof recurly.errors.NotFoundError) {
               // If the request was not found, you may want to alert the user or
               // just return null
               console.log('Resource Not Found')
             }
-            // If we don't know what to do with the err, we should
-            // probably re-raise and let our web framework and logger handle it
-            throw err
           }
       - lang: Python
         source: |
@@ -11183,6 +11541,16 @@ paths:
           - partial
           - none
           default: none
+      - name: charge
+        in: query
+        description: Applicable only if the subscription has usage based add-ons and
+          unbilled usage logged for the current billing cycle. If true, current billing
+          cycle unbilled usage is billed on the final invoice. If false, Recurly will
+          create a negative usage record for current billing cycle usage that will
+          zero out the final invoice line items.
+        schema:
+          default: true
+          type: boolean
       responses:
         '200':
           description: An expired subscription.
@@ -13627,6 +13995,231 @@ 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:
+      - lang: Node.js
+        source: |
+          try {
+            const export_dates = await client.getExportDates()
+            export_dates.dates.forEach(date => {
+              console.log(`Exports are available for: ${date}`)
+            })
+          } catch (err) {
+            if (err instanceof recurly.ApiError) {
+              console.log('Unexpected error', err)
+            }
+          }
+      - lang: Python
+        source: |
+          try:
+              export_dates = client.get_export_dates()
+              for date in export_dates.dates:
+                  print( "Exports are available for: %s" % date)
+          except recurly.errors.NotFoundError:
+              # If the resource was not found, you may want to alert the user or
+              # just return nil
+              print("Resource Not Found")
+      - lang: ".NET"
+        source: |
+          try
+          {
+              ExportDates exportDates = client.GetExportDates();
+              foreach (var date in exportDates.Dates)
+              {
+                  System.Console.WriteLine($"Exports are available for: {date}");
+              }
+          }
+          catch (Recurly.Errors.ApiError ex)
+          {
+              // Use ApiError to catch a generic error from the API
+              Console.WriteLine($"Unexpected Recurly Error: {ex.Error.Message}");
+          }
+      - lang: Ruby
+        source: |
+          begin
+            export_dates = @client.get_export_dates()
+            export_dates.dates.each do |date|
+              puts "Exports are available for: #{date}"
+            end
+          rescue Recurly::Errors::NotFoundError
+            # If the resource was not found, you may want to alert the user or
+            # just return nil
+            puts "Resource Not Found"
+          end
+      - lang: Java
+        source: |
+          try {
+              ExportDates exportDates = client.getExportDates();
+              for (String date : exportDates.getDates()) {
+                  System.out.println("Exports are available for: " + date);
+              }
+          } catch (ApiException e) {
+              // Use ApiException to catch a generic error from the API
+              System.out.println("Unexpected Recurly Error: " + e.getError().getMessage());
+          }
+      - lang: PHP
+        source: |
+          try {
+              $export_dates = $client->getExportDates();
+              foreach($export_dates->getDates() as $date)
+              {
+                  echo "Exports are available for: {$date}" . PHP_EOL;
+              }
+          } catch (\Recurly\RecurlyError $e) {
+              echo 'Some unexpected Recurly error happened. Try again later.' . PHP_EOL;
+          }
+      - lang: Go
+        source: "exportDates, err := client.GetExportDates()\nif e, ok := err.(*recurly.Error);
+          ok {\n\tfmt.Printf(\"Unexpected Recurly error: %v\", e)\n\treturn nil, err\n}\n\nfor
+          _, date := range exportDates.Dates {\n\tfmt.Println(\"Exports are available
+          for: \", date)\n}"
+  "/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:
+      - lang: Node.js
+        source: |
+          try {
+            const export_files = await client.getExportFiles(export_date)
+            export_files.files.forEach(file => {
+              console.log(`Export file download URL: ${file.href}`)
+            })
+          } catch (err) {
+            if (err instanceof recurly.ApiError) {
+              console.log('Unexpected error', err)
+            }
+          }
+      - lang: Python
+        source: |
+          try:
+              export_files = client.get_export_files(export_date)
+              for file in export_files.files:
+                  print( "Export file download URL: %s" % file.href)
+          except recurly.errors.NotFoundError:
+              # If the resource was not found, you may want to alert the user or
+              # just return nil
+              print("Resource Not Found")
+      - lang: ".NET"
+        source: |
+          try
+          {
+              ExportFiles exportFiles = client.GetExportFiles(exportDate: exportDate);
+              foreach (var file in exportFiles.Files)
+              {
+                  System.Console.WriteLine($"Export file download URL: {file.Href}");
+              }
+          }
+          catch (Recurly.Errors.ApiError ex)
+          {
+              // Use ApiError to catch a generic error from the API
+              Console.WriteLine($"Unexpected Recurly Error: {ex.Error.Message}");
+          }
+      - lang: Ruby
+        source: |
+          begin
+            export_files = @client.get_export_files(export_date: export_date)
+            export_files.files.each do |file|
+              puts "Export file download URL: #{file.href}"
+            end
+          rescue Recurly::Errors::NotFoundError
+            # If the resource was not found, you may want to alert the user or
+            # just return nil
+            puts "Resource Not Found"
+          end
+      - lang: Java
+        source: |
+          try {
+              ExportFiles exportFiles = client.getExportFiles(exportDate);
+              for (ExportFile file : exportFiles.getFiles()) {
+                  System.out.println("Export file download URL: " + file.getHref());
+              }
+          } catch (ApiException e) {
+              // Use ApiException to catch a generic error from the API
+              System.out.println("Unexpected Recurly Error: " + e.getError());
+          }
+      - lang: PHP
+        source: |
+          try {
+              $export_files = $client->getExportFiles($export_date);
+              foreach($export_files->getFiles() as $file)
+              {
+                  echo "Export file download URL: {$file->getHref()}" . PHP_EOL;
+              }
+          } catch (\Recurly\RecurlyError $e) {
+              echo 'Some unexpected Recurly error happened. Try again later.' . PHP_EOL;
+          }
+      - lang: Go
+        source: "exportFiles, err := client.GetExportFiles(exportDate)\nif e, ok :=
+          err.(*recurly.Error); ok {\n\tfmt.Printf(\"Unexpected Recurly error: %v\",
+          e)\n\treturn nil, err\n}\n\nfor _, file := range exportFiles.Files {\n\tfmt.Println(\"Export
+          file download URL: \", file.Href)\n}"
 servers:
 - url: https://v3.recurly.com
 components:
@@ -13655,6 +14248,13 @@ components:
       required: true
       schema:
         type: string
+    billing_info_id:
+      name: billing_info_id
+      in: path
+      description: Billing Info ID.
+      required: true
+      schema:
+        type: string
     usage_id:
       name: usage_id
       in: path
@@ -13991,6 +14591,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
@@ -14074,6 +14682,23 @@ components:
           type: array
           items:
             "$ref": "#/components/schemas/AddOn"
+    BillingInfoList:
+      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/BillingInfo"
     CreditPaymentList:
       type: object
       properties:
@@ -14529,7 +15154,7 @@ components:
           maxLength: 255
         company:
           type: string
-          maxLength: 50
+          maxLength: 100
         vat_number:
           type: string
           description: The VAT number of the account (to avoid having the VAT applied).
@@ -15103,7 +15728,10 @@ components:
           - price
           - percentage
           title: Usage Type
-          description: Type of usage, required if `add_on_type` is `usage`.
+          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
@@ -15216,7 +15844,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
@@ -15426,6 +16056,16 @@ components:
             risk_rules_triggered:
               type: object
               title: Kount rules
+        primary_payment_method:
+          type: boolean
+          description: The `primary_payment_method` indicator is used to designate
+            the primary billing info on the account. The first billing info created
+            on an account will always become primary. Adding additional billing infos
+            provides the flexibility to mark another billing info as primary, or adding
+            additional non-primary billing infos. This can be accomplished by passing
+            the `primary_payment_method` indicator. When adding billing infos via
+            the billing_info and /accounts endpoints, this value is not permitted,
+            and will return an error if provided.
         created_at:
           type: string
           format: date-time
@@ -15566,6 +16206,28 @@ components:
           - checking
           - savings
           description: The bank account type. (ACH only)
+        tax_identifier:
+          type: string
+          description: Tax identifier is required if adding a billing info that is
+            a consumer card in Brazil. This would be the customer's CPF, CPF is a
+            Brazilian tax identifier for all tax paying residents.
+        tax_identifier_type:
+          type: string
+          enum:
+          - cpf
+          description: this field and a value of 'cpf' are required if adding a billing
+            info that is an elo or hipercard type in Brazil.
+        primary_payment_method:
+          type: boolean
+          title: Primary Payment Method
+          description: The `primary_payment_method` indicator is used to designate
+            the primary billing info on the account. The first billing info created
+            on an account will always become primary. Adding additional billing infos
+            provides the flexibility to mark another billing info as primary, or adding
+            additional non-primary billing infos. This can be accomplished by passing
+            the `primary_payment_method` indicator. When adding billing infos via
+            the billing_info and /accounts endpoints, this value is not permitted,
+            and will return an error if provided.
     Coupon:
       type: object
       properties:
@@ -15664,6 +16326,13 @@ components:
           description: The coupon is valid for all plans if true. If false then `plans`
             and `plans_names` will list the applicable plans.
           default: true
+        applies_to_all_items:
+          type: boolean
+          title: Applies to all items?
+          description: |
+            The coupon is valid for all items if true. If false then `items`
+            will list the applicable items.
+          default: false
         applies_to_non_plan_charges:
           type: boolean
           title: Applied to all non-plan charges?
@@ -15671,8 +16340,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:
@@ -15682,6 +16351,14 @@ components:
             `null` if `applies_to_all_plans=true`.
           items:
             "$ref": "#/components/schemas/PlanMini"
+        items:
+          type: array
+          title: Items
+          description: |
+            A list of items for which this coupon applies. This will be
+            `null` if `applies_to_all_items=true`.
+          items:
+            "$ref": "#/components/schemas/ItemMini"
         redemption_resource:
           type: string
           title: Redemption resource
@@ -15695,7 +16372,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.
@@ -15719,6 +16396,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
@@ -15801,6 +16487,16 @@ components:
               The coupon is valid for all plans if true. If false then
               `plans` and `plans_names` will list the applicable plans.
             default: true
+          applies_to_all_items:
+            type: boolean
+            title: Applies to all items?
+            description: |
+              To apply coupon to Items in your Catalog, include a list
+              of `item_codes` in the request that the coupon will apply to. Or set value
+              to true to apply to all Items in your Catalog. The following values
+              are not permitted when `applies_to_all_items` is included: `free_trial_amount`
+              and `free_trial_unit`.
+            default: false
           plan_codes:
             type: array
             title: Plan codes
@@ -15810,6 +16506,16 @@ components:
               when `applies_to_all_plans` is true.
             items:
               type: string
+          item_codes:
+            type: array
+            title: Item codes
+            description: |
+              List of item codes to which this coupon applies. Sending
+              `item_codes` is only permitted when `applies_to_all_items` is set to false.
+              The following values are not permitted when `item_codes` is included:
+              `free_trial_amount` and `free_trial_unit`.
+            items:
+              type: string
           duration:
             type: string
             title: Duration
@@ -15974,7 +16680,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.
@@ -16611,6 +17317,7 @@ components:
           - credit
           - gift_card
           - write_off
+          - prepayment
         state:
           type: string
           title: Invoice state
@@ -16625,6 +17332,13 @@ components:
           - voided
         account:
           "$ref": "#/components/schemas/AccountMini"
+        billing_info_id:
+          type: string
+          title: Billing info ID
+          description: The `billing_info_id` is the value that represents a specific
+            billing info for an end customer. When `billing_info_id` is used to assign
+            billing info to the subscription, all future billing events for the subscription
+            will bill to the specified billing info.
         subscription_ids:
           type: array
           title: Subscription IDs
@@ -16866,6 +17580,13 @@ components:
             mail order and telephone transactions.
           enum:
           - moto
+        billing_info_id:
+          type: string
+          title: Billing Info ID
+          description: The `billing_info_id` is the value that represents a specific
+            billing info for an end customer. When `billing_info_id` is used to assign
+            billing info to the subscription, all future billing events for the subscription
+            will bill to the specified billing info.
     InvoiceCollection:
       type: object
       title: Invoice collection
@@ -17579,12 +18300,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
@@ -18006,13 +18731,13 @@ components:
             the setup fee will be charged at the time of signup. Setup fees do not
             increase with the quantity of a subscription plan.
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
         unit_amount:
           type: number
           format: float
           title: Unit price
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
     PlanUpdate:
       type: object
       properties:
@@ -18145,11 +18870,6 @@ components:
           type: object
           title: Hosted pages settings
           "$ref": "#/components/schemas/PlanHostedPages"
-        add_ons:
-          type: array
-          title: Add Ons
-          items:
-            "$ref": "#/components/schemas/AddOnCreate"
         allow_any_item_on_subscriptions:
           type: boolean
           title: Allow any item on subscriptions
@@ -18170,7 +18890,7 @@ components:
           format: float
           title: Unit price
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
       required:
       - currency
       - unit_amount
@@ -18187,7 +18907,7 @@ components:
           format: float
           title: Unit price
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
       required:
       - currency
       - unit_amount
@@ -18696,6 +19416,8 @@ components:
         coupon_redemptions:
           type: array
           title: Coupon redemptions
+          description: Returns subscription level coupon redemptions that are tied
+            to this subscription.
           items:
             "$ref": "#/components/schemas/CouponRedemptionMini"
         pending_change:
@@ -18860,6 +19582,10 @@ components:
             set. This timestamp is used for alerting customers to reauthorize in 3
             years in accordance with NACHA rules. If a subscription becomes inactive
             or the billing info is no longer a bank account, this timestamp is cleared.
+        billing_info_id:
+          type: string
+          title: Billing Info ID
+          description: Billing Info ID.
     SubscriptionAddOn:
       type: object
       title: Subscription Add-on
@@ -18980,6 +19706,7 @@ components:
             * Optionally, override the add-on's default unit amount.
             * If the plan add-on's `tier_type` is `tiered`, `volume`, or `stairstep`, then `unit_amount` must be absent.
           minimum: 0
+          maximum: 1000000
         tiers:
           type: array
           title: Tiers
@@ -18990,7 +19717,8 @@ 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
@@ -18998,7 +19726,8 @@ components:
           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.
+            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
@@ -19051,6 +19780,7 @@ components:
           title: Unit amount
           description: Optionally, override the add-on's default unit amount.
           minimum: 0
+          maximum: 1000000
         tiers:
           type: array
           title: Tiers
@@ -19091,6 +19821,7 @@ components:
           format: float
           title: Unit amount
           minimum: 0
+          maximum: 1000000
     SubscriptionCancel:
       type: object
       properties:
@@ -19223,7 +19954,7 @@ components:
             the plan's default unit amount. The subscription's current currency will
             be used.
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
         quantity:
           type: integer
           title: Quantity
@@ -19348,6 +20079,13 @@ components:
             are provided the `plan_id` will be used.
         account:
           "$ref": "#/components/schemas/AccountCreate"
+        billing_info_id:
+          type: string
+          title: Billing Info ID
+          description: The `billing_info_id` is the value that represents a specific
+            billing info for an end customer. When `billing_info_id` is used to assign
+            billing info to the subscription, all future billing events for the subscription
+            will bill to the specified billing info.
         shipping:
           title: Shipping address
           description: Create a shipping address on the account and assign it to the
@@ -19373,7 +20111,7 @@ components:
             this value. If not provided, the subscription will inherit the price from
             the subscription plan for the provided currency.
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
         quantity:
           type: integer
           title: Quantity
@@ -19507,7 +20245,7 @@ components:
             this value in cents. If not provided, the subscription will inherit the
             price from the subscription plan for the provided currency.
           minimum: 0
-          maximum: 100000
+          maximum: 1000000
         quantity:
           type: integer
           title: Quantity
@@ -19650,6 +20388,13 @@ components:
           default: 0
         shipping:
           "$ref": "#/components/schemas/SubscriptionShippingUpdate"
+        billing_info_id:
+          type: string
+          title: Billing Info ID
+          description: The `billing_info_id` is the value that represents a specific
+            billing info for an end customer. When `billing_info_id` is used to assign
+            billing info to the subscription, all future billing events for the subscription
+            will bill to the specified billing info.
     SubscriptionPause:
       type: object
       properties:
@@ -20042,6 +20787,7 @@ components:
             to current datetime.
     UniqueCouponCode:
       type: object
+      description: A unique coupon code for a bulk coupon.
       properties:
         id:
           type: string
@@ -20064,6 +20810,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
@@ -20162,6 +20917,16 @@ components:
           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
@@ -20254,6 +21019,13 @@ components:
           maxLength: 3
         account:
           "$ref": "#/components/schemas/AccountPurchase"
+        billing_info_id:
+          type: string
+          title: Billing info ID
+          description: The `billing_info_id` is the value that represents a specific
+            billing info for an end customer. When `billing_info_id` is used to assign
+            billing info to the subscription, all future billing events for the subscription
+            will bill to the specified billing info.
         collection_method:
           type: string
           title: Collection method
@@ -20462,6 +21234,7 @@ components:
           - invalid_permissions
           - invalid_token
           - not_found
+          - service_not_available
           - simultaneous_request
           - transaction
           - unauthorized
@@ -20657,3 +21430,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.