From f30030ab501197a98c2dfc638b986f4a9dbf2e05 Mon Sep 17 00:00:00 2001
From: Richard DeMarco <richard.demarco@xero.com>
Date: Thu, 3 Nov 2022 10:43:52 -0600
Subject: [PATCH] update sdk to OAS version 31

---
 docs/v4/accounting/index.html                 |   6 +-
 docs/v4/appstore/index.html                   | 550 +++++++++++++++++-
 docs/v4/assets/index.html                     |   2 +-
 docs/v4/files/index.html                      |   2 +-
 docs/v4/finance/index.html                    |   2 +-
 docs/v4/payroll-au/index.html                 |   2 +-
 docs/v4/payroll-nz/index.html                 |   2 +-
 docs/v4/payroll-uk/index.html                 |   2 +-
 pom.xml                                       |   2 +-
 .../com/xero/api/client/AccountingApi.java    |   4 +-
 .../java/com/xero/api/client/AppStoreApi.java | 329 ++++++++++-
 .../java/com/xero/api/client/AssetApi.java    |   4 +-
 .../com/xero/api/client/BankFeedsApi.java     |   4 +-
 .../java/com/xero/api/client/FilesApi.java    |   4 +-
 .../java/com/xero/api/client/FinanceApi.java  |   4 +-
 .../java/com/xero/api/client/IdentityApi.java |   4 +-
 .../com/xero/api/client/PayrollAuApi.java     |   4 +-
 .../com/xero/api/client/PayrollNzApi.java     |   4 +-
 .../com/xero/api/client/PayrollUkApi.java     |   4 +-
 .../java/com/xero/api/client/ProjectApi.java  |   4 +-
 .../com/xero/models/accounting/LineItem.java  |  67 ++-
 .../models/appstore/CreateUsageRecord.java    | 148 +++++
 .../models/appstore/UpdateUsageRecord.java    | 105 ++++
 .../com/xero/models/appstore/UsageRecord.java | 385 ++++++++++++
 .../models/appstore/UsageRecordsList.java     | 110 ++++
 25 files changed, 1690 insertions(+), 64 deletions(-)
 create mode 100644 src/main/java/com/xero/models/appstore/CreateUsageRecord.java
 create mode 100644 src/main/java/com/xero/models/appstore/UpdateUsageRecord.java
 create mode 100644 src/main/java/com/xero/models/appstore/UsageRecord.java
 create mode 100644 src/main/java/com/xero/models/appstore/UsageRecordsList.java

diff --git a/docs/v4/accounting/index.html b/docs/v4/accounting/index.html
index de30604c..4c9f99c7 100644
--- a/docs/v4/accounting/index.html
+++ b/docs/v4/accounting/index.html
@@ -3575,7 +3575,7 @@
     },
     "LineAmount" : {
       "type" : "number",
-      "description" : "If you wish to omit either of the <Quantity> or <UnitAmount> you can provide a LineAmount and Xero will calculate the missing amount for you. The line amount reflects the discounted price if a DiscountRate has been used . i.e LineAmount = Quantity * Unit Amount * ((100 – DiscountRate)/100)",
+      "description" : "If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero will calculate the missing amount for you. The line amount reflects the discounted price if either a DiscountRate or DiscountAmount has been used i.e. LineAmount = Quantity * Unit Amount * ((100 - DiscountRate)/100) or LineAmount = (Quantity * UnitAmount) - DiscountAmount",
       "format" : "double",
       "x-is-money" : true
     },
@@ -3594,7 +3594,7 @@
     },
     "DiscountAmount" : {
       "type" : "number",
-      "description" : "Discount amount being applied to a line item. Only supported on ACCREC invoices - ACCPAY invoices and credit notes in Xero do not support discounts.",
+      "description" : "Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes. ACCPAY invoices and credit notes in Xero do not support discounts.",
       "format" : "double",
       "x-is-money" : true
     },
@@ -6065,7 +6065,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="Accounting"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="Accounting"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="Accounting"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="Accounting"><a href="#api-Accounting">Methods</a></li>
               <li data-group="Accounting" data-name="createAccount" class="">
                 <a href="#api-Accounting-createAccount">createAccount</a>
diff --git a/docs/v4/appstore/index.html b/docs/v4/appstore/index.html
index b4c5b3ef..847eb04a 100644
--- a/docs/v4/appstore/index.html
+++ b/docs/v4/appstore/index.html
@@ -860,6 +860,24 @@
     <script>
       // Script section to load models into a JS Var
       var defs = {}
+      defs["CreateUsageRecord"] = {
+  "title" : "",
+  "required" : [ "quantity", "timestamp" ],
+  "type" : "object",
+  "properties" : {
+    "quantity" : {
+      "type" : "integer",
+      "description" : "The initial quantity for the usage record. Must be a whole number that is greater than or equal to 0",
+      "format" : "int32"
+    },
+    "timestamp" : {
+      "type" : "string",
+      "description" : "DateTime in UTC of when the the product was consumed/used",
+      "format" : "date-time"
+    }
+  },
+  "description" : "Data transfer object for public create usage end point"
+};
       defs["Plan"] = {
   "title" : "",
   "required" : [ "id", "name", "status", "subscriptionItems" ],
@@ -1056,6 +1074,81 @@
   },
   "description" : ""
 };
+      defs["UpdateUsageRecord"] = {
+  "title" : "",
+  "required" : [ "quantity" ],
+  "type" : "object",
+  "properties" : {
+    "quantity" : {
+      "type" : "integer",
+      "description" : "The new quantity for the usage record. Must be a whole number that is greater than or equal to 0",
+      "format" : "int32"
+    }
+  },
+  "description" : "Data transfer object for public update usage end point"
+};
+      defs["UsageRecord"] = {
+  "title" : "",
+  "required" : [ "pricePerUnit", "productId", "quantity", "recordedAt", "subscriptionId", "subscriptionItemId", "testMode", "usageRecordId" ],
+  "type" : "object",
+  "properties" : {
+    "quantity" : {
+      "type" : "integer",
+      "description" : "The quantity recorded",
+      "format" : "int32"
+    },
+    "subscriptionId" : {
+      "type" : "string",
+      "description" : "The unique identifier of the Subscription.",
+      "format" : "guid"
+    },
+    "subscriptionItemId" : {
+      "type" : "string",
+      "description" : "The unique identifier of the SubscriptionItem.",
+      "format" : "guid"
+    },
+    "testMode" : {
+      "type" : "boolean",
+      "description" : "If the subscription is a test subscription"
+    },
+    "recordedAt" : {
+      "type" : "string",
+      "description" : "The time when this usage was recorded in UTC",
+      "format" : "date-time"
+    },
+    "usageRecordId" : {
+      "type" : "string",
+      "description" : "The unique identifier of the usageRecord.",
+      "format" : "guid"
+    },
+    "pricePerUnit" : {
+      "type" : "number",
+      "description" : "The price per unit",
+      "format" : "decimal"
+    },
+    "productId" : {
+      "type" : "string",
+      "description" : "The unique identifier of the linked Product",
+      "format" : "guid"
+    }
+  },
+  "description" : ""
+};
+      defs["UsageRecordsList"] = {
+  "title" : "",
+  "required" : [ "usageRecords" ],
+  "type" : "object",
+  "properties" : {
+    "usageRecords" : {
+      "type" : "array",
+      "description" : "A collection of usage records",
+      "items" : {
+        "$ref" : "#/components/schemas/UsageRecord"
+      }
+    }
+  },
+  "description" : "Response to get usage record"
+};
       
       var errs = {};
       
@@ -1137,11 +1230,20 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="AppStore"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="AppStore"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="AppStore"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="AppStore"><a href="#api-AppStore">Methods</a></li>
               <li data-group="AppStore" data-name="getSubscription" class="">
                 <a href="#api-AppStore-getSubscription">getSubscription</a>
               </li>
+              <li data-group="AppStore" data-name="getUsageRecords" class="">
+                <a href="#api-AppStore-getUsageRecords">getUsageRecords</a>
+              </li>
+              <li data-group="AppStore" data-name="postUsageRecords" class="">
+                <a href="#api-AppStore-postUsageRecords">postUsageRecords</a>
+              </li>
+              <li data-group="AppStore" data-name="putUsageRecords" class="">
+                <a href="#api-AppStore-putUsageRecords">putUsageRecords</a>
+              </li>
             </ul>
           </nav>
         </div>
@@ -1256,6 +1358,452 @@ <h2>Parameters</h2>
                 </article>
               </div>
               <hr>
+              <div id="api-AppStore-getUsageRecords">
+                <article id="api-AppStore-getUsageRecords-0" data-group="User" data-name="getUsageRecords" data-version="0">
+                  <div class="pull-left">
+                    <h1>getUsageRecords</h1>
+                    <p>Gets all usage records related to the subscription</p>
+                  </div>
+                  <div class="pull-right"></div>
+                  <div class="clearfix"></div>
+                  <p></p>
+                  <p class="marked"></p>
+                  <p></p>
+                  <br />
+                  <pre class="prettyprint language-html prettyprinted" data-type="get"><code><span class="pln">/subscriptions/{subscriptionId}/usage-records</span></code></pre>
+                  <p>
+                  <h3>Usage and SDK Samples</h3>
+                  </p>
+                  <ul class="nav nav-tabs nav-tabs-examples">
+                    <li class=""><a href="#examples-AppStore-getUsageRecords-0-java">Java</a></li>
+                  </ul>
+                  <div class="tab-content">
+                    <div class="tab-pane" id="examples-AppStore-getUsageRecords-0-java">
+                      <pre class="prettyprint"><code class="language-java">import org.openapitools.client.api.*;
+import org.openapitools.client.api.client.AppStoreApi;
+import org.openapitools.client.models.appStore.*;
+
+import java.io.File;
+import java.util.*;
+
+public class AppStoreApiExample {
+    private AppStoreApi apiInstance;
+    
+    public static void main(String[] args) {
+        String accessToken = "YOUR_ACCESS_TOKEN";
+        ApiClient defaultClient = new ApiClient();
+
+        apiInstance = AccountingApi.getInstance(defaultClient);
+        UUID subscriptionId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID subscriptionId = '00000000-0000-0000-0000-000000000000';
+
+        try {
+            UsageRecordsList result = apiInstance.getUsageRecords(accessToken, subscriptionId);
+            System.out.println(result);
+        } catch (XeroException e) {
+            System.err.println("Exception when calling AppStoreApi#getUsageRecords");
+            e.printStackTrace();
+        }
+    }
+}</code></pre>
+                    </div>
+                  </div>
+                  <h2>Scopes</h2>
+                  <table>
+                    
+                    <tr>
+                      <td>marketplace.billing</td>
+                      <td>Grant read-only access to fixed assets</td>
+                    </tr>
+                    
+                  </table>
+                  <h2>Parameters</h2>
+                  <div class="methodsubtabletitle">Path parameters</div>
+                  <table id="methodsubtable">
+                    <tr>
+                      <th width="150px">Name</th>
+                      <th>Description</th>
+                    </tr>
+                    <tr><td style="width:150px;">subscriptionId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_getUsageRecords_subscriptionId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+Unique identifier for Subscription object
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                  </table>
+                </article>
+              </div>
+              <hr>
+              <div id="api-AppStore-postUsageRecords">
+                <article id="api-AppStore-postUsageRecords-0" data-group="User" data-name="postUsageRecords" data-version="0">
+                  <div class="pull-left">
+                    <h1>postUsageRecords</h1>
+                    <p>Send metered usage belonging to this subscription and subscription item</p>
+                  </div>
+                  <div class="pull-right"></div>
+                  <div class="clearfix"></div>
+                  <p></p>
+                  <p class="marked"></p>
+                  <p></p>
+                  <br />
+                  <pre class="prettyprint language-html prettyprinted" data-type="post"><code><span class="pln">/subscriptions/{subscriptionId}/items/{subscriptionItemId}/usage-records</span></code></pre>
+                  <p>
+                  <h3>Usage and SDK Samples</h3>
+                  </p>
+                  <ul class="nav nav-tabs nav-tabs-examples">
+                    <li class=""><a href="#examples-AppStore-postUsageRecords-0-java">Java</a></li>
+                  </ul>
+                  <div class="tab-content">
+                    <div class="tab-pane" id="examples-AppStore-postUsageRecords-0-java">
+                      <pre class="prettyprint"><code class="language-java">import org.openapitools.client.api.*;
+import org.openapitools.client.api.client.AppStoreApi;
+import org.openapitools.client.models.appStore.*;
+
+import java.io.File;
+import java.util.*;
+
+public class AppStoreApiExample {
+    private AppStoreApi apiInstance;
+    
+    public static void main(String[] args) {
+        String accessToken = "YOUR_ACCESS_TOKEN";
+        ApiClient defaultClient = new ApiClient();
+
+        apiInstance = AccountingApi.getInstance(defaultClient);
+        UUID subscriptionId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID subscriptionId = '00000000-0000-0000-0000-000000000000';
+        UUID subscriptionItemId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID subscriptionItemId = '00000000-0000-0000-0000-000000000000';
+
+        try {
+            UsageRecord result = apiInstance.postUsageRecords(accessToken, subscriptionId, subscriptionItemId, createUsageRecord);
+            System.out.println(result);
+        } catch (XeroException e) {
+            System.err.println("Exception when calling AppStoreApi#postUsageRecords");
+            e.printStackTrace();
+        }
+    }
+}</code></pre>
+                    </div>
+                  </div>
+                  <h2>Scopes</h2>
+                  <table>
+                    
+                    <tr>
+                      <td>marketplace.billing</td>
+                      <td>Grant read-only access to fixed assets</td>
+                    </tr>
+                    
+                  </table>
+                  <h2>Parameters</h2>
+                  <div class="methodsubtabletitle">Path parameters</div>
+                  <table id="methodsubtable">
+                    <tr>
+                      <th width="150px">Name</th>
+                      <th>Description</th>
+                    </tr>
+                    <tr><td style="width:150px;">subscriptionId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_postUsageRecords_subscriptionId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+Unique identifier for Subscription object
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                    <tr><td style="width:150px;">subscriptionItemId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_postUsageRecords_subscriptionItemId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+The unique identifier of the subscriptionItem
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                  </table>
+                  <div class="methodsubtabletitle">Body parameters</div>
+                  <table id="methodsubtable">
+                    <tr>
+                      <th width="150px">Name</th>
+                      <th>Description</th>
+                    </tr>
+                    <tr>
+  <td style="width:150px;">createUsageRecord <span style="color:red;">*</span></td>
+  <td>
+    <div class="json-schema-view">
+      <div class="primitive">
+        <span class="type">
+        CreateUsageRecord
+        </span>
+        <div class="inner description marked">
+          Contains the quantity for the usage record to create
+        </div>
+      </div>
+      <div class="inner required">
+        Required
+      </div>
+    </div>
+    <script type="application/ld+json">
+      {
+  "description" : "Contains the quantity for the usage record to create",
+  "content" : {
+    "application/json" : {
+      "schema" : {
+        "$ref" : "#/components/schemas/CreateUsageRecord"
+      },
+      "example" : "{ \"timestamp\": \"2022-01-21T13:01:00Z\", \"quantity\": 10 }"
+    }
+  },
+  "required" : true
+}
+    </script>
+                  </table>
+                </article>
+              </div>
+              <hr>
+              <div id="api-AppStore-putUsageRecords">
+                <article id="api-AppStore-putUsageRecords-0" data-group="User" data-name="putUsageRecords" data-version="0">
+                  <div class="pull-left">
+                    <h1>putUsageRecords</h1>
+                    <p>Update and existing metered usage belonging to this subscription and subscription item</p>
+                  </div>
+                  <div class="pull-right"></div>
+                  <div class="clearfix"></div>
+                  <p></p>
+                  <p class="marked"></p>
+                  <p></p>
+                  <br />
+                  <pre class="prettyprint language-html prettyprinted" data-type="put"><code><span class="pln">/subscriptions/{subscriptionId}/items/{subscriptionItemId}/usage-records/{usageRecordId}</span></code></pre>
+                  <p>
+                  <h3>Usage and SDK Samples</h3>
+                  </p>
+                  <ul class="nav nav-tabs nav-tabs-examples">
+                    <li class=""><a href="#examples-AppStore-putUsageRecords-0-java">Java</a></li>
+                  </ul>
+                  <div class="tab-content">
+                    <div class="tab-pane" id="examples-AppStore-putUsageRecords-0-java">
+                      <pre class="prettyprint"><code class="language-java">import org.openapitools.client.api.*;
+import org.openapitools.client.api.client.AppStoreApi;
+import org.openapitools.client.models.appStore.*;
+
+import java.io.File;
+import java.util.*;
+
+public class AppStoreApiExample {
+    private AppStoreApi apiInstance;
+    
+    public static void main(String[] args) {
+        String accessToken = "YOUR_ACCESS_TOKEN";
+        ApiClient defaultClient = new ApiClient();
+
+        apiInstance = AccountingApi.getInstance(defaultClient);
+        UUID subscriptionId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID subscriptionId = '00000000-0000-0000-0000-000000000000';
+        UUID subscriptionItemId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID subscriptionItemId = '00000000-0000-0000-0000-000000000000';
+        UUID usageRecordId = UUID.fromString("00000000-0000-0000-0000-000000000000");
+        UUID usageRecordId = '00000000-0000-0000-0000-000000000000';
+
+        try {
+            UsageRecord result = apiInstance.putUsageRecords(accessToken, subscriptionId, subscriptionItemId, usageRecordId, updateUsageRecord);
+            System.out.println(result);
+        } catch (XeroException e) {
+            System.err.println("Exception when calling AppStoreApi#putUsageRecords");
+            e.printStackTrace();
+        }
+    }
+}</code></pre>
+                    </div>
+                  </div>
+                  <h2>Scopes</h2>
+                  <table>
+                    
+                    <tr>
+                      <td>marketplace.billing</td>
+                      <td>Grant read-only access to fixed assets</td>
+                    </tr>
+                    
+                  </table>
+                  <h2>Parameters</h2>
+                  <div class="methodsubtabletitle">Path parameters</div>
+                  <table id="methodsubtable">
+                    <tr>
+                      <th width="150px">Name</th>
+                      <th>Description</th>
+                    </tr>
+                    <tr><td style="width:150px;">subscriptionId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_putUsageRecords_subscriptionId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+Unique identifier for Subscription object
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                    <tr><td style="width:150px;">subscriptionItemId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_putUsageRecords_subscriptionItemId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+The unique identifier of the subscriptionItem
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                    <tr><td style="width:150px;">usageRecordId<span style="color:red;">*</span></td>
+<td>
+
+
+    <div id="d2e199_putUsageRecords_usageRecordId">
+        <div class="json-schema-view">
+            <div class="primitive">
+                <span class="type">
+                    UUID
+                </span>
+                    <span class="format">
+                        (uuid)
+                    </span>
+
+                    <div class="inner description marked">
+The unique identifier of the usage record
+                    </div>
+            </div>
+                <div class="inner required">
+                    Required
+                </div>
+        </div>
+    </div>
+</td>
+</tr>
+
+                  </table>
+                  <div class="methodsubtabletitle">Body parameters</div>
+                  <table id="methodsubtable">
+                    <tr>
+                      <th width="150px">Name</th>
+                      <th>Description</th>
+                    </tr>
+                    <tr>
+  <td style="width:150px;">updateUsageRecord <span style="color:red;">*</span></td>
+  <td>
+    <div class="json-schema-view">
+      <div class="primitive">
+        <span class="type">
+        UpdateUsageRecord
+        </span>
+        <div class="inner description marked">
+          Contains the quantity for the usage record to update
+        </div>
+      </div>
+      <div class="inner required">
+        Required
+      </div>
+    </div>
+    <script type="application/ld+json">
+      {
+  "description" : "Contains the quantity for the usage record to update",
+  "content" : {
+    "application/json" : {
+      "schema" : {
+        "$ref" : "#/components/schemas/UpdateUsageRecord"
+      },
+      "example" : "{ \"quantity\": 10 }"
+    }
+  },
+  "required" : true
+}
+    </script>
+                  </table>
+                </article>
+              </div>
+              <hr>
             </section>
           </div>
           <div id="footer">
