@lunch-money/developer-docs 2.11.1-docs.1 → 2.11.1-docs.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunch-money/developer-docs",
-  "version": "2.11.1-docs.1",
+  "version": "2.11.1-docs.2",
   "description": "Developer documentation content for Lunch Money APIs",
   "exports": {
     ".": "./package.json",

package/v2/docs/migration-guide.md

@@ -317,10 +317,10 @@ GET /v2/plaid_accounts/123
 GET /v2/tags/1
 ```
 
-**Migration Strategy**: 
+**Migration Strategy**:
 - Maintain a local cache of categories, accounts, and tags
-- Update your code to use IDs and fetch related objects separately when needed
-- Consider batching requests or using the bulk endpoints to reduce API calls
+- Fetch `GET /manual_accounts` and `GET /plaid_accounts` once and build an ID-to-account map. To filter transactions by account name, resolve the name to its account type and ID, then use `manual_account_id` or `plaid_account_id` with `GET /transactions`
+- Refresh cached related objects when their metadata changes instead of fetching them once per transaction
 
 #### Removed Properties
 
@@ -415,14 +415,17 @@ See the [Amounts & balances guide](/amounts-and-balances) for the full sign conv
 #### Split and Grouped Transactions
 
 **Split Transactions**:
-- Parents of split transactions (`is_parent: true`) are not returned by default in `GET /transactions`
+- Parents of split transactions (`is_split_parent: true`) are not returned by default in `GET /transactions`
 - Split transactions include `split_parent_id` pointing to the parent
 - Use `GET /transactions/:id` to get parent with full `children` array
 - Use `GET /transactions` with query param `include_split_parents=true` to include parents in list
 
+> [!WARNING] Prevent duplicate split processing
+> A v1 integration may see split children returned by v2 as new transactions because their parent is omitted by default. Before treating a transaction as new or attempting to split it, check `split_parent_id`. A non-null value identifies an existing split child and points to its parent transaction.
+
 **Grouped Transactions**:
 - Transactions that have been grouped are not returned by default
-- Only the group transaction (`is_group: true`) is returned
+- Only the group transaction (`is_group_parent: true`) is returned
 - Use `GET /transactions/:id` to get details of grouped transactions in the transaction group's `children` array.
 
 

package/v2/spec/lunch-money-api-v2.yaml

@@ -9457,22 +9457,21 @@ paths:
             minimum: 1
             maximum: 2000
             default: 1000
-          description: Sets the maximum number of transactions to return. If
-            more match the filter criteria, the response will include a
-            `has_more` attribute set to `true`. See
-            [Pagination](https://lunchmoney.dev/v2/pagination)
+          description: Sets the maximum number of transactions to return.
+            Defaults to `1000`. When more transactions match, `has_more` is
+            `true`. See [Pagination](https://lunchmoney.dev/pagination)
         - name: offset
           in: query
           schema:
             type: integer
-          description: Sets the offset for the records returned. This is
-            typically set automatically in the header. See
-            [Pagination](https://lunchmoney.dev/v2/pagination)
+          description: Sets the number of matching transactions to skip before
+            returning results. Increase this query parameter for each page. See
+            [Pagination](https://lunchmoney.dev/pagination)
       responses:
         "200":
           description: Returns an array of transactions. <br><br>The `has_more`
             property is set to `true` if more transactions are available. See
-            [Pagination](https://lunchmoney.dev/v2/pagination)
+            [Pagination](https://lunchmoney.dev/pagination)
           content:
             application/json:
               schema: