@model-match/api 3.18.0 → 3.19.0

package/openapi.json

@@ -1716,7 +1716,7 @@
                 "type": "array"
               }
             ],
-            "description": "Scoped lender filter(s). Each entry names ONE financing relationship and the metric bounds that must hold INSIDE it — `{lender:'<id>', volume:{gte:10000000}}` means '$10M of their sales were financed by that lender', not '$10M of sales and one deal with them'. Several entries AND together. Geographic market filters are not available here: use `POST /agents/{id}/markets` (live-aggregated) for an agent's geography."
+            "description": "Scoped lender filter(s). Each entry names ONE financing relationship and the metric bounds that must hold INSIDE it — `{lender:'<id>', volume:{gte:10000000}}` means '$10M of their sales were financed by that lender', not '$10M of sales and one deal with them'. Several entries AND together. Geographic market filters are not available here: use `POST /v1/agents/{id}/markets` (live-aggregated) for an agent's geography."
           },
           "lenderFilters": {
             "items": {
@@ -19838,7 +19838,7 @@
           },
           "originatorEmail": {
             "deprecated": true,
-            "description": "DEPRECATED — ALWAYS NULL. Loan records carry no originator email field, so this is null on every loan; it is retained only for response-shape compatibility. To get a loan officer's email, take `originatorNmlsId` from this response and fetch the originator (`GET /originators/{nmlsId}`), whose `email` field carries it — available for roughly 14% of loan officers.",
+            "description": "DEPRECATED — ALWAYS NULL. Loan records carry no originator email field, so this is null on every loan; it is retained only for response-shape compatibility. To get a loan officer's email, take `originatorNmlsId` from this response and fetch the originator (`GET /v1/originators/{nmlsId}`), whose `email` field carries it — available for roughly 14% of loan officers.",
             "nullable": true,
             "type": "string"
           },
@@ -24108,22 +24108,24 @@
       "OriginatorCompanyCategoryFilterValue": {
         "anyOf": [
           {
-            "description": "One of (case-insensitive): BANK, CU, OTHER",
+            "description": "One of (case-insensitive): BANK, CU, OTHER, BUILDER",
             "enum": [
               "BANK",
               "CU",
-              "OTHER"
+              "OTHER",
+              "BUILDER"
             ],
             "type": "string"
           },
           {
             "description": "Match any of these values",
             "items": {
-              "description": "One of (case-insensitive): BANK, CU, OTHER",
+              "description": "One of (case-insensitive): BANK, CU, OTHER, BUILDER",
               "enum": [
                 "BANK",
                 "CU",
-                "OTHER"
+                "OTHER",
+                "BUILDER"
               ],
               "type": "string"
             },
@@ -24144,7 +24146,8 @@
           {
             "nullable": true
           }
-        ]
+        ],
+        "description": "Employer category. `BANK` / `CU` / `OTHER` are the stored NMLS categories; `BUILDER` is a virtual category matching the mortgage arms of home builders (Lennar Mortgage, DHI Mortgage, Pulte Mortgage, …), which NMLS registers as `OTHER`. Pass an array to match any of several — `[\"BANK\", \"BUILDER\"]` is banks OR builder lenders. Rows never carry `BUILDER` back; read `companyNmlsId` instead."
       },
       "OriginatorContact": {
         "nullable": true,
@@ -24261,6 +24264,47 @@
         ],
         "type": "object"
       },
+      "OriginatorCrmListFilter": {
+        "additionalProperties": false,
+        "description": "Scope the result to the caller's CRM. Resolved against the caller's ACTIVE WORKSPACE at query time — list membership is read server-side, so the request never carries member ids. Only loan-officer members count; agents and manual (unlinked) records on the same list are ignored. `mode: \"in\"` with no matching members returns an empty page (not an unfiltered one). Errors: 400 `crm_list_requires_workspace` when the caller has no active workspace (API-key / OAuth callers must select an organization), 403 / 404 when a named list is not visible to the caller or does not exist, and 400 `crm_list_too_large` when the selected lists hold more than 50,000 loan officers in total — narrow the selection rather than get a silently partial answer.",
+        "properties": {
+          "lists": {
+            "anyOf": [
+              {
+                "description": "Every People list in the caller's workspace that the caller can see (own, org-wide, or shared with them).",
+                "enum": [
+                  "any"
+                ],
+                "type": "string"
+              },
+              {
+                "description": "Specific CRM list ids (1–50).",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "maxItems": 50,
+                "minItems": 1,
+                "type": "array"
+              }
+            ],
+            "description": "Which lists: `\"any\"` for every People list the caller can see, or an array of list ids. Membership is the UNION across the selected lists."
+          },
+          "mode": {
+            "description": "`in` — only originators who are a member of the selected list(s). `notIn` — exclude every originator who is a member of the selected list(s); everyone else passes, including originators on none of your lists.",
+            "enum": [
+              "in",
+              "notIn"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "mode",
+          "lists"
+        ],
+        "type": "object"
+      },
       "OriginatorDetail": {
         "allOf": [
           {
@@ -24795,6 +24839,9 @@
           "advancedFilters": {
             "$ref": "#/components/schemas/FilterNode"
           },
+          "crmList": {
+            "$ref": "#/components/schemas/OriginatorCrmListFilter"
+          },
           "filters": {
             "$ref": "#/components/schemas/FilterNode"
           },
@@ -25212,6 +25259,16 @@
                   }
                 ]
               },
+              "lastTransactionDate": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/DateFilterValue"
+                  },
+                  {
+                    "description": "Date of the originator's most recent loan INSIDE the selected period — the 'recently active' axis. `{gte: \"2026-07-01\"}` keeps originators who closed a loan on or after that day; under the default `last12Months` the period's newest loan is the originator's newest loan, so this reads as 'last active since'. Present on every producing record (100% of served rows), so a bound drops no one for lack of a date. Bounds accept `YYYY`, `YYYY-MM`, `YYYY-MM-DD` or an ISO datetime (see `DateFilterValue`). Sortable: `sort: [{field: \"lastTransactionDate\", order: \"desc\"}]` = most recently active first."
+                  }
+                ]
+              },
               "lenderCount": {
                 "allOf": [
                   {
@@ -25225,6 +25282,16 @@
               "licenseCount": {
                 "$ref": "#/components/schemas/NumericFilterValue"
               },
+              "licensedSinceDate": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/DateFilterValue"
+                  },
+                  {
+                    "description": "Date the originator's NMLS registration began — 'licensed since'. Lifetime, NOT scoped by `period`. `{gte: \"2025-10-01\"}` finds originators who entered the industry on or after that day (newly licensed); `{lte: \"2015-01-01\"}` finds ten-year veterans by registration rather than by `yearsInIndustry`. On file for 99.7% of producing originators (59% of the whole index, so pair with `producersOnly: false` cautiously — unregistered rows have no date and are dropped by any bound unless `includeNulls: true`). Bounds accept `YYYY`, `YYYY-MM`, `YYYY-MM-DD` or an ISO datetime. Sortable: `desc` = newest registrations first."
+                  }
+                ]
+              },
               "loanType": {
                 "$ref": "#/components/schemas/OriginatorLoanTypeFilterValue"
               },
@@ -25388,7 +25455,7 @@
                     "$ref": "#/components/schemas/NumericFilterValue"
                   },
                   {
-                    "description": "The originator's BEST single month of volume inside the selected period. `{gte:10000000}` = 'they had at least one $10M month' (4,803 originators over the last 12 months); `{lte:X}` means no month exceeded X, so it is a true ceiling on their best month. There is no way to ask about a SPECIFIC month here — the per-month buckets are not individually addressable — so use `POST /originators/{nmlsId}/analytics/time-series` for a month-by-month series."
+                    "description": "The originator's BEST single month of volume inside the selected period. `{gte:10000000}` = 'they had at least one $10M month' (4,803 originators over the last 12 months); `{lte:X}` means no month exceeded X, so it is a true ceiling on their best month. There is no way to ask about a SPECIFIC month here — the per-month buckets are not individually addressable — so use `POST /v1/originators/analytics/time-series` (filtered to the originator) for a month-by-month series."
                   }
                 ]
               },
@@ -25757,7 +25824,9 @@
                     "producersOnly",
                     "yearsInIndustry",
                     "officeState",
-                    "officeCity"
+                    "officeCity",
+                    "licensedSinceDate",
+                    "lastTransactionDate"
                   ],
                   "type": "string"
                 },
@@ -26577,7 +26646,7 @@
       "OriginatorSummary": {
         "properties": {
           "avgLoanAmount": {
-            "description": "Mean loan size for the selected period, derived from the TOTAL `volume` and `units` across ALL markets — NOT scoped to any geographic filter in this request. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
+            "description": "Mean loan size for the selected period, derived from the TOTAL `volume` and `units` across ALL markets — NOT scoped to any geographic filter in this request. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /v1/originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
             "nullable": true,
             "type": "number"
           },
@@ -26724,11 +26793,21 @@
             "nullable": true,
             "type": "string"
           },
+          "lastTransactionDate": {
+            "description": "ISO datetime of the originator's most recent loan INSIDE the selected period — the value the `lastTransactionDate` filter and sort use. Under the default `last12Months` this is the originator's most recent loan overall. Null when the period bucket carries no production.",
+            "nullable": true,
+            "type": "string"
+          },
           "licenseCount": {
             "description": "Current NMLS registration license count — the value the `licenseCount` filter matches.",
             "nullable": true,
             "type": "number"
           },
+          "licensedSinceDate": {
+            "description": "Date (YYYY-MM-DD) the originator's NMLS registration began — the value the `licensedSinceDate` filter and sort use. Lifetime, not scoped by `period`. Null when no registration record is on file.",
+            "nullable": true,
+            "type": "string"
+          },
           "name": {
             "nullable": true,
             "type": "string"
@@ -26757,12 +26836,12 @@
             "type": "string"
           },
           "previousUnits": {
-            "description": "The originator's TOTAL loan count in the 12 months BEFORE the `last12Months` window — months 13-24 back — with the same availability and geography caveats as `previousVolume` (NMLS 7206: 1,295 → 550). For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
+            "description": "The originator's TOTAL loan count in the 12 months BEFORE the `last12Months` window — months 13-24 back — with the same availability and geography caveats as `previousVolume` (NMLS 7206: 1,295 → 550). For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /v1/originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
             "nullable": true,
             "type": "number"
           },
           "previousVolume": {
-            "description": "The originator's TOTAL dollar production in the 12 months BEFORE the `last12Months` window — i.e. months 13-24 back. Pair it with `volume` for a true trailing year-over-year change (NMLS 7206: $855,758,492 → $440,740,230, −48.5%). Substituting calendar years answers a DIFFERENT question and disagrees materially — 2024 vs 2025 for the same originator reads −39.6%, nine points off — because a calendar year is not a trailing window and the current one is only partly elapsed. ABSENT, not zero, on any `period` other than `last12Months`: no other window has a containing block measured in the index, and a zero would read as 'produced nothing' rather than 'not available here'. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
+            "description": "The originator's TOTAL dollar production in the 12 months BEFORE the `last12Months` window — i.e. months 13-24 back. Pair it with `volume` for a true trailing year-over-year change (NMLS 7206: $855,758,492 → $440,740,230, −48.5%). Substituting calendar years answers a DIFFERENT question and disagrees materially — 2024 vs 2025 for the same originator reads −39.6%, nine points off — because a calendar year is not a trailing window and the current one is only partly elapsed. ABSENT, not zero, on any `period` other than `last12Months`: no other window has a containing block measured in the index, and a zero would read as 'produced nothing' rather than 'not available here'. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /v1/originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
             "nullable": true,
             "type": "number"
           },
@@ -26791,12 +26870,12 @@
             "type": "array"
           },
           "scopedUnits": {
-            "description": "The originator's loan count INSIDE the geography this request names, on the same basis as `scopedVolume`. Sortable. When the request names no geography — or names one only inside an `or` group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with `POST /originators/{nmlsId}/markets` for the same geography and period: both are read from the same per-market rollup on the same record.",
+            "description": "The originator's loan count INSIDE the geography this request names, on the same basis as `scopedVolume`. Sortable. When the request names no geography — or names one only inside an `or` group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with `POST /v1/originators/{nmlsId}/markets` for the same geography and period: both are read from the same per-market rollup on the same record.",
             "nullable": true,
             "type": "number"
           },
           "scopedVolume": {
-            "description": "The originator's dollar production INSIDE the geography this request names — what a `state`/`city`/`county`/`zip` filter was almost certainly asking for, and what the sibling `volume` is not. Sort by `scopedVolume` to rank originators by it. When the request names no geography — or names one only inside an `or` group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with `POST /originators/{nmlsId}/markets` for the same geography and period: both are read from the same per-market rollup on the same record.",
+            "description": "The originator's dollar production INSIDE the geography this request names — what a `state`/`city`/`county`/`zip` filter was almost certainly asking for, and what the sibling `volume` is not. Sort by `scopedVolume` to rank originators by it. When the request names no geography — or names one only inside an `or` group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with `POST /v1/originators/{nmlsId}/markets` for the same geography and period: both are read from the same per-market rollup on the same record.",
             "nullable": true,
             "type": "number"
           },
@@ -26810,7 +26889,7 @@
             "type": "number"
           },
           "units": {
-            "description": "The originator's TOTAL loan count for the selected period across ALL markets — NOT scoped to any geographic filter in this request, exactly as described on `volume`. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
+            "description": "The originator's TOTAL loan count for the selected period across ALL markets — NOT scoped to any geographic filter in this request, exactly as described on `volume`. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /v1/originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
             "nullable": true,
             "type": "number"
           },
@@ -26819,7 +26898,7 @@
             "type": "number"
           },
           "volume": {
-            "description": "The originator's TOTAL dollar production for the selected period across ALL markets — NOT scoped to any geographic filter (`state`/`city`/`county`/`countyFips`/`zip`/`zipCode`) in this request. Those filters select WHICH originators are returned — they produced at least one loan there — and never change WHAT is summed here. Since the list sorts by `volume` descending by default, a geo-filtered search ranks originators by NATIONAL production, so the top row can be many times larger than that originator's production inside the filtered area. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
+            "description": "The originator's TOTAL dollar production for the selected period across ALL markets — NOT scoped to any geographic filter (`state`/`city`/`county`/`countyFips`/`zip`/`zipCode`) in this request. Those filters select WHICH originators are returned — they produced at least one loan there — and never change WHAT is summed here. Since the list sorts by `volume` descending by default, a geo-filtered search ranks originators by NATIONAL production, so the top row can be many times larger than that originator's production inside the filtered area. For production INSIDE the geography this request names, read `scopedVolume`/`scopedUnits` on the same row, and sort by them to rank originators by it. `POST /v1/originators/{nmlsId}/breakdowns/counties` (or `/cities`, `/states`, `/zip-codes`) breaks ONE originator's production out by market.",
             "nullable": true,
             "type": "number"
           },
@@ -29803,7 +29882,7 @@
         "type": "object"
       },
       "PropertyParties": {
-        "description": "Mortgage parties attributed to the parcel, split by scope: `alltime` (everyone on record, a strict superset of the rest), `active` (parties on loans still outstanding), `matched` (the subset whose loan resolved to a known NMLS entity) and `last` (the most recent loan). Real estate agents are not part of this block — reach parcels from an agent through `POST /agents/{id}/properties`.",
+        "description": "Mortgage parties attributed to the parcel, split by scope: `alltime` (everyone on record, a strict superset of the rest), `active` (parties on loans still outstanding), `matched` (the subset whose loan resolved to a known NMLS entity) and `last` (the most recent loan). Real estate agents are not part of this block — reach parcels from an agent through `POST /v1/agents/{id}/properties`.",
         "properties": {
           "active": {
             "$ref": "#/components/schemas/PropertyPartyRoster"
@@ -32688,3867 +32767,10 @@
   "info": {
     "description": "ModelMatch API — mortgage and real-estate market data.\n\n## Bulk delivery limits\n\nThe `POST /{entity}/bulk-delivery` endpoints export a full result set to\nS3 as NDJSON, JSON, CSV, or Parquet.\n\n- **Up to 5,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 5,000 rows: requires the entity's `bulk-delivery.{entity}`\n  entitlement** (e.g. `bulk-delivery.loans`). The grant's scope sets your\n  row ceiling and may also restrict which rows and fields you receive.\n\nA delivery that would exceed the limit available to you is rejected with\n`403 entitlement_missing`, reporting the matched row count and the ceiling\nthat applied. To stay under the limit, pass `limit` — the job then delivers\n(and bills for) only the first `limit` rows of a broader query.\n\n**Need a higher limit?** Email support@modelmatch.com to request the\nentitlement. Limits are raised per organization and per entity.\n\nBulk delivery is billed at 1 credit per delivered row whether or not\nan entitlement is held.\n\nInstead of a download, a delivery can be sent to a push target configured\non your workspace: pass `destination: { type: \"push-target\", targetId }`.\nThe same limits and billing apply.",
     "title": "ModelMatch API",
-    "version": "3.64.0"
+    "version": "3.67.0"
   },
   "openapi": "3.1.0",
   "paths": {
-    "/agents": {
-      "post": {
-        "description": "Search and list individual real-estate agents with filters — one row per agent. Filter by name, location (state, city, zip), brokerage/office, and production metrics (sales volume, transaction units, price range), with sorting and cursor pagination. LOCATION SEMANTICS: the state/city/zip filters match ANY of an agent's location signals — their listed city/state, their office address(es), AND the markets where they actually closed transactions (production) — combined with OR. So an agent matches a searched location if their office OR their production is there. A search for city \"Long Beach\" can therefore return agents whose office or displayed primary market is in a different city/state, because they transacted in Long Beach. The `state`/`city` returned on each row reflect the agent's primary market and may differ from the searched location. (Use the `office` filter to match by brokerage/office name, and the per-agent city/county/state breakdown endpoints to rank an agent's volume within a specific market.) RANKING BY DEAL SIDE: combine a location filter with `sort` on `buyerVolume`/`buyerUnits` (or `sellerVolume`/`sellerUnits`, `dualVolume`/`dualUnits`) to rank agents by how active they are representing buyers vs. sellers in that market — e.g. sort `buyerVolume` descending for the most active buyer-side agents in a state or city. This is the per-agent record search: use it to find specific real-estate agents or build a filtered agent list. (For a single agent by ID use the agent detail endpoint.) If you only need how many agents match and not the records themselves, send the same request body to `countAgents`.",
-        "operationId": "listAgents",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentListResponse"
-                }
-              }
-            },
-            "description": "Paginated list of agents"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error. Includes unresolvable location filters: a `city`/`county`/`state`/`zip` value that does not match a recognized location returns 400 rather than an empty result set. Resolve the name with `instantSearch` (use an id from its `results.locations[]`) or `suggestLocations` (use the `id` of a `source: \"dictionary\"` result), then pass that id back as the filter value."
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          },
-          "503": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Location dictionary temporarily unavailable. Only returned for a NEGATED location filter (`neq`, or `not`), which cannot be honoured without resolving the excluded value — answering anyway would return the records you asked to exclude. Positive location filters are unaffected. Retry shortly; the filter value itself was not rejected."
-          }
-        },
-        "summary": "Search agents with filters",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/analytics/chart": {
-      "post": {
-        "operationId": "agentAnalyticsChart",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentChartRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ChartResponse"
-                }
-              }
-            },
-            "description": "Chart data"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Configurable chart (measure × slice) over the agent's sales",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/analytics/summary": {
-      "post": {
-        "operationId": "agentAnalyticsSummary",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentSummaryRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SidedSummaryResponse"
-                }
-              }
-            },
-            "description": "Sided summary with previous-period comparison"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Production summary with buyer/seller/dual split + previous period",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/analytics/time-series": {
-      "post": {
-        "operationId": "agentAnalyticsTimeSeries",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentTimeSeriesRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SidedTimeSeriesResponse"
-                }
-              }
-            },
-            "description": "Time-series with side splits + previous period"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Agent volume/units over time with buyer/seller/dual split",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/bulk-delivery": {
-      "post": {
-        "description": "Queues an ECS task that dumps every matching agents document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/agents/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.agents` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
-        "operationId": "submitAgentsBulkDelivery",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "allOf": [
-                  {
-                    "$ref": "#/components/schemas/AgentListRequest"
-                  },
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "destination": {
-                        "$ref": "#/components/schemas/BulkDeliveryDestination"
-                      },
-                      "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
-                        "items": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "type": "array"
-                      },
-                      "format": {
-                        "$ref": "#/components/schemas/BulkDeliveryFormat"
-                      },
-                      "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
-                        "example": 5000,
-                        "exclusiveMinimum": true,
-                        "minimum": 0,
-                        "type": "integer"
-                      }
-                    },
-                    "type": "object"
-                  }
-                ]
-              }
-            }
-          }
-        },
-        "responses": {
-          "202": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliverySubmitResponse"
-                }
-              }
-            },
-            "description": "Job queued; ECS task launched"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/ErrorResponse"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "402": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.agents` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                }
-              }
-            },
-            "description": "Push target not found (`TARGET_NOT_FOUND`)"
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                }
-              }
-            },
-            "description": "Push target is disabled (`TARGET_DISABLED`)"
-          },
-          "502": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
-          }
-        },
-        "summary": "Submit a bulk-delivery job for agents",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/bulk-delivery/{jobId}": {
-      "delete": {
-        "description": "Cancels a queued or running agents delivery job.\n\nThe job is marked `cancelled` immediately; the container running it notices on its next page boundary and stops. Because a delivery is billed once, at the end, **a cancelled job is never charged** — no credits are debited and there is nothing to refund. No partial file is written.\n\nIdempotent-ish: cancelling a job that has already finished (or was already cancelled) returns 409 and changes nothing. Poll `GET /v1/agents/bulk-delivery/{jobId}` for the settled state.",
-        "operationId": "cancelAgentsBulkDeliveryJob",
-        "parameters": [
-          {
-            "description": "Job ID returned by `POST /v1/agents/bulk-delivery`",
-            "in": "path",
-            "name": "jobId",
-            "required": true,
-            "schema": {
-              "description": "Job ID returned by `POST /v1/agents/bulk-delivery`",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryStatusResponse"
-                }
-              }
-            },
-            "description": "Job cancelled; body is its settled status"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Caller does not own this job"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job not found (or expired past 30d TTL)"
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job already finished — nothing to cancel"
-          }
-        },
-        "summary": "Cancel a bulk-delivery job for agents",
-        "tags": [
-          "Agents"
-        ]
-      },
-      "get": {
-        "operationId": "getAgentsBulkDeliveryJob",
-        "parameters": [
-          {
-            "description": "Job ID returned by `POST /v1/agents/bulk-delivery`",
-            "in": "path",
-            "name": "jobId",
-            "required": true,
-            "schema": {
-              "description": "Job ID returned by `POST /v1/agents/bulk-delivery`",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryStatusResponse"
-                }
-              }
-            },
-            "description": "Job status (resultsUrl re-signed if completed)"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Caller does not own this job"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job not found (or expired past 30d TTL)"
-          }
-        },
-        "summary": "Get bulk-delivery job status for agents",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/count": {
-      "post": {
-        "description": "Return the exact number of agents matching the given filters. Accepts the same request body as `listAgents` (pagination and sort are ignored). Use this when you only need a total; to get the matching agents themselves, send the same request body to `listAgents`.",
-        "operationId": "countAgents",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/CountResponse"
-                }
-              }
-            },
-            "description": "Exact count of matching agents"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          },
-          "503": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Location dictionary temporarily unavailable. Only returned for a NEGATED location filter (`neq`, or `not`), which cannot be honoured without resolving the excluded value — answering anyway would return the records you asked to exclude. Positive location filters are unaffected. Retry shortly; the filter value itself was not rejected."
-          }
-        },
-        "summary": "Count agents matching filters",
-        "tags": [
-          "Agents"
-        ],
-        "x-mm-records-via": "listAgents"
-      }
-    },
-    "/agents/{id}": {
-      "get": {
-        "operationId": "getAgent",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Period for volume/units (default: last12Months)",
-            "in": "query",
-            "name": "period",
-            "required": false,
-            "schema": {
-              "allOf": [
-                {
-                  "$ref": "#/components/schemas/Period"
-                },
-                {
-                  "description": "Period for volume/units (default: last12Months)"
-                }
-              ]
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentDetailResponse"
-                }
-              }
-            },
-            "description": "Agent detail"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Agent not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large"
-          }
-        },
-        "summary": "Get agent by ID",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/cities": {
-      "post": {
-        "operationId": "agentCities",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the agent's sales by cities"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "City volume breakdown across the agent's sales",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/companies": {
-      "post": {
-        "operationId": "agentCompanies",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Pre-aggregated companies breakdown from the agent's scored doc"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Mortgage companies the agent dealt with (pre-aggregated)",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/counties": {
-      "post": {
-        "operationId": "agentCounties",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the agent's sales by counties"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "County (FIPS) volume breakdown",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/lenders": {
-      "post": {
-        "operationId": "agentLenders",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Pre-aggregated lenders breakdown from the agent's scored doc"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Raw-name lenders encountered (pre-aggregated)",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/offices": {
-      "post": {
-        "operationId": "agentOffices",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the agent's sales by offices"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Listing offices the agent has closed through",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/originators": {
-      "post": {
-        "operationId": "agentOriginators",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Pre-aggregated originators breakdown from the agent's scored doc"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Loan officers the agent worked with (pre-aggregated)",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/states": {
-      "post": {
-        "operationId": "agentStates",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the agent's sales by states"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "State volume breakdown",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/breakdowns/zip-codes": {
-      "post": {
-        "operationId": "agentZipCodes",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the agent's sales by zip-codes"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Zip-code volume breakdown",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/markets": {
-      "post": {
-        "description": "Rank the ZIP markets one real-estate agent works, with volume, transaction counts and mean sale price per market, plus a weighted summary across the whole footprint. Optionally narrow to a ZIP list or a date window. REACH, NOT MARKET SHARE: an agent belongs to every market they touch — where their office is AND everywhere they have transacted — so one agent is counted in several markets at once. Per-market agent counts therefore over-sum: they cannot be added together, and dividing one into a total does not produce a market share. The only percentage returned, `shareOfScope`, is each market's share of this agent's volume across the scope requested and sums to 100 over that scope; there is no share-of-whole-book figure, because the transaction records carry no per-agent total to divide by. TWO COUNTS, ON PURPOSE: `transactions` counts transaction records; `units` counts the ones carrying a price, which are the records behind `volume` and `avgSalePrice`. Roughly half of an agent's records are priced, so dividing volume by `transactions` understates the average by about 2×. Figures are computed live from the agent's transaction records — an agent record carries no stored market rollup — and are ranked across their busiest ZIP markets. When a ZIP scope returns no markets, `reach.presentInScope` distinguishes 'works there, nothing closed in the window' from 'not present at all'. The summary also carries a Community Lending mix: what kind of neighborhood these markets are, weighted by the agent's activity in each. These are U.S. Census tract-level aggregates describing whole neighborhoods — never an individual, household or client attribute — and on this surface the basis is always the markets in scope, since an agent record carries no stored neighborhood rollup.",
-        "operationId": "agentMarkets",
-        "parameters": [
-          {
-            "description": "Agent ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentMarketsRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentMarketsResponse"
-                }
-              }
-            },
-            "description": "The agent's blended market footprint"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "The ZIP markets this agent works, blended",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/properties": {
-      "post": {
-        "operationId": "agentProperties",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentRelationRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentPropertiesResponse"
-                }
-              }
-            },
-            "description": "Paginated list of properties for this agent"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Properties this agent has transacted on",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/agents/{id}/sales": {
-      "post": {
-        "operationId": "agentSales",
-        "parameters": [
-          {
-            "description": "Agent document ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Agent document ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/AgentRelationRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentSalesResponse"
-                }
-              }
-            },
-            "description": "Paginated list of sales for this agent"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Sales transactions where this agent was listing or selling side",
-        "tags": [
-          "Agents"
-        ]
-      }
-    },
-    "/originators": {
-      "post": {
-        "description": "Search and list individual loan originators (LOs — NMLS-registered mortgage loan officers) with filters — one row per originator. Filter by name, NMLS ID, location (state, city), employer/company, and production metrics (loan volume, units, product mix), with sorting and cursor pagination. LOCATION SEMANTICS: the state/city filters match an originator's PRODUCTION GEOGRAPHY — the markets where they actually originated loans in the selected period — not where their office or employer sits. An LO who lends across several markets matches a filter for ANY of those markets, while the `state`/`city` returned on each row reflect only their PRIMARY (highest-volume) market. So a search for city \"Long Beach\" can return an LO whose displayed location is a different city/state (e.g. their top market is in Arizona) — they still originated loans in Long Beach, it just isn't their #1 market. To rank originators by their volume within a specific market, sort by volume after filtering, or use the per-originator city/county/state breakdown endpoints. This is the per-originator record search: use it to find specific loan officers or build a filtered LO list. (For a single originator by NMLS ID use the originator detail endpoint.) If you only need how many originators match and not the records themselves, send the same request body to `countOriginators`.",
-        "operationId": "listOriginators",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/OriginatorListResponse"
-                }
-              }
-            },
-            "description": "Paginated list of originators"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error. Includes unresolvable location filters: a `city`/`county`/`state`/`zip` value that does not match a recognized location returns 400 rather than an empty result set. Resolve the name with `instantSearch` (use an id from its `results.locations[]`) or `suggestLocations` (use the `id` of a `source: \"dictionary\"` result), then pass that id back as the filter value. Also returned with `code: \"TIME_AT_COMPANY_SCOPE\"` when `timeAtCompanyMonths` is set, the other filters match more than 200,000 originators, and the requested page lies past the tenure matches found among the first 200,000 — narrow the request."
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Search originators with filters",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/analytics/chart": {
-      "post": {
-        "operationId": "originatorAnalyticsChart",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorChartRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ChartResponse"
-                }
-              }
-            },
-            "description": "Chart data. Money measures (`volume`, `avgSalePrice`, `avgListPrice`) are sentinel-guarded. Excludes values outside 0–100,000,000 — the source encodes unknown values as an out-of-range fill, and averaging them raw is wrong by orders of magnitude. The bound is applied before the metric and is not part of the public filter surface, so an equivalent range filter will not reproduce this figure exactly."
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Configurable chart (measure × slice) over one LO's loans",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/analytics/summary": {
-      "post": {
-        "operationId": "originatorAnalyticsSummary",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorSummaryRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SimpleSummaryResponse"
-                }
-              }
-            },
-            "description": "Current + previous-period summary"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Production summary with previous-period comparison",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/analytics/time-series": {
-      "post": {
-        "operationId": "originatorAnalyticsTimeSeries",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorTimeSeriesRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SimpleTimeSeriesResponse"
-                }
-              }
-            },
-            "description": "Time-series with previous-period comparison"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Originator volume / units over time",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/bulk-delivery": {
-      "post": {
-        "description": "Queues an ECS task that dumps every matching originators document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/originators/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.originators` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
-        "operationId": "submitOriginatorsBulkDelivery",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "allOf": [
-                  {
-                    "$ref": "#/components/schemas/OriginatorListRequest"
-                  },
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "destination": {
-                        "$ref": "#/components/schemas/BulkDeliveryDestination"
-                      },
-                      "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
-                        "items": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "type": "array"
-                      },
-                      "format": {
-                        "$ref": "#/components/schemas/BulkDeliveryFormat"
-                      },
-                      "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
-                        "example": 5000,
-                        "exclusiveMinimum": true,
-                        "minimum": 0,
-                        "type": "integer"
-                      }
-                    },
-                    "type": "object"
-                  }
-                ]
-              }
-            }
-          }
-        },
-        "responses": {
-          "202": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliverySubmitResponse"
-                }
-              }
-            },
-            "description": "Job queued; ECS task launched"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/ErrorResponse"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "402": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                    },
-                    {
-                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
-                    }
-                  ]
-                }
-              }
-            },
-            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.originators` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                }
-              }
-            },
-            "description": "Push target not found (`TARGET_NOT_FOUND`)"
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
-                }
-              }
-            },
-            "description": "Push target is disabled (`TARGET_DISABLED`)"
-          },
-          "502": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
-          }
-        },
-        "summary": "Submit a bulk-delivery job for originators",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/bulk-delivery/{jobId}": {
-      "delete": {
-        "description": "Cancels a queued or running originators delivery job.\n\nThe job is marked `cancelled` immediately; the container running it notices on its next page boundary and stops. Because a delivery is billed once, at the end, **a cancelled job is never charged** — no credits are debited and there is nothing to refund. No partial file is written.\n\nIdempotent-ish: cancelling a job that has already finished (or was already cancelled) returns 409 and changes nothing. Poll `GET /v1/originators/bulk-delivery/{jobId}` for the settled state.",
-        "operationId": "cancelOriginatorsBulkDeliveryJob",
-        "parameters": [
-          {
-            "description": "Job ID returned by `POST /v1/originators/bulk-delivery`",
-            "in": "path",
-            "name": "jobId",
-            "required": true,
-            "schema": {
-              "description": "Job ID returned by `POST /v1/originators/bulk-delivery`",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryStatusResponse"
-                }
-              }
-            },
-            "description": "Job cancelled; body is its settled status"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Caller does not own this job"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job not found (or expired past 30d TTL)"
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job already finished — nothing to cancel"
-          }
-        },
-        "summary": "Cancel a bulk-delivery job for originators",
-        "tags": [
-          "Originators"
-        ]
-      },
-      "get": {
-        "operationId": "getOriginatorsBulkDeliveryJob",
-        "parameters": [
-          {
-            "description": "Job ID returned by `POST /v1/originators/bulk-delivery`",
-            "in": "path",
-            "name": "jobId",
-            "required": true,
-            "schema": {
-              "description": "Job ID returned by `POST /v1/originators/bulk-delivery`",
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryStatusResponse"
-                }
-              }
-            },
-            "description": "Job status (resultsUrl re-signed if completed)"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Authentication required"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Caller does not own this job"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Job not found (or expired past 30d TTL)"
-          }
-        },
-        "summary": "Get bulk-delivery job status for originators",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/count": {
-      "post": {
-        "description": "Return the exact number of originators matching the given filters. Accepts the same request body as `listOriginators` (pagination and sort are ignored). Use this when you only need a total; to get the matching originators themselves, send the same request body to `listOriginators`.",
-        "operationId": "countOriginators",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/OriginatorCountResponse"
-                }
-              }
-            },
-            "description": "Exact count of matching originators"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Count originators matching filters",
-        "tags": [
-          "Originators"
-        ],
-        "x-mm-records-via": "listOriginators"
-      }
-    },
-    "/originators/{nmlsId}": {
-      "get": {
-        "operationId": "getOriginator",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Period for volume/units (default: last12Months)",
-            "in": "query",
-            "name": "period",
-            "required": false,
-            "schema": {
-              "allOf": [
-                {
-                  "$ref": "#/components/schemas/Period"
-                },
-                {
-                  "description": "Period for volume/units (default: last12Months)"
-                }
-              ]
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/OriginatorDetailResponse"
-                }
-              }
-            },
-            "description": "Originator detail"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Originator not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large"
-          }
-        },
-        "summary": "Get originator by NMLS ID",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/agents": {
-      "post": {
-        "description": "Ranks the real-estate agents on the selling side of this LO's loans, by volume. Buckets whose name is an MLS placeholder for \"no selling agent recorded\" (`non member`, `non listed agent`, and ~140 board-specific spellings) are excluded rather than ranked as agents — they are not people and cannot be resolved with `GET /v1/agents/{id}`. Percentages are shares of the LO's whole loan population, so they do not sum to 100 across the page.",
-        "operationId": "originatorAgents",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by agents"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Real-estate agents this LO co-closed with",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/branches": {
-      "post": {
-        "operationId": "originatorBranches",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by branches"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Branch (broker) history for this LO",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/brokers": {
-      "post": {
-        "operationId": "originatorBrokers",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by brokers"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Broker shops this LO originated loans through (name-resolved)",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/cities": {
-      "post": {
-        "operationId": "originatorCitiesBreakdown",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by cities"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "City volume breakdown across this LO's loans",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/companies": {
-      "post": {
-        "operationId": "originatorCompanies",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by companies"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Funding companies (employer history) for this LO",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/counties": {
-      "post": {
-        "operationId": "originatorCountiesBreakdown",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by counties"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "County (FIPS) volume breakdown across this LO's loans",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/lenders": {
-      "post": {
-        "operationId": "originatorLenders",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by lenders"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Lenders this LO has originated through",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/offices": {
-      "post": {
-        "operationId": "originatorOffices",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by broker (office)"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Real-estate offices this LO closed through (with sponsoring company)",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/states": {
-      "post": {
-        "operationId": "originatorStatesBreakdown",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by states"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "State volume breakdown across this LO's loans",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/title-companies": {
-      "post": {
-        "description": "Ranks the title companies on this entity's loans (recorded deeds, `recording_date` window — the same population and period axis as every other loans breakdown). Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under (legal-form and filler words such as `inc`, `llc`, `co`, `company`, `title`, `escrow` removed; `natl` → `national`). Placeholder entries meaning \"no title company recorded\" (`none available` and its misspellings, `unknown`, `n/a`, …) and names shorter than 3 characters are excluded rather than ranked. `attorney` and `accommodation` are kept: they say who closed. `pctUnits` / `pctVolume` are shares of the entity's WHOLE loan population in the window, including loans with no title company, so they do not sum to 100 across the page. Pages of up to 100 via `pagination`.",
-        "operationId": "originatorTitleCompanies",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the entity's loans by title company"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Title companies on this LO's loans (spellings merged)",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/breakdowns/zip-codes": {
-      "post": {
-        "operationId": "originatorZipCodes",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
-                }
-              }
-            },
-            "description": "Breakdown of the LO's loans by zip-codes"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Zip-code volume breakdown",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/loans": {
-      "post": {
-        "operationId": "originatorLoans",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/LoanListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/LoanListResponse"
-                }
-              }
-            },
-            "description": "Paginated list of loans originated by this LO"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Loans originated by this LO",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/markets": {
-      "post": {
-        "description": "One blended view of a loan officer's lending footprint: the ZIP codes they originated in, city / county / state rollups of the same scope, and the period totals those markets are a share of. AVERAGES ARE VOLUME-WEIGHTED: the summary loan size is Σ volume ÷ Σ units, not an unweighted mean of the per-market averages (on a real footprint the two differ by thousands of dollars). Sending `zipCodes` narrows every grain to those ZIPs; sending a `dateRange` re-cuts the window. Either switches the response from the LO's pre-aggregated footprint to a live aggregation of their loans — `source` and `sourceReasons` say which was used, and bucket `key` forms differ between them (use `name` for display). All shares on this response are 0–100 percentages. A summary can cover less than the whole book: production that could not be attributed to a place is held out and reported in `summary.unresolved` rather than being folded in or silently dropped. The summary also carries a Community Lending mix — what kind of neighborhood this book lands in. These are U.S. Census tract-level aggregates describing whole neighborhoods, never individual, household or applicant attributes. Unscoped it is the LO's own whole-period mix; a ZIP or date scope recomputes it over the markets in scope, and `summary.communityLending.basis` says which you got.",
-        "operationId": "originatorMarkets",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/OriginatorMarketsRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/OriginatorMarketsResponse"
-                }
-              }
-            },
-            "description": "The LO's blended market footprint"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Originator not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "The markets this LO lends in",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
-    "/originators/{nmlsId}/properties": {
-      "post": {
-        "description": "Returns the parcels this loan officer is attributed to in public record — the reverse of the `parties` block on `GET /v1/properties/{id}`. Accepts the same filters, sorts and pagination as the main property search, so a caller can ask 'this LO's parcels in Travis County built after 2015' in one request. Attribution is ALL-TIME: a parcel stays in this LO's set after the loan is paid off, because the question is career reach rather than current book. An LO with no attributed parcels returns an empty page, not a 404 — the LO may be real and simply have nothing in the public record yet.",
-        "operationId": "originatorProperties",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "nmlsId",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PropertyListRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PropertyListResponse"
-                }
-              }
-            },
-            "description": "Paginated list of parcels attributed to this LO"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Validation error"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Unauthorized"
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "Not found"
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PayloadTooLarge"
-                }
-              }
-            },
-            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
-          }
-        },
-        "summary": "Properties this loan officer has touched",
-        "tags": [
-          "Originators"
-        ]
-      }
-    },
     "/v1/admin/cad/links/{nmlsId}": {
       "get": {
         "description": "Diagnostic: the LO's indexed employment union (sponsorships + registrations), split by source with active counts. `indexGaps` lists what the former database diagnostic showed that the index does not carry.",
@@ -57413,7 +53635,7 @@
     },
     "/v1/lenders/{id}/breakdowns/originators": {
       "post": {
-        "description": "Ranks the loan officers whose loans funded through this lender, by volume. Each label is the loan officer's NMLS ID, so it chains straight into `GET /originators/{nmlsId}`. Loans with no identified loan officer are excluded rather than collapsed into one unnavigable bucket.",
+        "description": "Ranks the loan officers whose loans funded through this lender, by volume. Each label is the loan officer's NMLS ID, so it chains straight into `GET /v1/originators/{nmlsId}`. Loans with no identified loan officer are excluded rather than collapsed into one unnavigable bucket.",
         "operationId": "lenderOriginators",
         "parameters": [
           {