diff --git a/docs/v4/assets/index.html b/docs/v4/assets/index.html
index 5250b4bc..7cc63bff 100644
--- a/docs/v4/assets/index.html
+++ b/docs/v4/assets/index.html
@@ -1388,7 +1388,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="Asset"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="Asset"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="Asset"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="Asset"><a href="#api-Asset">Methods</a></li>
               <li data-group="Asset" data-name="createAsset" class="">
                 <a href="#api-Asset-createAsset">createAsset</a>
diff --git a/docs/v4/files/index.html b/docs/v4/files/index.html
index 9a354002..c91ba32c 100644
--- a/docs/v4/files/index.html
+++ b/docs/v4/files/index.html
@@ -1129,7 +1129,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="Files"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="Files"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="Files"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="Files"><a href="#api-Files">Methods</a></li>
               <li data-group="Files" data-name="createFileAssociation" class="">
                 <a href="#api-Files-createFileAssociation">createFileAssociation</a>
diff --git a/docs/v4/finance/index.html b/docs/v4/finance/index.html
index 9fc643bf..cef0faa9 100644
--- a/docs/v4/finance/index.html
+++ b/docs/v4/finance/index.html
@@ -2714,7 +2714,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="Finance"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="Finance"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="Finance"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="Finance"><a href="#api-Finance">Methods</a></li>
               <li data-group="Finance" data-name="getAccountingActivityAccountUsage" class="">
                 <a href="#api-Finance-getAccountingActivityAccountUsage">getAccountingActivityAccountUsage</a>
diff --git a/docs/v4/payroll-au/index.html b/docs/v4/payroll-au/index.html
index 6f3508ec..956d98d2 100644
--- a/docs/v4/payroll-au/index.html
+++ b/docs/v4/payroll-au/index.html
@@ -3343,7 +3343,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="PayrollAu"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="PayrollAu"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="PayrollAu"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="PayrollAu"><a href="#api-PayrollAu">Methods</a></li>
               <li data-group="PayrollAu" data-name="createEmployee" class="">
                 <a href="#api-PayrollAu-createEmployee">createEmployee</a>
diff --git a/docs/v4/payroll-nz/index.html b/docs/v4/payroll-nz/index.html
index 566253b0..c7228d1b 100644
--- a/docs/v4/payroll-nz/index.html
+++ b/docs/v4/payroll-nz/index.html
@@ -3834,7 +3834,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="PayrollNz"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="PayrollNz"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="PayrollNz"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="PayrollNz"><a href="#api-PayrollNz">Methods</a></li>
               <li data-group="PayrollNz" data-name="approveTimesheet" class="">
                 <a href="#api-PayrollNz-approveTimesheet">approveTimesheet</a>
diff --git a/docs/v4/payroll-uk/index.html b/docs/v4/payroll-uk/index.html
index 79d0492c..d1b21f7d 100644
--- a/docs/v4/payroll-uk/index.html
+++ b/docs/v4/payroll-uk/index.html
@@ -3506,7 +3506,7 @@
           <nav id="scrollingNav">
             <ul class="sidenav nav nav-list">
               <li class="nav-header" data-group="PayrollUk"><strong>SDK: </strong><span id='sdk-name'></span></li>
-              <li class="nav-header" data-group="PayrollUk"><strong>VSN: </strong>4.22.0</li>
+              <li class="nav-header" data-group="PayrollUk"><strong>VSN: </strong>4.23.0</li>
               <li class="nav-header" data-group="PayrollUk"><a href="#api-PayrollUk">Methods</a></li>
               <li data-group="PayrollUk" data-name="approveTimesheet" class="">
                 <a href="#api-PayrollUk-approveTimesheet">approveTimesheet</a>
diff --git a/pom.xml b/pom.xml
index 49be9416..a763c535 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
     <artifactId>xero-java</artifactId>
     <packaging>jar</packaging>
     <name>xero-java</name>
-    <version>4.22.0</version>
+    <version>4.23.0</version>
     <url>https://github.com/XeroAPI/Xero-Java</url>
     <description>This is the official Java SDK for Xero API</description>
     <licenses>
