@lunch-money/v2-api-spec 2.11.0-preview.2 → 2.11.0-preview.4

package/lunch-money-api-v2.yaml

@@ -2,50 +2,37 @@ openapi: 3.0.2
 info:
   title: Lunch Money API - v2
   description: |-
-    Welcome to the documentation for the "next version" of the Lunch Money v2 API.This documentation includes proposed updates to the API design that have not yet been released.<p>
-    This documentation is for the **v2.11.0** release of the API.<p>
-    
-    See the [version history](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/version-history) for what is new in this release.
-    New functionality may only be available in the Mock Service until the release is finalized. <br><br>
-
-    The latest complete implementation of the spec is for the **v2.8.5** release and can be found [here](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/). <br><br>
-    Feedback on any of the API design is welcome, but we are particularly interested in getting feedback on most recent changes in the [version history](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/version-history).
+    Welcome to the Lunch Money v2 API reference. This is the **v2.11.0** spec. It includes previews of the proposed `/crypto` and `/balance_history` endpoints. Only the mock service works with these endpoints.<br><br>
+    The most recent stable version of the API is v2.9.4 and is available at:
+    `https://api.lunchmoney.dev/v2`
 
     ------------------------------------------------------------------------------------------------
-    Welcome to the Lunch Money v2 API.
 
-    A working version of this API is now available through these docs, or directly at:
+    ### Introduction
 
-    `https://api.lunchmoney.dev/v2`
+    The API is available at `https://api.lunchmoney.dev/v2`. Get your access token from the [Lunch Money developers page](https://my.lunchmoney.app/developers).
 
-    <span class="red-text"><strong>This is in alpha launch of a major API update. It is still subject to change during this alpha review 
-    period and bugs may still exist. We strongly encourage users to use the mock service or create a test budget with sample data as the first step to interacting with the v2 API.</strong></span>
-    See the [Getting Started Guide](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/getting-started) for more information on using a test budget.<p>
+    <span class="red-text"><strong>The v2 API is in open alpha and is still subject to change. Use the mock server or a test budget when getting started.</strong></span>
 
-    If you are new to the v2 API, you may wish to review the [v2 API Overview of Changes](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/changelog).
+    **Static Mock Server**
 
-    ### Static Mock Server
+    Explore the API without an access token or risk to real data. Select **"Static Mock v2 Lunch Money API Server"** from the Server dropdown, then set your Bearer token to any string with 11 or more characters.
 
-    You may also use these docs to explore the API using a static mock server endpoint.<p> 
-    This will allow you to become familiar with the API without having to create an access token, and eliminates the possibility of changing real data. <p>
-    To access this endpoint, select the second endpoint in the "Server" dropdown to the right. When selected, you should see "Static Mock v2 Lunch Money API Server".<br>
-    When using this server, set your Bearer token to any string with 11 or more characters.
+    **Client Libraries & SDKs**
 
-    ### Migrating from V1
+    An official TypeScript SDK is available on [NPM](https://www.npmjs.com/package/@lunch-money/v2-api-spec) and [GitHub](https://github.com/lunch-money/lunch-money-js-v2). For Python or other languages, see [lunchmoney-clients](https://github.com/juftin/lunchmoney-clients) or generate a client from this OpenAPI spec.
 
-    The v2 API is NOT backwards compatible with the v1 API. We encourage developers to review the [Migration Guide](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/migration-guide) to understand the changes and plan their migration.
+    **Migrating from v1**
 
-    ### Acknowledgments
+    The v2 API is not backwards compatible with v1. See the [Migration Guide](https://alpha.lunchmoney.dev/v2/migration-guide) for details.
 
-    If you have provided feedback on the API during our ongoing design process, **THANK YOU**. We are thrilled that you can finally interact with the working API we built based on your feedback.
-    
-    ### Useful links:
-    - [Getting Started](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/getting-started)
-    - [v2 API Changelog](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/changelog)
-    - [Migration Guide](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/migration-guide)
-    - [Rate Limits](https://lm-v2-api-next-a7fabcab8e9a.herokuapp.com/v2/rate-limits)
-    - [Current v1 Lunch Money API Documentation](https://lunchmoney.dev)
-    - [Awesome Lunch Money Projects](https://github.com/lunch-money/awesome-lunchmoney?tab=readme-ov-file)
+    **Useful links**
+    - [Developer Portal](https://alpha.lunchmoney.dev/v2/introduction)
+    - [Getting Started Guide](https://alpha.lunchmoney.dev/v2/getting-started)
+    - [v2 API Overview](https://alpha.lunchmoney.dev/v2/overview)
+    - [Version History](https://alpha.lunchmoney.dev/v2/version-history)
+    - [Migration Guide](https://alpha.lunchmoney.dev/v2/migration-guide)
+    - [Rate Limits](https://alpha.lunchmoney.dev/v2/rate-limits)
   termsOfService: https://lunchmoney.dev/#current-status
   contact:
     email: devsupport@lunchmoney.app
@@ -679,7 +666,6 @@ components:
     cryptoManualObject:
       type: object
       title: manual crypto object
-      x-internal: true
       additionalProperties: false
       properties:
         id:
@@ -719,13 +705,22 @@ components:
           description: CoinGecko identifier associated with this balance
         to_base:
           type: number
-          description: Balance converted to the user's primary currency
+          nullable: true
+          description: Balance converted to the user's primary currency. May be null if no conversion was available.
         balance_as_of:
           type: string
           format: date-time
           nullable: true
-          description: Date/time the balance was last updated in ISO 8601
-            extended format
+          description: Date/time the manual balance record was last updated in
+            ISO 8601 extended format. This is currently based on the manual
+            crypto record's updated_at timestamp.
+        exchange_rate_as_of:
+          type: string
+          format: date-time
+          nullable: true
+          description: Date/time the exchange rate used to calculate to_base was
+            last updated in ISO 8601 extended format. Null when no exchange rate was
+            used or no conversion was available.
         created_by_name:
           type: string
           nullable: true
@@ -750,6 +745,7 @@ components:
         - coingecko_id
         - to_base
         - balance_as_of
+        - exchange_rate_as_of
         - created_by_name
         - created_at
         - updated_at
@@ -758,7 +754,6 @@ components:
     cryptoSyncedBalance:
       type: object
       title: synced crypto balance object
-      x-internal: true
       additionalProperties: false
       properties:
         name:
@@ -783,13 +778,21 @@ components:
           description: CoinGecko identifier associated with this balance
         to_base:
           type: number
-          description: Balance converted to the user's primary currency
+          nullable: true
+          description: Balance converted to the user's primary currency. May be null if no conversion was available.
         balance_as_of:
           type: string
           format: date-time
           nullable: true
           description: Date/time the balance was last updated in ISO 8601
-            extended format
+            extended format.
+        exchange_rate_as_of:
+          type: string
+          format: date-time
+          nullable: true
+          description: Date/time the exchange rate used to calculate to_base was
+            last updated in ISO 8601 extended format. Null when no exchange rate was
+            used or no conversion was available.
         updated_at:
           type: string
           format: date-time
@@ -802,12 +805,12 @@ components:
         - coingecko_id
         - to_base
         - balance_as_of
+        - exchange_rate_as_of
         - updated_at
 
     syncedCryptoAccount:
       type: object
       title: synced crypto account
-      x-internal: true
       additionalProperties: false
       properties:
         id:
@@ -1072,8 +1075,16 @@ components:
           type: string
           format: date-time
           nullable: true
-          description: System defined date/time the balance was last updated in
-            ISO 8601 extended format. Ignored if set
+          description: System defined date/time the manual balance record was
+            last updated in ISO 8601 extended format. Ignored if set
+          x-updatable: false
+        exchange_rate_as_of:
+          type: string
+          format: date-time
+          nullable: true
+          description: System defined date/time the exchange rate used to
+            calculate to_base was observed in ISO 8601 extended format. Ignored
+            if set
           x-updatable: false
         created_by_name:
           type: string
@@ -1614,6 +1625,7 @@ components:
       type: object
       description: Source information for a manual account balance history entry.
       additionalProperties: false
+      x-internal: true
       properties:
         type:
           type: string
@@ -1631,6 +1643,7 @@ components:
       type: object
       description: Source information for a Plaid-synced account balance history entry.
       additionalProperties: false
+      x-internal: true
       properties:
         type:
           type: string
@@ -1648,6 +1661,7 @@ components:
       type: object
       description: Source information for a manually-tracked cryptocurrency balance history entry.
       additionalProperties: false
+      x-internal: true
       properties:
         type:
           type: string
@@ -1750,9 +1764,10 @@ components:
         - subtype
         - mask
         - symbol
+
     balanceHistoryAccountObject:
       type: object
-      title: balance history account object
+      title: balance history for an account object
       additionalProperties: false
       description: Historical balance entries grouped under a single account source.
       properties:
@@ -1787,6 +1802,7 @@ components:
       type: object
       title: balance history entry object
       additionalProperties: false
+      x-internal: true
       description: A historical balance entry for a single account on a single date.
       properties:
         id:
@@ -1898,37 +1914,6 @@ components:
       required:
         - balances
 
-    balanceHistoryUpdateErrorObject:
-      type: object
-      x-internal: true
-      additionalProperties: true
-      properties:
-        request_balances_index:
-          type: integer
-          format: int32
-          description: Zero-based index into the `balances` request array
-        message:
-          type: string
-          description: Error message describing why the row could not be updated
-      required:
-        - request_balances_index
-        - message
-
-    upsertBalanceHistoryResponseObject:
-      type: object
-      x-internal: true
-      additionalProperties: false
-      properties:
-        updated_balance_history:
-          $ref: "#/components/schemas/balanceHistoryAccountObject"
-        errors:
-          type: array
-          items:
-            $ref: "#/components/schemas/balanceHistoryUpdateErrorObject"
-      required:
-        - updated_balance_history
-        - errors
-
     updateBalanceHistoryDetailsRequestObject:
       type: object
       x-internal: true
@@ -2495,8 +2480,6 @@ components:
             Any transaction notes set by the user or by 
             a matched recurring item. This will match the value 
             displayed in notes field on the transactions page in the Lunch Money app.
-          minLength: 0
-          maxLength: 350
         status:
           type: string
           # description: >
@@ -2732,8 +2715,6 @@ components:
             Any transaction notes set by the user or by 
             a matched recurring item. This will match the value 
             displayed in notes field on the transactions page in the Lunch Money app.
-          minLength: 0
-          maxLength: 350
         status:
           type: string
           description: >
@@ -2978,8 +2959,6 @@ components:
             Any transaction notes set by the user or by 
             a matched recurring item. This will match the value 
             displayed in notes field on the transactions page in the Lunch Money app.
-          minLength: 0
-          maxLength: 350
         manual_account_id:
           type: integer
           format: int32
@@ -3117,8 +3096,6 @@ components:
           description: >
             New notes for the transaction. Set this to an empty string to clear
             the existing notes.
-          minLength: 0
-          maxLength: 350
           x-updatable: true
         manual_account_id:
           type: integer
@@ -3301,6 +3278,7 @@ components:
             amount.
         payee:
           type: string
+          minLength: 0
           description: The payee for the child transaction. Will inherit the
             original payee from the parent if not defined.
         date:
@@ -3323,7 +3301,6 @@ components:
             format: int32
         notes:
           type: string
-          maxLength: 350
           description: Will inherit notes from parent if not defined.
       required:
         - amount
@@ -4114,6 +4091,7 @@ components:
       #   - `cad`: Canadian Dollar
       #   - `cdf`: Congolese Franc
       #   - `chf`: Swiss Franc
+      #   - `clf`: Chilean Unit of Account (UF)
       #   - `clp`: Chilean Peso
       #   - `cny`: Chinese Yuan
       #   - `cop`: Colombian Peso
@@ -4129,6 +4107,7 @@ components:
       #   - `egp`: Egyptian Pound
       #   - `ern`: Eritrean Nakfa
       #   - `etb`: Ethiopian Birr
+      #   - `eth`: Ethereum
       #   - `eur`: Euro
       #   - `fjd`: Fijian Dollar
       #   - `fkp`: Falkland Islands Pound
@@ -4236,6 +4215,7 @@ components:
       #   - `uyu`: Uruguayan Peso
       #   - `uzs`: Uzbekistan Som
       #   - `vef`: Venezuelan Bolívar
+      #   - `ves`: Venezuelan Bolívar Sotiemas
       #   - `vnd`: Vietnamese Dong
       #   - `vuv`: Vanuatu Vatu
       #   - `wst`: Samoan Tala
@@ -4279,6 +4259,7 @@ components:
         - cad
         - cdf
         - chf
+        - clf
         - clp
         - cny
         - cop
@@ -4294,6 +4275,7 @@ components:
         - egp
         - ern
         - etb
+        - eth
         - eur
         - fjd
         - fkp
@@ -4401,6 +4383,7 @@ components:
         - uyu
         - uzs
         - vef
+        - ves
         - vnd
         - vuv
         - wst
@@ -5905,6 +5888,7 @@ paths:
                     coingecko_id: bitcoin
                     to_base: 53124.72
                     balance_as_of: "2026-02-25T14:22:10.000Z"
+                    exchange_rate_as_of: "2026-02-25T14:10:00.000Z"
                     created_by_name: User 1
                     created_at: "2025-11-12T20:14:32.000Z"
                     updated_at: "2026-02-25T14:22:10.000Z"
@@ -5962,6 +5946,7 @@ paths:
                 coingecko_id: ethereum
                 to_base: 28998.44
                 balance_as_of: "2026-03-01T09:20:41.000Z"
+                exchange_rate_as_of: "2026-03-01T09:15:00.000Z"
                 created_by_name: User 1
                 created_at: "2026-03-01T09:20:41.000Z"
                 updated_at: "2026-03-01T09:20:41.000Z"
@@ -6029,6 +6014,7 @@ paths:
                 coingecko_id: bitcoin
                 to_base: 53124.72
                 balance_as_of: "2026-02-25T14:22:10.000Z"
+                exchange_rate_as_of: "2026-02-25T14:10:00.000Z"
                 created_by_name: User 1
                 created_at: "2025-11-12T20:14:32.000Z"
                 updated_at: "2026-02-25T14:22:10.000Z"
@@ -6106,6 +6092,7 @@ paths:
                   coingecko_id: bitcoin
                   to_base: 56011.12
                   balance_as_of: "2026-03-01T09:41:18.000Z"
+                  exchange_rate_as_of: "2026-03-01T09:35:00.000Z"
                   created_by_name: User 1
                   created_at: "2025-11-12T20:14:32.000Z"
                   updated_at: "2026-02-25T14:22:10.000Z"
@@ -6126,6 +6113,7 @@ paths:
                 coingecko_id: bitcoin
                 to_base: 56011.12
                 balance_as_of: "2026-03-01T09:41:18.000Z"
+                exchange_rate_as_of: "2026-03-01T09:35:00.000Z"
                 created_by_name: User 1
                 created_at: "2025-11-12T20:14:32.000Z"
                 updated_at: "2026-03-01T09:41:18.000Z"
@@ -6255,6 +6243,7 @@ paths:
                         coingecko_id: ethereum
                         to_base: 28998.44
                         balance_as_of: "2026-02-25T14:25:00.000Z"
+                        exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                         updated_at: "2026-02-25T14:25:01.000Z"
                       - name: BTC
                         balance: "0.100020003000400050"
@@ -6262,6 +6251,7 @@ paths:
                         coingecko_id: bitcoin
                         to_base: 6231.28
                         balance_as_of: "2026-02-25T14:25:00.000Z"
+                        exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                         updated_at: "2026-02-25T14:25:01.000Z"
                   - id: 33005
                     provider: kraken
@@ -6277,6 +6267,7 @@ paths:
                         coingecko_id: ripple
                         to_base: 1287.50
                         balance_as_of: "2026-02-26T07:22:30.000Z"
+                        exchange_rate_as_of: "2026-02-26T07:10:00.000Z"
                         updated_at: "2026-02-26T07:22:30.000Z"
         "401":
           $ref: "#/components/responses/unauthorizedToken"
@@ -6329,6 +6320,7 @@ paths:
                     coingecko_id: ethereum
                     to_base: 28998.44
                     balance_as_of: "2026-02-25T14:25:00.000Z"
+                    exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                     updated_at: "2026-02-25T14:25:01.000Z"
                   - name: BTC
                     balance: "0.100020003000400050"
@@ -6336,6 +6328,7 @@ paths:
                     coingecko_id: bitcoin
                     to_base: 6231.28
                     balance_as_of: "2026-02-25T14:25:00.000Z"
+                    exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                     updated_at: "2026-02-25T14:25:01.000Z"
         "400":
           description: Bad Request
@@ -6401,6 +6394,7 @@ paths:
                 coingecko_id: ethereum
                 to_base: 28998.44
                 balance_as_of: "2026-02-25T14:25:00.000Z"
+                exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                 updated_at: "2026-02-25T14:25:01.000Z"
         "400":
           description: Bad Request
@@ -6486,6 +6480,7 @@ paths:
                     coingecko_id: ethereum
                     to_base: 28998.44
                     balance_as_of: "2026-02-25T14:25:00.000Z"
+                    exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                     updated_at: "2026-02-25T14:25:01.000Z"
                   - name: BTC
                     balance: "0.100020003000400050"
@@ -6493,6 +6488,7 @@ paths:
                     coingecko_id: bitcoin
                     to_base: 6231.28
                     balance_as_of: "2026-02-25T14:25:00.000Z"
+                    exchange_rate_as_of: "2026-02-25T14:20:00.000Z"
                     updated_at: "2026-02-25T14:25:01.000Z"
         "401":
           $ref: "#/components/responses/unauthorizedToken"
@@ -6948,60 +6944,35 @@ paths:
                       currency: usd
                       to_base: 41500
                       crypto_balance: null
-              partial success request:
-                value:
-                  balances:
-                    - date: "2026-03-01"
-                      balance: "41500.0000"
-                    - date: "2026-04-01"
-                      balance: "41625.5000"
-                      symbol: btc
       responses:
         "200":
-          description: One or more balance history entries were processed
+          description: All balance history entries were upserted successfully
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/upsertBalanceHistoryResponseObject"
+                $ref: "#/components/schemas/balanceHistoryAccountObject"
               examples:
                 balances updated:
                   value:
-                    updated_balance_history:
-                      source:
-                        type: manual
-                        manual_account_id: 119807
-                      balances:
-                        - id: 601
-                          date: "2026-03-01"
-                          balance: "41500.0000"
-                          currency: usd
-                          to_base: 41500
-                          crypto_balance: null
-                        - id: 602
-                          date: "2026-04-01"
-                          balance: "41625.5000"
-                          currency: usd
-                          to_base: 41625.5
-                          crypto_balance: null
-                    errors: []
-                partial success:
-                  value:
-                    updated_balance_history:
-                      source:
-                        type: manual
-                        manual_account_id: 119807
-                      balances:
-                        - id: 601
-                          date: "2026-03-01"
-                          balance: "41500.0000"
-                          currency: usd
-                          to_base: 41500
-                          crypto_balance: null
-                    errors:
-                      - request_balances_index: 1
-                        message: "`symbol` may not be set when `account_type` is `manual` or `plaid`."
+                    source:
+                      type: manual
+                      manual_account_id: 119807
+                    balances:
+                      - id: 601
+                        date: "2026-03-01"
+                        balance: "41500.0000"
+                        currency: usd
+                        to_base: 41500
+                        crypto_balance: null
+                      - id: 602
+                        date: "2026-04-01"
+                        balance: "41625.5000"
+                        currency: usd
+                        to_base: 41625.5
+                        crypto_balance: null
         "400":
-          description: Bad Request
+          description: Bad Request. The entire request is rejected if any row in
+            `balances` fails validation; no rows are updated.
           content:
             application/json:
               schema:
@@ -7022,16 +6993,25 @@ paths:
                     message: Request Validation Failure
                     errors:
                       - errMsg: "`date` must be the first day of a month."
+                        request_balances_index: 0
                 future date:
                   value:
                     message: Request Validation Failure
                     errors:
                       - errMsg: "`date` must not be in the future."
+                        request_balances_index: 1
                 crypto balance not allowed:
                   value:
                     message: Request Validation Failure
                     errors:
                       - errMsg: "`crypto_balance` may only be set when `account_type` is `crypto_manual` or `deleted`."
+                        request_balances_index: 0
+                invalid row in bulk request:
+                  value:
+                    message: Request Validation Failure
+                    errors:
+                      - errMsg: "`symbol` may not be set when `account_type` is `manual` or `plaid`."
+                        request_balances_index: 1
         "401":
           $ref: "#/components/responses/unauthorizedToken"
         "404":
@@ -7253,62 +7233,36 @@ paths:
                     - date: "2026-04-01"
                       balance: "6500.0000"
                       crypto_balance: "0.100020003000400050"
-              partial success request:
-                value:
-                  balances:
-                    - date: "2026-03-01"
-                      balance: "6400.0000"
-                      crypto_balance: "0.100020003000400050"
-                    - date: "2026-04-01"
-                      balance: "not-a-number"
       responses:
         "200":
-          description: One or more balance history entries were processed
+          description: All balance history entries were upserted successfully
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/upsertBalanceHistoryResponseObject"
+                $ref: "#/components/schemas/balanceHistoryAccountObject"
               examples:
                 balances updated:
                   value:
-                    updated_balance_history:
-                      source:
-                        type: crypto_synced
-                        crypto_synced_id: 33004
-                        symbol: btc
-                      balances:
-                        - id: 604
-                          date: "2026-03-01"
-                          balance: "6400.0000"
-                          currency: usd
-                          to_base: 6400
-                          crypto_balance: "0.100020003000400050"
-                        - id: 605
-                          date: "2026-04-01"
-                          balance: "6500.0000"
-                          currency: usd
-                          to_base: 6500
-                          crypto_balance: "0.100020003000400050"
-                    errors: []
-                partial success:
-                  value:
-                    updated_balance_history:
-                      source:
-                        type: crypto_synced
-                        crypto_synced_id: 33004
-                        symbol: btc
-                      balances:
-                        - id: 604
-                          date: "2026-03-01"
-                          balance: "6400.0000"
-                          currency: usd
-                          to_base: 6400
-                          crypto_balance: "0.100020003000400050"
-                    errors:
-                      - request_balances_index: 1
-                        message: "`balance` must be a valid numeric string or number."
+                    source:
+                      type: crypto_synced
+                      crypto_synced_id: 33004
+                      symbol: btc
+                    balances:
+                      - id: 604
+                        date: "2026-03-01"
+                        balance: "6400.0000"
+                        currency: usd
+                        to_base: 6400
+                        crypto_balance: "0.100020003000400050"
+                      - id: 605
+                        date: "2026-04-01"
+                        balance: "6500.0000"
+                        currency: usd
+                        to_base: 6500
+                        crypto_balance: "0.100020003000400050"
         "400":
-          description: Bad Request
+          description: Bad Request. The entire request is rejected if any row in
+            `balances` fails validation; no rows are updated.
           content:
             application/json:
               schema:
@@ -7324,11 +7278,19 @@ paths:
                     message: Request Validation Failure
                     errors:
                       - errMsg: "`date` must be the first day of a month."
+                        request_balances_index: 0
                 future date:
                   value:
                     message: Request Validation Failure
                     errors:
                       - errMsg: "`date` must not be in the future."
+                        request_balances_index: 1
+                invalid row in bulk request:
+                  value:
+                    message: Request Validation Failure
+                    errors:
+                      - errMsg: "`balance` must be a valid numeric string or number."
+                        request_balances_index: 1
         "401":
           $ref: "#/components/responses/unauthorizedToken"
         "404":
@@ -10194,7 +10156,7 @@ paths:
                   description: |
                     The payee for the new grouped transaction.
                   minLength: 0
-                  maxLength: 1000
+
                 category_id:
                   type: integer
                   format: int64
@@ -10209,8 +10171,6 @@ paths:
                   nullable: true
                   description: |
                     Notes for the grouped transaction.
-                  minLength: 0
-                  maxLength: 350
                 status:
                   type: string
                   description: If set, must be either `reviewed` or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunch-money/v2-api-spec",
-  "version": "2.11.0-preview.2",
+  "version": "2.11.0-preview.4",
   "description": "OpenAPI specification and version history for the Lunch Money v2 API",
   "main": "lunch-money-api-v2.yaml",
   "files": [

package/version-history.md

@@ -24,11 +24,15 @@ The Lunch Money API spec uses a modified version of SEMVER for its versioning me
   - Viewing the balances for currencies associated with both manually managed crypto assets and those that are synced via a synced crypto account (ie: coinbase, kraken, ethereum wallet)
   - Refreshing synced crypto account balances
 
+## v2.9.4 - May 23, 2026
+- Increase allowable length for transaction `notes`.
+- Add `clf`, `eth`, and `ves` to the supported currency codes.
+
 ## v2.9.3 - Apr 27, 2026
 - Add `xag` and `xau` to the supported currency codes.
 
 ## v2.9.2 - Apr 22, 2026
-- Increase allowable length for a transaction `payee`
+- Increase allowable length for a transaction `payee`.
 
 ## v2.9.1 - Apr 22, 2026
 - You may now set `archived_at` when modifying a category or tag via the `PUT /categories` or `PUT /tags` endpoints.