diff --git a/src/main/java/com/xero/api/client/AccountingApi.java b/src/main/java/com/xero/api/client/AccountingApi.java
index 3e867fe4..3e6e5fb9 100644
--- a/src/main/java/com/xero/api/client/AccountingApi.java
+++ b/src/main/java/com/xero/api/client/AccountingApi.java
@@ -2,7 +2,7 @@
  * Xero Accounting API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -101,7 +101,7 @@ public class AccountingApi {
   private ApiClient apiClient;
   private static AccountingApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(AccountingApi.class);
 
   /** AccountingApi */
diff --git a/src/main/java/com/xero/api/client/AppStoreApi.java b/src/main/java/com/xero/api/client/AppStoreApi.java
index 256a8ce4..7e6b0cc0 100644
--- a/src/main/java/com/xero/api/client/AppStoreApi.java
+++ b/src/main/java/com/xero/api/client/AppStoreApi.java
@@ -2,7 +2,7 @@
  * Xero AppStore API
  * These endpoints are for Xero Partners to interact with the App Store Billing platform
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -25,7 +25,11 @@
 import com.google.api.client.http.HttpTransport;
 import com.xero.api.ApiClient;
 import com.xero.api.XeroApiExceptionHandler;
+import com.xero.models.appstore.CreateUsageRecord;
 import com.xero.models.appstore.Subscription;
+import com.xero.models.appstore.UpdateUsageRecord;
+import com.xero.models.appstore.UsageRecord;
+import com.xero.models.appstore.UsageRecordsList;
 import java.io.ByteArrayInputStream;
 import java.io.IOException;
 import java.io.InputStream;
@@ -42,7 +46,7 @@ public class AppStoreApi {
   private ApiClient apiClient;
   private static AppStoreApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(AppStoreApi.class);
 
   /** AppStoreApi */
@@ -192,6 +196,327 @@ public HttpResponse getSubscriptionForHttpResponse(String accessToken, UUID subs
         .execute();
   }
 
+  /**
+   * Gets all usage records related to the subscription
+   *
+   * <p><b>200</b> - Success - return a list of all usage record submitted against this subscription
+   * for this subscription period
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param accessToken Authorization token for user set in header of each request
+   * @return UsageRecordsList
+   * @throws IOException if an error occurs while attempting to invoke the API *
+   */
+  public UsageRecordsList getUsageRecords(String accessToken, UUID subscriptionId)
+      throws IOException {
+    try {
+      TypeReference<UsageRecordsList> typeRef = new TypeReference<UsageRecordsList>() {};
+      HttpResponse response = getUsageRecordsForHttpResponse(accessToken, subscriptionId);
+      return apiClient.getObjectMapper().readValue(response.getContent(), typeRef);
+    } catch (HttpResponseException e) {
+      if (logger.isDebugEnabled()) {
+        logger.debug(
+            "------------------ HttpResponseException "
+                + e.getStatusCode()
+                + " : getUsageRecords -------------------");
+        logger.debug(e.toString());
+      }
+      XeroApiExceptionHandler handler = new XeroApiExceptionHandler();
+      handler.execute(e);
+    } catch (IOException ioe) {
+      throw ioe;
+    }
+    return null;
+  }
+
+  /**
+   * Gets all usage records related to the subscription
+   *
+   * <p><b>200</b> - Success - return a list of all usage record submitted against this subscription
+   * for this subscription period
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param accessToken Authorization token for user set in header of each request
+   * @return HttpResponse
+   * @throws IOException if an error occurs while attempting to invoke the API
+   */
+  public HttpResponse getUsageRecordsForHttpResponse(String accessToken, UUID subscriptionId)
+      throws IOException {
+    // verify the required parameter 'subscriptionId' is set
+    if (subscriptionId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'subscriptionId' when calling getUsageRecords");
+    }
+    if (accessToken == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'accessToken' when calling getUsageRecords");
+    }
+    HttpHeaders headers = new HttpHeaders();
+    headers.setAccept("application/json");
+    headers.setUserAgent(this.getUserAgent());
+    // create a map of path variables
+    final Map<String, Object> uriVariables = new HashMap<String, Object>();
+    uriVariables.put("subscriptionId", subscriptionId);
+
+    UriBuilder uriBuilder =
+        UriBuilder.fromUri(
+            apiClient.getBasePath() + "/subscriptions/{subscriptionId}/usage-records");
+    String url = uriBuilder.buildFromMap(uriVariables).toString();
+    GenericUrl genericUrl = new GenericUrl(url);
+    if (logger.isDebugEnabled()) {
+      logger.debug("GET " + genericUrl.toString());
+    }
+
+    HttpContent content = null;
+    Credential credential =
+        new Credential(BearerToken.authorizationHeaderAccessMethod()).setAccessToken(accessToken);
+    HttpTransport transport = apiClient.getHttpTransport();
+    HttpRequestFactory requestFactory = transport.createRequestFactory(credential);
+    return requestFactory
+        .buildRequest(HttpMethods.GET, genericUrl, content)
+        .setHeaders(headers)
+        .setConnectTimeout(apiClient.getConnectionTimeout())
+        .setReadTimeout(apiClient.getReadTimeout())
+        .execute();
+  }
+
+  /**
+   * Send metered usage belonging to this subscription and subscription item
+   *
+   * <p><b>200</b> - Success - return response of the record submitted
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param subscriptionItemId The unique identifier of the subscriptionItem
+   * @param createUsageRecord Contains the quantity for the usage record to create
+   * @param accessToken Authorization token for user set in header of each request
+   * @return UsageRecord
+   * @throws IOException if an error occurs while attempting to invoke the API *
+   */
+  public UsageRecord postUsageRecords(
+      String accessToken,
+      UUID subscriptionId,
+      UUID subscriptionItemId,
+      CreateUsageRecord createUsageRecord)
+      throws IOException {
+    try {
+      TypeReference<UsageRecord> typeRef = new TypeReference<UsageRecord>() {};
+      HttpResponse response =
+          postUsageRecordsForHttpResponse(
+              accessToken, subscriptionId, subscriptionItemId, createUsageRecord);
+      return apiClient.getObjectMapper().readValue(response.getContent(), typeRef);
+    } catch (HttpResponseException e) {
+      if (logger.isDebugEnabled()) {
+        logger.debug(
+            "------------------ HttpResponseException "
+                + e.getStatusCode()
+                + " : postUsageRecords -------------------");
+        logger.debug(e.toString());
+      }
+      XeroApiExceptionHandler handler = new XeroApiExceptionHandler();
+      handler.execute(e);
+    } catch (IOException ioe) {
+      throw ioe;
+    }
+    return null;
+  }
+
+  /**
+   * Send metered usage belonging to this subscription and subscription item
+   *
+   * <p><b>200</b> - Success - return response of the record submitted
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param subscriptionItemId The unique identifier of the subscriptionItem
+   * @param createUsageRecord Contains the quantity for the usage record to create
+   * @param accessToken Authorization token for user set in header of each request
+   * @return HttpResponse
+   * @throws IOException if an error occurs while attempting to invoke the API
+   */
+  public HttpResponse postUsageRecordsForHttpResponse(
+      String accessToken,
+      UUID subscriptionId,
+      UUID subscriptionItemId,
+      CreateUsageRecord createUsageRecord)
+      throws IOException {
+    // verify the required parameter 'subscriptionId' is set
+    if (subscriptionId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'subscriptionId' when calling postUsageRecords");
+    } // verify the required parameter 'subscriptionItemId' is set
+    if (subscriptionItemId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'subscriptionItemId' when calling postUsageRecords");
+    } // verify the required parameter 'createUsageRecord' is set
+    if (createUsageRecord == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'createUsageRecord' when calling postUsageRecords");
+    }
+    if (accessToken == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'accessToken' when calling postUsageRecords");
+    }
+    HttpHeaders headers = new HttpHeaders();
+    headers.setAccept("application/json");
+    headers.setUserAgent(this.getUserAgent());
+    // create a map of path variables
+    final Map<String, Object> uriVariables = new HashMap<String, Object>();
+    uriVariables.put("subscriptionId", subscriptionId);
+    uriVariables.put("subscriptionItemId", subscriptionItemId);
+
+    UriBuilder uriBuilder =
+        UriBuilder.fromUri(
+            apiClient.getBasePath()
+                + "/subscriptions/{subscriptionId}/items/{subscriptionItemId}/usage-records");
+    String url = uriBuilder.buildFromMap(uriVariables).toString();
+    GenericUrl genericUrl = new GenericUrl(url);
+    if (logger.isDebugEnabled()) {
+      logger.debug("POST " + genericUrl.toString());
+    }
+
+    HttpContent content = null;
+    content = apiClient.new JacksonJsonHttpContent(createUsageRecord);
+
+    Credential credential =
+        new Credential(BearerToken.authorizationHeaderAccessMethod()).setAccessToken(accessToken);
+    HttpTransport transport = apiClient.getHttpTransport();
+    HttpRequestFactory requestFactory = transport.createRequestFactory(credential);
+    return requestFactory
+        .buildRequest(HttpMethods.POST, genericUrl, content)
+        .setHeaders(headers)
+        .setConnectTimeout(apiClient.getConnectionTimeout())
+        .setReadTimeout(apiClient.getReadTimeout())
+        .execute();
+  }
+
+  /**
+   * Update and existing metered usage belonging to this subscription and subscription item
+   *
+   * <p><b>200</b> - Success - return response of the modified record
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param subscriptionItemId The unique identifier of the subscriptionItem
+   * @param usageRecordId The unique identifier of the usage record
+   * @param updateUsageRecord Contains the quantity for the usage record to update
+   * @param accessToken Authorization token for user set in header of each request
+   * @return UsageRecord
+   * @throws IOException if an error occurs while attempting to invoke the API *
+   */
+  public UsageRecord putUsageRecords(
+      String accessToken,
+      UUID subscriptionId,
+      UUID subscriptionItemId,
+      UUID usageRecordId,
+      UpdateUsageRecord updateUsageRecord)
+      throws IOException {
+    try {
+      TypeReference<UsageRecord> typeRef = new TypeReference<UsageRecord>() {};
+      HttpResponse response =
+          putUsageRecordsForHttpResponse(
+              accessToken, subscriptionId, subscriptionItemId, usageRecordId, updateUsageRecord);
+      return apiClient.getObjectMapper().readValue(response.getContent(), typeRef);
+    } catch (HttpResponseException e) {
+      if (logger.isDebugEnabled()) {
+        logger.debug(
+            "------------------ HttpResponseException "
+                + e.getStatusCode()
+                + " : putUsageRecords -------------------");
+        logger.debug(e.toString());
+      }
+      XeroApiExceptionHandler handler = new XeroApiExceptionHandler();
+      handler.execute(e);
+    } catch (IOException ioe) {
+      throw ioe;
+    }
+    return null;
+  }
+
+  /**
+   * Update and existing metered usage belonging to this subscription and subscription item
+   *
+   * <p><b>200</b> - Success - return response of the modified record
+   *
+   * <p><b>404</b> - When a failure occurs in the endpoint
+   *
+   * @param subscriptionId Unique identifier for Subscription object
+   * @param subscriptionItemId The unique identifier of the subscriptionItem
+   * @param usageRecordId The unique identifier of the usage record
+   * @param updateUsageRecord Contains the quantity for the usage record to update
+   * @param accessToken Authorization token for user set in header of each request
+   * @return HttpResponse
+   * @throws IOException if an error occurs while attempting to invoke the API
+   */
+  public HttpResponse putUsageRecordsForHttpResponse(
+      String accessToken,
+      UUID subscriptionId,
+      UUID subscriptionItemId,
+      UUID usageRecordId,
+      UpdateUsageRecord updateUsageRecord)
+      throws IOException {
+    // verify the required parameter 'subscriptionId' is set
+    if (subscriptionId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'subscriptionId' when calling putUsageRecords");
+    } // verify the required parameter 'subscriptionItemId' is set
+    if (subscriptionItemId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'subscriptionItemId' when calling putUsageRecords");
+    } // verify the required parameter 'usageRecordId' is set
+    if (usageRecordId == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'usageRecordId' when calling putUsageRecords");
+    } // verify the required parameter 'updateUsageRecord' is set
+    if (updateUsageRecord == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'updateUsageRecord' when calling putUsageRecords");
+    }
+    if (accessToken == null) {
+      throw new IllegalArgumentException(
+          "Missing the required parameter 'accessToken' when calling putUsageRecords");
+    }
+    HttpHeaders headers = new HttpHeaders();
+    headers.setAccept("application/json");
+    headers.setUserAgent(this.getUserAgent());
+    // create a map of path variables
+    final Map<String, Object> uriVariables = new HashMap<String, Object>();
+    uriVariables.put("subscriptionId", subscriptionId);
+    uriVariables.put("subscriptionItemId", subscriptionItemId);
+    uriVariables.put("usageRecordId", usageRecordId);
+
+    UriBuilder uriBuilder =
+        UriBuilder.fromUri(
+            apiClient.getBasePath()
+                + "/subscriptions/{subscriptionId}/items/{subscriptionItemId}/usage-records/{usageRecordId}");
+    String url = uriBuilder.buildFromMap(uriVariables).toString();
+    GenericUrl genericUrl = new GenericUrl(url);
+    if (logger.isDebugEnabled()) {
+      logger.debug("PUT " + genericUrl.toString());
+    }
+
+    HttpContent content = null;
+    content = apiClient.new JacksonJsonHttpContent(updateUsageRecord);
+
+    Credential credential =
+        new Credential(BearerToken.authorizationHeaderAccessMethod()).setAccessToken(accessToken);
+    HttpTransport transport = apiClient.getHttpTransport();
+    HttpRequestFactory requestFactory = transport.createRequestFactory(credential);
+    return requestFactory
+        .buildRequest(HttpMethods.PUT, genericUrl, content)
+        .setHeaders(headers)
+        .setConnectTimeout(apiClient.getConnectionTimeout())
+        .setReadTimeout(apiClient.getReadTimeout())
+        .execute();
+  }
+
   /**
    * convert intput to byte array
    *
diff --git a/src/main/java/com/xero/api/client/AssetApi.java b/src/main/java/com/xero/api/client/AssetApi.java
index e2c695e2..4d19d2d6 100644
--- a/src/main/java/com/xero/api/client/AssetApi.java
+++ b/src/main/java/com/xero/api/client/AssetApi.java
@@ -2,7 +2,7 @@
  * Xero Assets API
  * The Assets API exposes fixed asset related functions of the Xero Accounting application and can be used for a variety of purposes such as creating assets, retrieving asset valuations etc.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -48,7 +48,7 @@ public class AssetApi {
   private ApiClient apiClient;
   private static AssetApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(AssetApi.class);
 
   /** AssetApi */
diff --git a/src/main/java/com/xero/api/client/BankFeedsApi.java b/src/main/java/com/xero/api/client/BankFeedsApi.java
index 4c4c2a6b..9aa00d43 100644
--- a/src/main/java/com/xero/api/client/BankFeedsApi.java
+++ b/src/main/java/com/xero/api/client/BankFeedsApi.java
@@ -2,7 +2,7 @@
  * Xero Bank Feeds API
  * The Bank Feeds API is a closed API that is only available to financial institutions that have an established financial services partnership with Xero. If you're an existing financial services partner that wants access, contact your local Partner Manager. If you're a financial institution who wants to provide bank feeds to your business customers, contact us to become a financial services partner.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -46,7 +46,7 @@ public class BankFeedsApi {
   private ApiClient apiClient;
   private static BankFeedsApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(BankFeedsApi.class);
 
   /** BankFeedsApi */
diff --git a/src/main/java/com/xero/api/client/FilesApi.java b/src/main/java/com/xero/api/client/FilesApi.java
index 8f5f45ec..feb00c2a 100644
--- a/src/main/java/com/xero/api/client/FilesApi.java
+++ b/src/main/java/com/xero/api/client/FilesApi.java
@@ -2,7 +2,7 @@
  * Xero Files API
  * These endpoints are specific to Xero Files API
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -53,7 +53,7 @@ public class FilesApi {
   private ApiClient apiClient;
   private static FilesApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(FilesApi.class);
 
   /** FilesApi */
diff --git a/src/main/java/com/xero/api/client/FinanceApi.java b/src/main/java/com/xero/api/client/FinanceApi.java
index 8b7f54c8..d89d8142 100644
--- a/src/main/java/com/xero/api/client/FinanceApi.java
+++ b/src/main/java/com/xero/api/client/FinanceApi.java
@@ -2,7 +2,7 @@
  * Xero Finance API
  * The Finance API is a collection of endpoints which customers can use in the course of a loan application, which may assist lenders to gain the confidence they need to provide capital.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -52,7 +52,7 @@ public class FinanceApi {
   private ApiClient apiClient;
   private static FinanceApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(FinanceApi.class);
 
   /** FinanceApi */
diff --git a/src/main/java/com/xero/api/client/IdentityApi.java b/src/main/java/com/xero/api/client/IdentityApi.java
index 0e8a112e..6b87a73c 100644
--- a/src/main/java/com/xero/api/client/IdentityApi.java
+++ b/src/main/java/com/xero/api/client/IdentityApi.java
@@ -2,7 +2,7 @@
  * Xero OAuth 2 Identity Service API
  * These endpoints are related to managing authentication tokens and identity for Xero API
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -44,7 +44,7 @@ public class IdentityApi {
   private ApiClient apiClient;
   private static IdentityApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(IdentityApi.class);
 
   /** IdentityApi */
diff --git a/src/main/java/com/xero/api/client/PayrollAuApi.java b/src/main/java/com/xero/api/client/PayrollAuApi.java
index fe708b6c..7a124690 100644
--- a/src/main/java/com/xero/api/client/PayrollAuApi.java
+++ b/src/main/java/com/xero/api/client/PayrollAuApi.java
@@ -2,7 +2,7 @@
  * Xero Payroll AU API
  * This is the Xero Payroll API for orgs in Australia region.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -64,7 +64,7 @@ public class PayrollAuApi {
   private ApiClient apiClient;
   private static PayrollAuApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(PayrollAuApi.class);
 
   /** PayrollAuApi */
diff --git a/src/main/java/com/xero/api/client/PayrollNzApi.java b/src/main/java/com/xero/api/client/PayrollNzApi.java
index b7535f4e..c937e343 100644
--- a/src/main/java/com/xero/api/client/PayrollNzApi.java
+++ b/src/main/java/com/xero/api/client/PayrollNzApi.java
@@ -2,7 +2,7 @@
  * Xero Payroll NZ
  * This is the Xero Payroll API for orgs in the NZ region.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -105,7 +105,7 @@ public class PayrollNzApi {
   private ApiClient apiClient;
   private static PayrollNzApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(PayrollNzApi.class);
 
   /** PayrollNzApi */
diff --git a/src/main/java/com/xero/api/client/PayrollUkApi.java b/src/main/java/com/xero/api/client/PayrollUkApi.java
index 5171e021..7f58c815 100644
--- a/src/main/java/com/xero/api/client/PayrollUkApi.java
+++ b/src/main/java/com/xero/api/client/PayrollUkApi.java
@@ -2,7 +2,7 @@
  * Xero Payroll UK
  * This is the Xero Payroll API for orgs in the UK region.
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -105,7 +105,7 @@ public class PayrollUkApi {
   private ApiClient apiClient;
   private static PayrollUkApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(PayrollUkApi.class);
 
   /** PayrollUkApi */
diff --git a/src/main/java/com/xero/api/client/ProjectApi.java b/src/main/java/com/xero/api/client/ProjectApi.java
index 61395c3b..b8b26c43 100644
--- a/src/main/java/com/xero/api/client/ProjectApi.java
+++ b/src/main/java/com/xero/api/client/ProjectApi.java
@@ -2,7 +2,7 @@
  * Xero Projects API
  * This is the Xero Projects API
  *
- * The version of the OpenAPI document: 2.30.2
+ * The version of the OpenAPI document: 2.31.0
  * Contact: api@xero.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -56,7 +56,7 @@ public class ProjectApi {
   private ApiClient apiClient;
   private static ProjectApi instance = null;
   private String userAgent = "Default";
-  private String version = "4.22.0";
+  private String version = "4.23.0";
   static final Logger logger = LoggerFactory.getLogger(ProjectApi.class);
 
   /** ProjectApi */
diff --git a/src/main/java/com/xero/models/accounting/LineItem.java b/src/main/java/com/xero/models/accounting/LineItem.java
index 0a4f6f4a..cc73ec00 100644
--- a/src/main/java/com/xero/models/accounting/LineItem.java
+++ b/src/main/java/com/xero/models/accounting/LineItem.java
@@ -440,10 +440,11 @@ public void setItem(LineItemItem item) {
   }
 
   /**
-   * If you wish to omit either of the &lt;Quantity&gt; or &lt;UnitAmount&gt; you can provide a
-   * LineAmount and Xero will calculate the missing amount for you. The line amount reflects the
-   * discounted price if a DiscountRate has been used . i.e LineAmount &#x3D; Quantity * Unit Amount
-   * * ((100 – DiscountRate)/100)
+   * If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero
+   * will calculate the missing amount for you. The line amount reflects the discounted price if
+   * either a DiscountRate or DiscountAmount has been used i.e. LineAmount &#x3D; Quantity * Unit
+   * Amount * ((100 - DiscountRate)/100) or LineAmount &#x3D; (Quantity * UnitAmount) -
+   * DiscountAmount
    *
    * @param lineAmount Double
    * @return LineItem
@@ -454,24 +455,27 @@ public LineItem lineAmount(Double lineAmount) {
   }
 
   /**
-   * If you wish to omit either of the &lt;Quantity&gt; or &lt;UnitAmount&gt; you can provide a
-   * LineAmount and Xero will calculate the missing amount for you. The line amount reflects the
-   * discounted price if a DiscountRate has been used . i.e LineAmount &#x3D; Quantity * Unit Amount
-   * * ((100 – DiscountRate)/100)
+   * If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero
+   * will calculate the missing amount for you. The line amount reflects the discounted price if
+   * either a DiscountRate or DiscountAmount has been used i.e. LineAmount &#x3D; Quantity * Unit
+   * Amount * ((100 - DiscountRate)/100) or LineAmount &#x3D; (Quantity * UnitAmount) -
+   * DiscountAmount
    *
    * @return lineAmount
    */
   @ApiModelProperty(
       value =
-          "If you wish to omit either of the <Quantity> or <UnitAmount> you can provide a"
-              + " LineAmount and Xero will calculate the missing amount for you. The line amount"
-              + " reflects the discounted price if a DiscountRate has been used . i.e LineAmount ="
-              + " Quantity * Unit Amount * ((100 – DiscountRate)/100)")
-  /**
-   * If you wish to omit either of the &lt;Quantity&gt; or &lt;UnitAmount&gt; you can provide a
-   * LineAmount and Xero will calculate the missing amount for you. The line amount reflects the
-   * discounted price if a DiscountRate has been used . i.e LineAmount &#x3D; Quantity * Unit Amount
-   * * ((100 – DiscountRate)/100)
+          "If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and"
+              + " Xero will calculate the missing amount for you. The line amount reflects the"
+              + " discounted price if either a DiscountRate or DiscountAmount has been used i.e."
+              + " LineAmount = Quantity * Unit Amount * ((100 - DiscountRate)/100) or LineAmount ="
+              + " (Quantity * UnitAmount) - DiscountAmount")
+  /**
+   * If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero
+   * will calculate the missing amount for you. The line amount reflects the discounted price if
+   * either a DiscountRate or DiscountAmount has been used i.e. LineAmount &#x3D; Quantity * Unit
+   * Amount * ((100 - DiscountRate)/100) or LineAmount &#x3D; (Quantity * UnitAmount) -
+   * DiscountAmount
    *
    * @return lineAmount Double
    */
@@ -480,10 +484,11 @@ public Double getLineAmount() {
   }
 
   /**
-   * If you wish to omit either of the &lt;Quantity&gt; or &lt;UnitAmount&gt; you can provide a
-   * LineAmount and Xero will calculate the missing amount for you. The line amount reflects the
-   * discounted price if a DiscountRate has been used . i.e LineAmount &#x3D; Quantity * Unit Amount
-   * * ((100 – DiscountRate)/100)
+   * If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero
+   * will calculate the missing amount for you. The line amount reflects the discounted price if
+   * either a DiscountRate or DiscountAmount has been used i.e. LineAmount &#x3D; Quantity * Unit
+   * Amount * ((100 - DiscountRate)/100) or LineAmount &#x3D; (Quantity * UnitAmount) -
+   * DiscountAmount
    *
    * @param lineAmount Double
    */
@@ -591,8 +596,8 @@ public void setDiscountRate(Double discountRate) {
   }
 
   /**
-   * Discount amount being applied to a line item. Only supported on ACCREC invoices - ACCPAY
-   * invoices and credit notes in Xero do not support discounts.
+   * Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes.
+   * ACCPAY invoices and credit notes in Xero do not support discounts.
    *
    * @param discountAmount Double
    * @return LineItem
@@ -603,18 +608,18 @@ public LineItem discountAmount(Double discountAmount) {
   }
 
   /**
-   * Discount amount being applied to a line item. Only supported on ACCREC invoices - ACCPAY
-   * invoices and credit notes in Xero do not support discounts.
+   * Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes.
+   * ACCPAY invoices and credit notes in Xero do not support discounts.
    *
    * @return discountAmount
    */
   @ApiModelProperty(
       value =
-          "Discount amount being applied to a line item. Only supported on ACCREC invoices -"
-              + " ACCPAY invoices and credit notes in Xero do not support discounts.")
+          "Discount amount being applied to a line item. Only supported on ACCREC invoices and"
+              + " quotes. ACCPAY invoices and credit notes in Xero do not support discounts.")
   /**
-   * Discount amount being applied to a line item. Only supported on ACCREC invoices - ACCPAY
-   * invoices and credit notes in Xero do not support discounts.
+   * Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes.
+   * ACCPAY invoices and credit notes in Xero do not support discounts.
    *
    * @return discountAmount Double
    */
@@ -623,8 +628,8 @@ public Double getDiscountAmount() {
   }
 
   /**
-   * Discount amount being applied to a line item. Only supported on ACCREC invoices - ACCPAY
-   * invoices and credit notes in Xero do not support discounts.
+   * Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes.
+   * ACCPAY invoices and credit notes in Xero do not support discounts.
    *
    * @param discountAmount Double
    */
diff --git a/src/main/java/com/xero/models/appstore/CreateUsageRecord.java b/src/main/java/com/xero/models/appstore/CreateUsageRecord.java
new file mode 100644
index 00000000..652264dd
--- /dev/null
+++ b/src/main/java/com/xero/models/appstore/CreateUsageRecord.java
@@ -0,0 +1,148 @@
+/*
+ * Xero AppStore API
+ * These endpoints are for Xero Partners to interact with the App Store Billing platform
+ *
+ * Contact: api@xero.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.xero.models.appstore;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.xero.api.StringUtil;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import java.util.Objects;
+import org.threeten.bp.OffsetDateTime;
+
+/** Data transfer object for public create usage end point */
+@ApiModel(description = "Data transfer object for public create usage end point")
+public class CreateUsageRecord {
+  StringUtil util = new StringUtil();
+
+  @JsonProperty("quantity")
+  private Integer quantity;
+
+  @JsonProperty("timestamp")
+  private OffsetDateTime timestamp;
+  /**
+   * The initial quantity for the usage record. Must be a whole number that is greater than or equal
+   * to 0
+   *
+   * @param quantity Integer
+   * @return CreateUsageRecord
+   */
+  public CreateUsageRecord quantity(Integer quantity) {
+    this.quantity = quantity;
+    return this;
+  }
+
+  /**
+   * The initial quantity for the usage record. Must be a whole number that is greater than or equal
+   * to 0
+   *
+   * @return quantity
+   */
+  @ApiModelProperty(
+      required = true,
+      value =
+          "The initial quantity for the usage record. Must be a whole number that is greater than"
+              + " or equal to 0")
+  /**
+   * The initial quantity for the usage record. Must be a whole number that is greater than or equal
+   * to 0
+   *
+   * @return quantity Integer
+   */
+  public Integer getQuantity() {
+    return quantity;
+  }
+
+  /**
+   * The initial quantity for the usage record. Must be a whole number that is greater than or equal
+   * to 0
+   *
+   * @param quantity Integer
+   */
+  public void setQuantity(Integer quantity) {
+    this.quantity = quantity;
+  }
+
+  /**
+   * DateTime in UTC of when the the product was consumed/used
+   *
+   * @param timestamp OffsetDateTime
+   * @return CreateUsageRecord
+   */
+  public CreateUsageRecord timestamp(OffsetDateTime timestamp) {
+    this.timestamp = timestamp;
+    return this;
+  }
+
+  /**
+   * DateTime in UTC of when the the product was consumed/used
+   *
+   * @return timestamp
+   */
+  @ApiModelProperty(
+      required = true,
+      value = "DateTime in UTC of when the the product was consumed/used")
+  /**
+   * DateTime in UTC of when the the product was consumed/used
+   *
+   * @return timestamp OffsetDateTime
+   */
+  public OffsetDateTime getTimestamp() {
+    return timestamp;
+  }
+
+  /**
+   * DateTime in UTC of when the the product was consumed/used
+   *
+   * @param timestamp OffsetDateTime
+   */
+  public void setTimestamp(OffsetDateTime timestamp) {
+    this.timestamp = timestamp;
+  }
+
+  @Override
+  public boolean equals(java.lang.Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    CreateUsageRecord createUsageRecord = (CreateUsageRecord) o;
+    return Objects.equals(this.quantity, createUsageRecord.quantity)
+        && Objects.equals(this.timestamp, createUsageRecord.timestamp);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(quantity, timestamp);
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class CreateUsageRecord {\n");
+    sb.append("    quantity: ").append(toIndentedString(quantity)).append("\n");
+    sb.append("    timestamp: ").append(toIndentedString(timestamp)).append("\n");
+    sb.append("}");
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces (except the first line).
+   */
+  private String toIndentedString(java.lang.Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+}
diff --git a/src/main/java/com/xero/models/appstore/UpdateUsageRecord.java b/src/main/java/com/xero/models/appstore/UpdateUsageRecord.java
new file mode 100644
index 00000000..0789671b
--- /dev/null
+++ b/src/main/java/com/xero/models/appstore/UpdateUsageRecord.java
@@ -0,0 +1,105 @@
+/*
+ * Xero AppStore API
+ * These endpoints are for Xero Partners to interact with the App Store Billing platform
+ *
+ * Contact: api@xero.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.xero.models.appstore;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.xero.api.StringUtil;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import java.util.Objects;
+
+/** Data transfer object for public update usage end point */
+@ApiModel(description = "Data transfer object for public update usage end point")
+public class UpdateUsageRecord {
+  StringUtil util = new StringUtil();
+
+  @JsonProperty("quantity")
+  private Integer quantity;
+  /**
+   * The new quantity for the usage record. Must be a whole number that is greater than or equal to
+   * 0
+   *
+   * @param quantity Integer
+   * @return UpdateUsageRecord
+   */
+  public UpdateUsageRecord quantity(Integer quantity) {
+    this.quantity = quantity;
+    return this;
+  }
+
+  /**
+   * The new quantity for the usage record. Must be a whole number that is greater than or equal to
+   * 0
+   *
+   * @return quantity
+   */
+  @ApiModelProperty(
+      required = true,
+      value =
+          "The new quantity for the usage record. Must be a whole number that is greater than or"
+              + " equal to 0")
+  /**
+   * The new quantity for the usage record. Must be a whole number that is greater than or equal to
+   * 0
+   *
+   * @return quantity Integer
+   */
+  public Integer getQuantity() {
+    return quantity;
+  }
+
+  /**
+   * The new quantity for the usage record. Must be a whole number that is greater than or equal to
+   * 0
+   *
+   * @param quantity Integer
+   */
+  public void setQuantity(Integer quantity) {
+    this.quantity = quantity;
+  }
+
+  @Override
+  public boolean equals(java.lang.Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    UpdateUsageRecord updateUsageRecord = (UpdateUsageRecord) o;
+    return Objects.equals(this.quantity, updateUsageRecord.quantity);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(quantity);
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class UpdateUsageRecord {\n");
+    sb.append("    quantity: ").append(toIndentedString(quantity)).append("\n");
+    sb.append("}");
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces (except the first line).
+   */
+  private String toIndentedString(java.lang.Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+}
diff --git a/src/main/java/com/xero/models/appstore/UsageRecord.java b/src/main/java/com/xero/models/appstore/UsageRecord.java
new file mode 100644
index 00000000..cfc014a6
--- /dev/null
+++ b/src/main/java/com/xero/models/appstore/UsageRecord.java
@@ -0,0 +1,385 @@
+/*
+ * Xero AppStore API
+ * These endpoints are for Xero Partners to interact with the App Store Billing platform
+ *
+ * Contact: api@xero.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.xero.models.appstore;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.xero.api.StringUtil;
+import io.swagger.annotations.ApiModelProperty;
+import java.math.BigDecimal;
+import java.util.Objects;
+import org.threeten.bp.OffsetDateTime;
+
+/** UsageRecord */
+public class UsageRecord {
+  StringUtil util = new StringUtil();
+
+  @JsonProperty("quantity")
+  private Integer quantity;
+
+  @JsonProperty("subscriptionId")
+  private String subscriptionId;
+
+  @JsonProperty("subscriptionItemId")
+  private String subscriptionItemId;
+
+  @JsonProperty("testMode")
+  private Boolean testMode;
+
+  @JsonProperty("recordedAt")
+  private OffsetDateTime recordedAt;
+
+  @JsonProperty("usageRecordId")
+  private String usageRecordId;
+
+  @JsonProperty("pricePerUnit")
+  private BigDecimal pricePerUnit;
+
+  @JsonProperty("productId")
+  private String productId;
+  /**
+   * The quantity recorded
+   *
+   * @param quantity Integer
+   * @return UsageRecord
+   */
+  public UsageRecord quantity(Integer quantity) {
+    this.quantity = quantity;
+    return this;
+  }
+
+  /**
+   * The quantity recorded
+   *
+   * @return quantity
+   */
+  @ApiModelProperty(required = true, value = "The quantity recorded")
+  /**
+   * The quantity recorded
+   *
+   * @return quantity Integer
+   */
+  public Integer getQuantity() {
+    return quantity;
+  }
+
+  /**
+   * The quantity recorded
+   *
+   * @param quantity Integer
+   */
+  public void setQuantity(Integer quantity) {
+    this.quantity = quantity;
+  }
+
+  /**
+   * The unique identifier of the Subscription.
+   *
+   * @param subscriptionId String
+   * @return UsageRecord
+   */
+  public UsageRecord subscriptionId(String subscriptionId) {
+    this.subscriptionId = subscriptionId;
+    return this;
+  }
+
+  /**
+   * The unique identifier of the Subscription.
+   *
+   * @return subscriptionId
+   */
+  @ApiModelProperty(required = true, value = "The unique identifier of the Subscription.")
+  /**
+   * The unique identifier of the Subscription.
+   *
+   * @return subscriptionId String
+   */
+  public String getSubscriptionId() {
+    return subscriptionId;
+  }
+
+  /**
+   * The unique identifier of the Subscription.
+   *
+   * @param subscriptionId String
+   */
+  public void setSubscriptionId(String subscriptionId) {
+    this.subscriptionId = subscriptionId;
+  }
+
+  /**
+   * The unique identifier of the SubscriptionItem.
+   *
+   * @param subscriptionItemId String
+   * @return UsageRecord
+   */
+  public UsageRecord subscriptionItemId(String subscriptionItemId) {
+    this.subscriptionItemId = subscriptionItemId;
+    return this;
+  }
+
+  /**
+   * The unique identifier of the SubscriptionItem.
+   *
+   * @return subscriptionItemId
+   */
+  @ApiModelProperty(required = true, value = "The unique identifier of the SubscriptionItem.")
+  /**
+   * The unique identifier of the SubscriptionItem.
+   *
+   * @return subscriptionItemId String
+   */
+  public String getSubscriptionItemId() {
+    return subscriptionItemId;
+  }
+
+  /**
+   * The unique identifier of the SubscriptionItem.
+   *
+   * @param subscriptionItemId String
+   */
+  public void setSubscriptionItemId(String subscriptionItemId) {
+    this.subscriptionItemId = subscriptionItemId;
+  }
+
+  /**
+   * If the subscription is a test subscription
+   *
+   * @param testMode Boolean
+   * @return UsageRecord
+   */
+  public UsageRecord testMode(Boolean testMode) {
+    this.testMode = testMode;
+    return this;
+  }
+
+  /**
+   * If the subscription is a test subscription
+   *
+   * @return testMode
+   */
+  @ApiModelProperty(required = true, value = "If the subscription is a test subscription")
+  /**
+   * If the subscription is a test subscription
+   *
+   * @return testMode Boolean
+   */
+  public Boolean getTestMode() {
+    return testMode;
+  }
+
+  /**
+   * If the subscription is a test subscription
+   *
+   * @param testMode Boolean
+   */
+  public void setTestMode(Boolean testMode) {
+    this.testMode = testMode;
+  }
+
+  /**
+   * The time when this usage was recorded in UTC
+   *
+   * @param recordedAt OffsetDateTime
+   * @return UsageRecord
+   */
+  public UsageRecord recordedAt(OffsetDateTime recordedAt) {
+    this.recordedAt = recordedAt;
+    return this;
+  }
+
+  /**
+   * The time when this usage was recorded in UTC
+   *
+   * @return recordedAt
+   */
+  @ApiModelProperty(required = true, value = "The time when this usage was recorded in UTC")
+  /**
+   * The time when this usage was recorded in UTC
+   *
+   * @return recordedAt OffsetDateTime
+   */
+  public OffsetDateTime getRecordedAt() {
+    return recordedAt;
+  }
+
+  /**
+   * The time when this usage was recorded in UTC
+   *
+   * @param recordedAt OffsetDateTime
+   */
+  public void setRecordedAt(OffsetDateTime recordedAt) {
+    this.recordedAt = recordedAt;
+  }
+
+  /**
+   * The unique identifier of the usageRecord.
+   *
+   * @param usageRecordId String
+   * @return UsageRecord
+   */
+  public UsageRecord usageRecordId(String usageRecordId) {
+    this.usageRecordId = usageRecordId;
+    return this;
+  }
+
+  /**
+   * The unique identifier of the usageRecord.
+   *
+   * @return usageRecordId
+   */
+  @ApiModelProperty(required = true, value = "The unique identifier of the usageRecord.")
+  /**
+   * The unique identifier of the usageRecord.
+   *
+   * @return usageRecordId String
+   */
+  public String getUsageRecordId() {
+    return usageRecordId;
+  }
+
+  /**
+   * The unique identifier of the usageRecord.
+   *
+   * @param usageRecordId String
+   */
+  public void setUsageRecordId(String usageRecordId) {
+    this.usageRecordId = usageRecordId;
+  }
+
+  /**
+   * The price per unit
+   *
+   * @param pricePerUnit BigDecimal
+   * @return UsageRecord
+   */
+  public UsageRecord pricePerUnit(BigDecimal pricePerUnit) {
+    this.pricePerUnit = pricePerUnit;
+    return this;
+  }
+
+  /**
+   * The price per unit
+   *
+   * @return pricePerUnit
+   */
+  @ApiModelProperty(required = true, value = "The price per unit")
+  /**
+   * The price per unit
+   *
+   * @return pricePerUnit BigDecimal
+   */
+  public BigDecimal getPricePerUnit() {
+    return pricePerUnit;
+  }
+
+  /**
+   * The price per unit
+   *
+   * @param pricePerUnit BigDecimal
+   */
+  public void setPricePerUnit(BigDecimal pricePerUnit) {
+    this.pricePerUnit = pricePerUnit;
+  }
+
+  /**
+   * The unique identifier of the linked Product
+   *
+   * @param productId String
+   * @return UsageRecord
+   */
+  public UsageRecord productId(String productId) {
+    this.productId = productId;
+    return this;
+  }
+
+  /**
+   * The unique identifier of the linked Product
+   *
+   * @return productId
+   */
+  @ApiModelProperty(required = true, value = "The unique identifier of the linked Product")
+  /**
+   * The unique identifier of the linked Product
+   *
+   * @return productId String
+   */
+  public String getProductId() {
+    return productId;
+  }
+
+  /**
+   * The unique identifier of the linked Product
+   *
+   * @param productId String
+   */
+  public void setProductId(String productId) {
+    this.productId = productId;
+  }
+
+  @Override
+  public boolean equals(java.lang.Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    UsageRecord usageRecord = (UsageRecord) o;
+    return Objects.equals(this.quantity, usageRecord.quantity)
+        && Objects.equals(this.subscriptionId, usageRecord.subscriptionId)
+        && Objects.equals(this.subscriptionItemId, usageRecord.subscriptionItemId)
+        && Objects.equals(this.testMode, usageRecord.testMode)
+        && Objects.equals(this.recordedAt, usageRecord.recordedAt)
+        && Objects.equals(this.usageRecordId, usageRecord.usageRecordId)
+        && Objects.equals(this.pricePerUnit, usageRecord.pricePerUnit)
+        && Objects.equals(this.productId, usageRecord.productId);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(
+        quantity,
+        subscriptionId,
+        subscriptionItemId,
+        testMode,
+        recordedAt,
+        usageRecordId,
+        pricePerUnit,
+        productId);
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class UsageRecord {\n");
+    sb.append("    quantity: ").append(toIndentedString(quantity)).append("\n");
+    sb.append("    subscriptionId: ").append(toIndentedString(subscriptionId)).append("\n");
+    sb.append("    subscriptionItemId: ").append(toIndentedString(subscriptionItemId)).append("\n");
+    sb.append("    testMode: ").append(toIndentedString(testMode)).append("\n");
+    sb.append("    recordedAt: ").append(toIndentedString(recordedAt)).append("\n");
+    sb.append("    usageRecordId: ").append(toIndentedString(usageRecordId)).append("\n");
+    sb.append("    pricePerUnit: ").append(toIndentedString(pricePerUnit)).append("\n");
+    sb.append("    productId: ").append(toIndentedString(productId)).append("\n");
+    sb.append("}");
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces (except the first line).
+   */
+  private String toIndentedString(java.lang.Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+}
diff --git a/src/main/java/com/xero/models/appstore/UsageRecordsList.java b/src/main/java/com/xero/models/appstore/UsageRecordsList.java
new file mode 100644
index 00000000..f350613e
--- /dev/null
+++ b/src/main/java/com/xero/models/appstore/UsageRecordsList.java
@@ -0,0 +1,110 @@
+/*
+ * Xero AppStore API
+ * These endpoints are for Xero Partners to interact with the App Store Billing platform
+ *
+ * Contact: api@xero.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.xero.models.appstore;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.xero.api.StringUtil;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+/** Response to get usage record */
+@ApiModel(description = "Response to get usage record")
+public class UsageRecordsList {
+  StringUtil util = new StringUtil();
+
+  @JsonProperty("usageRecords")
+  private List<UsageRecord> usageRecords = new ArrayList<UsageRecord>();
+  /**
+   * A collection of usage records
+   *
+   * @param usageRecords List&lt;UsageRecord&gt;
+   * @return UsageRecordsList
+   */
+  public UsageRecordsList usageRecords(List<UsageRecord> usageRecords) {
+    this.usageRecords = usageRecords;
+    return this;
+  }
+
+  /**
+   * A collection of usage records
+   *
+   * @param usageRecordsItem UsageRecord
+   * @return UsageRecordsList
+   */
+  public UsageRecordsList addUsageRecordsItem(UsageRecord usageRecordsItem) {
+    this.usageRecords.add(usageRecordsItem);
+    return this;
+  }
+
+  /**
+   * A collection of usage records
+   *
+   * @return usageRecords
+   */
+  @ApiModelProperty(required = true, value = "A collection of usage records")
+  /**
+   * A collection of usage records
+   *
+   * @return usageRecords List<UsageRecord>
+   */
+  public List<UsageRecord> getUsageRecords() {
+    return usageRecords;
+  }
+
+  /**
+   * A collection of usage records
+   *
+   * @param usageRecords List&lt;UsageRecord&gt;
+   */
+  public void setUsageRecords(List<UsageRecord> usageRecords) {
+    this.usageRecords = usageRecords;
+  }
+
+  @Override
+  public boolean equals(java.lang.Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    UsageRecordsList usageRecordsList = (UsageRecordsList) o;
+    return Objects.equals(this.usageRecords, usageRecordsList.usageRecords);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(usageRecords);
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class UsageRecordsList {\n");
+    sb.append("    usageRecords: ").append(toIndentedString(usageRecords)).append("\n");
+    sb.append("}");
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces (except the first line).
+   */
+  private String toIndentedString(java.lang.Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+}