@model-match/api 3.42.1 → 3.43.1

package/openapi.json

@@ -39542,6 +39542,982 @@
         },
         "type": "object"
       },
+      "OriginatorRetention": {
+        "properties": {
+          "atRisk": {
+            "description": "Exit signals on the retained book; null when not requested or the scan could not complete.",
+            "nullable": true,
+            "properties": {
+              "equityBands": {
+                "items": {
+                  "properties": {
+                    "band": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "band",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "highEquityLowRate": {
+                "type": "number"
+              },
+              "joined": {
+                "type": "number"
+              },
+              "likelyToSell": {
+                "type": "number"
+              },
+              "listedNow": {
+                "type": "number"
+              },
+              "medianEquityPct": {
+                "nullable": true,
+                "type": "number"
+              },
+              "medianRate": {
+                "nullable": true,
+                "type": "number"
+              },
+              "rateIncentive": {
+                "type": "number"
+              },
+              "retainedScanned": {
+                "type": "number"
+              },
+              "rows": {
+                "items": {
+                  "properties": {
+                    "address": {
+                      "type": "string"
+                    },
+                    "borrower": {
+                      "type": "string"
+                    },
+                    "currentBalance": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "currentLender": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "currentRate": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "equityPct": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "flags": {
+                      "items": {
+                        "enum": [
+                          "listed",
+                          "likely_sell",
+                          "rate"
+                        ],
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "homeValue": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "listPrice": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "listedDate": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "listingStatus": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "originalAmount": {
+                      "type": "number"
+                    },
+                    "originalLoanDate": {
+                      "type": "number"
+                    },
+                    "originalLoanType": {
+                      "type": "string"
+                    },
+                    "propensityCategory": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "propertyId": {
+                      "type": "string"
+                    },
+                    "salePropensity": {
+                      "nullable": true,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "propertyId",
+                    "flags",
+                    "equityPct",
+                    "homeValue",
+                    "currentBalance",
+                    "currentRate",
+                    "currentLender",
+                    "salePropensity",
+                    "propensityCategory",
+                    "listingStatus",
+                    "listPrice",
+                    "listedDate",
+                    "address",
+                    "borrower",
+                    "originalLoanDate",
+                    "originalAmount",
+                    "originalLoanType"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "signalling": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "retainedScanned",
+              "joined",
+              "signalling",
+              "listedNow",
+              "likelyToSell",
+              "rateIncentive",
+              "highEquityLowRate",
+              "equityBands",
+              "medianRate",
+              "medianEquityPct",
+              "rows"
+            ],
+            "type": "object"
+          },
+          "capturingCompanies": {
+            "items": {
+              "properties": {
+                "count": {
+                  "type": "number"
+                },
+                "lane": {
+                  "enum": [
+                    "own_company",
+                    "servicer",
+                    "competitor"
+                  ],
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "nmlsId": {
+                  "type": "string"
+                },
+                "volume": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "nmlsId",
+                "name",
+                "count",
+                "volume",
+                "lane"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "capturingOriginators": {
+            "items": {
+              "properties": {
+                "companyName": {
+                  "type": "string"
+                },
+                "count": {
+                  "type": "number"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "nmlsId": {
+                  "type": "string"
+                },
+                "volume": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "nmlsId",
+                "name",
+                "companyName",
+                "count",
+                "volume"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "capturingTotals": {
+            "properties": {
+              "companies": {
+                "properties": {
+                  "distinct": {
+                    "type": "number"
+                  },
+                  "loans": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "distinct",
+                  "loans",
+                  "volume"
+                ],
+                "type": "object"
+              },
+              "originators": {
+                "properties": {
+                  "distinct": {
+                    "type": "number"
+                  },
+                  "loans": {
+                    "type": "number"
+                  },
+                  "unattributedLoans": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "distinct",
+                  "loans",
+                  "volume",
+                  "unattributedLoans"
+                ],
+                "type": "object"
+              },
+              "secondCompanies": {
+                "properties": {
+                  "distinct": {
+                    "type": "number"
+                  },
+                  "loans": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "distinct",
+                  "loans",
+                  "volume"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "companies",
+              "originators",
+              "secondCompanies"
+            ],
+            "type": "object"
+          },
+          "churnByLoanType": {
+            "items": {
+              "properties": {
+                "count": {
+                  "type": "number"
+                },
+                "type": {
+                  "type": "string"
+                },
+                "volume": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "type",
+                "count",
+                "volume"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "churnTrend": {
+            "items": {
+              "properties": {
+                "churned": {
+                  "type": "number"
+                },
+                "kept": {
+                  "type": "number"
+                },
+                "month": {
+                  "type": "string"
+                },
+                "retained": {
+                  "type": "number"
+                },
+                "secondPositions": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "month",
+                "churned",
+                "retained",
+                "secondPositions",
+                "kept"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "churnedLoans": {
+            "items": {
+              "properties": {
+                "address": {
+                  "type": "string"
+                },
+                "borrower": {
+                  "type": "string"
+                },
+                "capturingAmount": {
+                  "type": "number"
+                },
+                "capturingCompany": {
+                  "type": "string"
+                },
+                "capturingCompanyNmlsId": {
+                  "type": "string"
+                },
+                "capturingLender": {
+                  "type": "string"
+                },
+                "capturingLoName": {
+                  "type": "string"
+                },
+                "capturingLoNmlsId": {
+                  "type": "string"
+                },
+                "capturingLoanType": {
+                  "type": "string"
+                },
+                "capturingRate": {
+                  "nullable": true,
+                  "type": "number"
+                },
+                "cashOut": {
+                  "type": "boolean"
+                },
+                "current": {
+                  "description": "What the parcel looks like today, when a scored snapshot newer than the event joined; null otherwise (unknown, never 'retained').",
+                  "nullable": true,
+                  "properties": {
+                    "currentBalance": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "currentLender": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "currentRate": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "lastSaleDate": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "loStillActive": {
+                      "type": "boolean"
+                    },
+                    "ownerChanged": {
+                      "nullable": true,
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "loStillActive",
+                    "ownerChanged",
+                    "lastSaleDate",
+                    "currentLender",
+                    "currentBalance",
+                    "currentRate"
+                  ],
+                  "type": "object"
+                },
+                "daysToEvent": {
+                  "type": "number"
+                },
+                "eventDate": {
+                  "type": "number"
+                },
+                "kind": {
+                  "enum": [
+                    "refi",
+                    "second"
+                  ],
+                  "type": "string"
+                },
+                "lane": {
+                  "enum": [
+                    "own_company",
+                    "servicer",
+                    "competitor"
+                  ],
+                  "type": "string"
+                },
+                "originalAmount": {
+                  "type": "number"
+                },
+                "originalLender": {
+                  "type": "string"
+                },
+                "originalLoanDate": {
+                  "type": "number"
+                },
+                "originalLoanType": {
+                  "type": "string"
+                },
+                "originalRate": {
+                  "nullable": true,
+                  "type": "number"
+                },
+                "originalTransactionType": {
+                  "type": "string"
+                },
+                "propertyId": {
+                  "type": "string"
+                },
+                "sameBorrower": {
+                  "nullable": true,
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "kind",
+                "lane",
+                "propertyId",
+                "address",
+                "borrower",
+                "originalLoanDate",
+                "originalAmount",
+                "originalLoanType",
+                "originalTransactionType",
+                "originalRate",
+                "originalLender",
+                "eventDate",
+                "daysToEvent",
+                "capturingAmount",
+                "capturingLoanType",
+                "capturingRate",
+                "capturingLoNmlsId",
+                "capturingLoName",
+                "capturingCompanyNmlsId",
+                "capturingCompany",
+                "capturingLender",
+                "cashOut",
+                "sameBorrower",
+                "current"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "lanes": {
+            "properties": {
+              "competitor": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              },
+              "own_company": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              },
+              "servicer": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "own_company",
+              "servicer",
+              "competitor"
+            ],
+            "type": "object"
+          },
+          "previous": {
+            "description": "The `compare` period's summary and monthly trend, when asked.",
+            "nullable": true,
+            "properties": {
+              "churnTrend": {
+                "items": {
+                  "properties": {
+                    "churned": {
+                      "type": "number"
+                    },
+                    "kept": {
+                      "type": "number"
+                    },
+                    "month": {
+                      "type": "string"
+                    },
+                    "retained": {
+                      "type": "number"
+                    },
+                    "secondPositions": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "month",
+                    "churned",
+                    "retained",
+                    "secondPositions",
+                    "kept"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "summary": {
+                "properties": {
+                  "churnRate": {
+                    "type": "number"
+                  },
+                  "churnedCount": {
+                    "type": "number"
+                  },
+                  "daysToRefiPairsUsed": {
+                    "type": "number"
+                  },
+                  "keptRefiCount": {
+                    "description": "Same-LO refinances of the LO's own borrowers in the period",
+                    "type": "number"
+                  },
+                  "keptRefiVolume": {
+                    "type": "number"
+                  },
+                  "keptSecondCount": {
+                    "type": "number"
+                  },
+                  "medianDaysToRefi": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "propertySoldCount": {
+                    "type": "number"
+                  },
+                  "refiRetentionRate": {
+                    "description": "kept ÷ (kept + churned) refi events; null with none",
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "retainedCount": {
+                    "type": "number"
+                  },
+                  "secondPositionCount": {
+                    "type": "number"
+                  },
+                  "secondPositionVolume": {
+                    "type": "number"
+                  },
+                  "totalBorrowers": {
+                    "type": "number"
+                  },
+                  "unattributedCount": {
+                    "type": "number"
+                  },
+                  "volumeLost": {
+                    "type": "number"
+                  },
+                  "volumeRetained": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "totalBorrowers",
+                  "churnedCount",
+                  "retainedCount",
+                  "propertySoldCount",
+                  "unattributedCount",
+                  "secondPositionCount",
+                  "secondPositionVolume",
+                  "keptRefiCount",
+                  "keptRefiVolume",
+                  "keptSecondCount",
+                  "refiRetentionRate",
+                  "churnRate",
+                  "volumeLost",
+                  "volumeRetained",
+                  "medianDaysToRefi",
+                  "daysToRefiPairsUsed"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "summary",
+              "churnTrend"
+            ],
+            "type": "object"
+          },
+          "secondPositionCompanies": {
+            "items": {
+              "properties": {
+                "count": {
+                  "type": "number"
+                },
+                "lane": {
+                  "enum": [
+                    "own_company",
+                    "servicer",
+                    "competitor"
+                  ],
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "nmlsId": {
+                  "type": "string"
+                },
+                "volume": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "nmlsId",
+                "name",
+                "count",
+                "volume",
+                "lane"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "secondPositionLanes": {
+            "properties": {
+              "competitor": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              },
+              "own_company": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              },
+              "servicer": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "volume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "volume"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "own_company",
+              "servicer",
+              "competitor"
+            ],
+            "type": "object"
+          },
+          "status": {
+            "description": "`timeout` when the LO's loan history could not be read within the time budget (very large book): every count is then 0 and means 'not available', not 'none'.",
+            "enum": [
+              "ok",
+              "timeout"
+            ],
+            "type": "string"
+          },
+          "summary": {
+            "properties": {
+              "churnRate": {
+                "type": "number"
+              },
+              "churnedCount": {
+                "type": "number"
+              },
+              "daysToRefiPairsUsed": {
+                "type": "number"
+              },
+              "keptRefiCount": {
+                "description": "Same-LO refinances of the LO's own borrowers in the period",
+                "type": "number"
+              },
+              "keptRefiVolume": {
+                "type": "number"
+              },
+              "keptSecondCount": {
+                "type": "number"
+              },
+              "medianDaysToRefi": {
+                "nullable": true,
+                "type": "number"
+              },
+              "propertySoldCount": {
+                "type": "number"
+              },
+              "refiRetentionRate": {
+                "description": "kept ÷ (kept + churned) refi events; null with none",
+                "nullable": true,
+                "type": "number"
+              },
+              "retainedCount": {
+                "type": "number"
+              },
+              "secondPositionCount": {
+                "type": "number"
+              },
+              "secondPositionVolume": {
+                "type": "number"
+              },
+              "totalBorrowers": {
+                "type": "number"
+              },
+              "unattributedCount": {
+                "type": "number"
+              },
+              "volumeLost": {
+                "type": "number"
+              },
+              "volumeRetained": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "totalBorrowers",
+              "churnedCount",
+              "retainedCount",
+              "propertySoldCount",
+              "unattributedCount",
+              "secondPositionCount",
+              "secondPositionVolume",
+              "keptRefiCount",
+              "keptRefiVolume",
+              "keptSecondCount",
+              "refiRetentionRate",
+              "churnRate",
+              "volumeLost",
+              "volumeRetained",
+              "medianDaysToRefi",
+              "daysToRefiPairsUsed"
+            ],
+            "type": "object"
+          },
+          "timing": {
+            "properties": {
+              "cashOutCount": {
+                "type": "number"
+              },
+              "cashOutShare": {
+                "nullable": true,
+                "type": "number"
+              },
+              "loanTypeChangeCount": {
+                "type": "number"
+              },
+              "medianMonths": {
+                "nullable": true,
+                "type": "number"
+              },
+              "monthsToExit": {
+                "items": {
+                  "properties": {
+                    "bucket": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "bucket",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "rateDeltaMedian": {
+                "nullable": true,
+                "type": "number"
+              },
+              "rateDeltaPairs": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "monthsToExit",
+              "medianMonths",
+              "cashOutCount",
+              "cashOutShare",
+              "rateDeltaMedian",
+              "rateDeltaPairs",
+              "loanTypeChangeCount"
+            ],
+            "type": "object"
+          },
+          "truncated": {
+            "description": "A loan / sale scan hit its row cap; counts cover the rows read.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "status",
+          "truncated",
+          "summary",
+          "lanes",
+          "secondPositionLanes",
+          "timing",
+          "churnTrend",
+          "churnByLoanType",
+          "capturingOriginators",
+          "capturingCompanies",
+          "secondPositionCompanies",
+          "capturingTotals",
+          "churnedLoans",
+          "atRisk",
+          "previous"
+        ],
+        "type": "object"
+      },
+      "OriginatorRetentionRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "compare": {
+            "additionalProperties": false,
+            "description": "Optional comparison period (e.g. the prior 14 months). Its `summary` and monthly trend come back as `previous`; it reuses this request's loan scan, so it costs no extra search.",
+            "properties": {
+              "end": {
+                "description": "Last day of the period (UTC, inclusive).",
+                "example": "2025-08-15",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              },
+              "start": {
+                "description": "First day of the period (UTC).",
+                "example": "2025-08-15",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              }
+            },
+            "required": [
+              "start",
+              "end"
+            ],
+            "type": "object"
+          },
+          "end": {
+            "description": "Last day of the period (UTC, inclusive).",
+            "example": "2025-08-15",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "includeAtRisk": {
+            "description": "Scan the retained book for exit signals (listed / likely to sell / rate incentive). Default true.",
+            "type": "boolean"
+          },
+          "start": {
+            "description": "First day of the period (UTC).",
+            "example": "2025-08-15",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "type": "object"
+      },
       "OriginatorSegment": {
         "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`. Time-series only: `titleCompany` groups on the title company named on the deed, with spellings of one company merged per bucket (`label` = most-used spelling across the response, `id` = normalized name — match on `id`) and \"none available\"-style placeholders excluded.",
         "enum": [
@@ -46560,7 +47536,7 @@
   "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.102.2"
+    "version": "3.103.1"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -48436,7 +49412,7 @@
     },
     "/v1/agents/{id}/breakdowns/builders": {
       "post": {
-        "description": "New-construction builders named on the agent's deals in the period, ranked by units. Spellings of one builder are one row (case, punctuation, legal suffixes such as LLC, a trailing \"of <State>\", generic words such as Homes, letter typos) with `units` summed; `label` / `id` are those of its most common spelling, and distinct companies (a builder's subsidiaries) stay separate. The pre-aggregated builder list carries a deal COUNT only, so every row's `volume` and `pctVolume` are 0 — rank and share by `units` / `pctUnits` (a share of ALL the agent's deals in the period, so the rows sum to the builder-sold share, not to 1). It carries no buyer/listing split either: `side` must be `any` (or omitted); `buyer`/`listing` return 400.",
+        "description": "New-construction builders named on the agent's deals in the period, ranked by units. Spellings of one builder are one row (case, punctuation, legal suffixes such as LLC, a trailing \"of <State>\", generic words such as Homes, letter typos) with `units` summed; `label` / `id` are those of its most common spelling, and distinct companies (a builder's subsidiaries) stay separate. Feed placeholders (\"Unknown\", \"Unk\", \"N/A\", \"-\", \"TBD\", \"None\", \"Other\", …) are not builders and are dropped. The pre-aggregated builder list carries a deal COUNT only, so every row's `volume` and `pctVolume` are 0 — rank and share by `units` / `pctUnits` (a share of ALL the agent's deals in the period, so the rows sum to the builder-sold share, not to 1). It carries no buyer/listing split either: `side` must be `any` (or omitted); `buyer`/`listing` return 400.",
         "operationId": "agentBuilders",
         "parameters": [
           {
@@ -76853,7 +77829,7 @@
     },
     "/v1/offices/{id}/breakdowns/builders": {
       "post": {
-        "description": "New-construction builders named on the office's deals in the period, ranked by units. Spellings of one builder (case, punctuation, legal suffixes, a trailing \"of <State>\", generic words such as Homes, letter typos) are one row with `units` summed; distinct companies stay separate. Deal COUNT only: every row's `volume` / `pctVolume` is 0 and `pctUnits` is a share of ALL the office's deals. No buyer/listing split: `side` must be `any` (or omitted).",
+        "description": "New-construction builders named on the office's deals in the period, ranked by units. Spellings of one builder (case, punctuation, legal suffixes, a trailing \"of <State>\", generic words such as Homes, letter typos) are one row with `units` summed; distinct companies stay separate. Feed placeholders (\"Unknown\", \"N/A\", \"-\", \"TBD\", …) are dropped. Deal COUNT only: every row's `volume` / `pctVolume` is 0 and `pctUnits` is a share of ALL the office's deals. No buyer/listing split: `side` must be `any` (or omitted).",
         "operationId": "officeBuilders",
         "parameters": [
           {
@@ -78126,207 +79102,309 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Count originators matching filters",
-        "tags": [
-          "Originators"
-        ],
-        "x-mm-records-via": "listOriginators"
-      }
-    },
-    "/v1/originators/{id}/related": {
-      "get": {
-        "description": "Return the ids of records of another type that are linked to this record. Links resolve by identifier, strongest identifier first, and equally-trusted identifiers are combined — a company's linked loans cover every role it holds on a loan, not just the first one found. The response reports which strength was used: `primary` is the canonical identifier for that pair, `secondary` is a real but weaker alternate used only when the record carries nothing better. This is a lightweight index: it returns ids and a count, not full records. For filtering, sorting, pagination and full detail, use the named endpoint for the pair (for example the originator loans endpoint) and fetch records by id.",
-        "operationId": "originatorRelated",
-        "parameters": [
-          {
-            "description": "Originator NMLS ID",
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "description": "Originator NMLS ID",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Type of record to link to",
-            "in": "query",
-            "name": "to",
-            "required": true,
-            "schema": {
-              "description": "Type of record to link to",
-              "enum": [
-                "companies",
-                "loans",
-                "properties"
-              ],
-              "type": "string"
-            }
-          },
-          {
-            "description": "Maximum ids to return (default 25, max 200)",
-            "in": "query",
-            "name": "limit",
-            "required": false,
-            "schema": {
-              "description": "Maximum ids to return (default 25, max 200)",
-              "maximum": 200,
-              "minimum": 1,
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/RelatedResponse"
-                }
-              }
-            },
-            "description": "Linked record ids"
-          },
-          "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": "Record 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/SearchUnavailable"
-                }
-              }
-            },
-            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
-          }
-        },
-        "summary": "Records linked to this one",
-        "tags": [
-          "Related"
-        ]
-      }
-    },
-    "/v1/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",
+        "summary": "Count originators matching filters",
+        "tags": [
+          "Originators"
+        ],
+        "x-mm-records-via": "listOriginators"
+      }
+    },
+    "/v1/originators/{id}/related": {
+      "get": {
+        "description": "Return the ids of records of another type that are linked to this record. Links resolve by identifier, strongest identifier first, and equally-trusted identifiers are combined — a company's linked loans cover every role it holds on a loan, not just the first one found. The response reports which strength was used: `primary` is the canonical identifier for that pair, `secondary` is a real but weaker alternate used only when the record carries nothing better. This is a lightweight index: it returns ids and a count, not full records. For filtering, sorting, pagination and full detail, use the named endpoint for the pair (for example the originator loans endpoint) and fetch records by id.",
+        "operationId": "originatorRelated",
+        "parameters": [
+          {
+            "description": "Originator NMLS ID",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "Originator NMLS ID",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Type of record to link to",
+            "in": "query",
+            "name": "to",
+            "required": true,
+            "schema": {
+              "description": "Type of record to link to",
+              "enum": [
+                "companies",
+                "loans",
+                "properties"
+              ],
+              "type": "string"
+            }
+          },
+          {
+            "description": "Maximum ids to return (default 25, max 200)",
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "description": "Maximum ids to return (default 25, max 200)",
+              "maximum": 200,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RelatedResponse"
+                }
+              }
+            },
+            "description": "Linked record ids"
+          },
+          "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": "Record 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/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Records linked to this one",
+        "tags": [
+          "Related"
+        ]
+      }
+    },
+    "/v1/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"
+        ]
+      }
+    },
+    "/v1/originators/{nmlsId}/breakdowns/agents": {
+      "post": {
+        "description": "Ranks the real-estate agents on this LO's loans, by volume — the buyer's agent by default, the listing and co-listing agents with `side: \"listing\"`. Each loan is credited to the agent its MLS agent keys resolve to (a key naming several different people credits only the confirmed one), so `units` counts distinct loans per agent. `id` is that agent's id (pass it to `GET /v1/agents/{id}`); absent when the loan's key matches no agent profile, in which case `label` is the name the MLS recorded. Names that are an MLS placeholder for \"no agent recorded\" (`non member`, `non listed agent`, and ~140 board-specific spellings) are excluded — they are not people. 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/OriginatorAgentsBreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentSidedBreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the LO's loans by real-estate 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"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Real-estate agents this LO co-closed with",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/agents": {
+    "/v1/originators/{nmlsId}/breakdowns/branches": {
       "post": {
-        "description": "Ranks the real-estate agents on this LO's loans, by volume — the buyer's agent by default, the listing and co-listing agents with `side: \"listing\"`. Each loan is credited to the agent its MLS agent keys resolve to (a key naming several different people credits only the confirmed one), so `units` counts distinct loans per agent. `id` is that agent's id (pass it to `GET /v1/agents/{id}`); absent when the loan's key matches no agent profile, in which case `label` is the name the MLS recorded. Names that are an MLS placeholder for \"no agent recorded\" (`non member`, `non listed agent`, and ~140 board-specific spellings) are excluded — they are not people. Percentages are shares of the LO's whole loan population, so they do not sum to 100 across the page.",
-        "operationId": "originatorAgents",
+        "operationId": "originatorBranches",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78343,7 +79421,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/OriginatorAgentsBreakdownRequest"
+                "$ref": "#/components/schemas/BreakdownRequest"
               }
             }
           }
@@ -78353,11 +79431,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentSidedBreakdownResponse"
+                  "$ref": "#/components/schemas/BreakdownResponse"
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by real-estate agent"
+            "description": "Breakdown of the LO's loans by branches"
           },
           "400": {
             "content": {
@@ -78420,15 +79498,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Real-estate agents this LO co-closed with",
+        "summary": "Branch (broker) history for this LO",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/branches": {
+    "/v1/originators/{nmlsId}/breakdowns/brokers": {
       "post": {
-        "operationId": "originatorBranches",
+        "operationId": "originatorBrokers",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78459,7 +79537,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by branches"
+            "description": "Breakdown of the LO's loans by brokers"
           },
           "400": {
             "content": {
@@ -78522,15 +79600,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Branch (broker) history for this LO",
+        "summary": "Broker shops this LO originated loans through (name-resolved)",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/brokers": {
+    "/v1/originators/{nmlsId}/breakdowns/builders": {
       "post": {
-        "operationId": "originatorBrokers",
+        "description": "Ranks the home builders behind this LO's new-construction loans, by volume. A loan counts when `originatorLoans` with `flatFilters.hasBuilder: true` keeps it, and is credited to the `builderName` that list shows on its row (the parcel's newest builder-named sale, else the builder named on the loan or its builder seller of record) — so a row's `units` equals that list's rows naming any of the builder's spellings. Spellings of one builder are one row (case, punctuation, legal suffixes such as LLC/LP, a trailing \"of <State>\", generic words such as Homes, and letter typos), with `units` and `volume` summed; `label` is the most common spelling and `id` its normalized key. Distinct companies (a builder's subsidiaries) stay separate rows. Feed placeholders (\"Unknown\", \"N/A\", \"-\", \"TBD\", …) are not builders: their loans get no row. Percentages are shares of the LO's whole loan population in scope, so rows do not sum to 100. More than 50,000 loans in scope is a 400 (narrow the period); `truncated` is set when the builder loans exceed that cap.",
+        "operationId": "originatorBuilders",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78561,7 +79640,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by brokers"
+            "description": "Breakdown of the LO's builder loans by home builder"
           },
           "400": {
             "content": {
@@ -78624,16 +79703,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Broker shops this LO originated loans through (name-resolved)",
+        "summary": "Home builders on this LO's new-construction loans",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/builders": {
+    "/v1/originators/{nmlsId}/breakdowns/cities": {
       "post": {
-        "description": "Ranks the home builders behind this LO's new-construction loans, by volume. A loan counts when `originatorLoans` with `flatFilters.hasBuilder: true` keeps it, and is credited to the `builderName` that list shows on its row (the parcel's newest builder-named sale, else the builder named on the loan or its builder seller of record) — so a row's `units` equals that list's rows naming any of the builder's spellings. Spellings of one builder are one row (case, punctuation, legal suffixes such as LLC/LP, a trailing \"of <State>\", generic words such as Homes, and letter typos), with `units` and `volume` summed; `label` is the most common spelling and `id` its normalized key. Distinct companies (a builder's subsidiaries) stay separate rows. Percentages are shares of the LO's whole loan population in scope, so rows do not sum to 100. More than 50,000 loans in scope is a 400 (narrow the period); `truncated` is set when the builder loans exceed that cap.",
-        "operationId": "originatorBuilders",
+        "operationId": "originatorCitiesBreakdown",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78664,7 +79742,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's builder loans by home builder"
+            "description": "Breakdown of the LO's loans by cities"
           },
           "400": {
             "content": {
@@ -78727,15 +79805,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Home builders on this LO's new-construction loans",
+        "summary": "City volume breakdown across this LO's loans",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/cities": {
+    "/v1/originators/{nmlsId}/breakdowns/companies": {
       "post": {
-        "operationId": "originatorCitiesBreakdown",
+        "operationId": "originatorCompanies",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78766,7 +79844,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by cities"
+            "description": "Breakdown of the LO's loans by companies"
           },
           "400": {
             "content": {
@@ -78829,15 +79907,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "City volume breakdown across this LO's loans",
+        "summary": "Funding companies (employer history) for this LO",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/companies": {
+    "/v1/originators/{nmlsId}/breakdowns/counties": {
       "post": {
-        "operationId": "originatorCompanies",
+        "operationId": "originatorCountiesBreakdown",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78868,7 +79946,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by companies"
+            "description": "Breakdown of the LO's loans by counties"
           },
           "400": {
             "content": {
@@ -78931,15 +80009,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Funding companies (employer history) for this LO",
+        "summary": "County (FIPS) volume breakdown across this LO's loans",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/counties": {
+    "/v1/originators/{nmlsId}/breakdowns/lenders": {
       "post": {
-        "operationId": "originatorCountiesBreakdown",
+        "operationId": "originatorLenders",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -78970,7 +80048,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by counties"
+            "description": "Breakdown of the LO's loans by lenders"
           },
           "400": {
             "content": {
@@ -79033,15 +80111,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "County (FIPS) volume breakdown across this LO's loans",
+        "summary": "Lenders this LO has originated through",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/lenders": {
+    "/v1/originators/{nmlsId}/breakdowns/offices": {
       "post": {
-        "operationId": "originatorLenders",
+        "operationId": "originatorOffices",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -79072,7 +80150,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by lenders"
+            "description": "Breakdown of the LO's loans by broker (office)"
           },
           "400": {
             "content": {
@@ -79135,15 +80213,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Lenders this LO has originated through",
+        "summary": "Real-estate offices this LO closed through (with sponsoring company)",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/offices": {
+    "/v1/originators/{nmlsId}/breakdowns/states": {
       "post": {
-        "operationId": "originatorOffices",
+        "operationId": "originatorStatesBreakdown",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -79174,7 +80252,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by broker (office)"
+            "description": "Breakdown of the LO's loans by states"
           },
           "400": {
             "content": {
@@ -79237,15 +80315,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Real-estate offices this LO closed through (with sponsoring company)",
+        "summary": "State volume breakdown across this LO's loans",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/states": {
+    "/v1/originators/{nmlsId}/breakdowns/title-companies": {
       "post": {
-        "operationId": "originatorStatesBreakdown",
+        "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",
@@ -79276,7 +80355,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by states"
+            "description": "Breakdown of the entity's loans by title company"
           },
           "400": {
             "content": {
@@ -79339,16 +80418,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "State volume breakdown across this LO's loans",
+        "summary": "Title companies on this LO's loans (spellings merged)",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/title-companies": {
+    "/v1/originators/{nmlsId}/breakdowns/zip-codes": {
       "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",
+        "operationId": "originatorZipCodes",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -79379,7 +80457,7 @@
                 }
               }
             },
-            "description": "Breakdown of the entity's loans by title company"
+            "description": "Breakdown of the LO's loans by zip-codes"
           },
           "400": {
             "content": {
@@ -79442,15 +80520,15 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Title companies on this LO's loans (spellings merged)",
+        "summary": "Zip-code volume breakdown",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/breakdowns/zip-codes": {
+    "/v1/originators/{nmlsId}/loans": {
       "post": {
-        "operationId": "originatorZipCodes",
+        "operationId": "originatorLoans",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -79467,7 +80545,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
+                "$ref": "#/components/schemas/LoanListRequest"
               }
             }
           }
@@ -79477,11 +80555,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BreakdownResponse"
+                  "$ref": "#/components/schemas/LoanListResponse"
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by zip-codes"
+            "description": "Paginated list of loans originated by this LO"
           },
           "400": {
             "content": {
@@ -79544,15 +80622,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Zip-code volume breakdown",
+        "summary": "Loans originated by this LO",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/loans": {
+    "/v1/originators/{nmlsId}/markets": {
       "post": {
-        "operationId": "originatorLoans",
+        "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",
@@ -79569,7 +80648,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/LoanListRequest"
+                "$ref": "#/components/schemas/OriginatorMarketsRequest"
               }
             }
           }
@@ -79579,11 +80658,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/LoanListResponse"
+                  "$ref": "#/components/schemas/OriginatorMarketsResponse"
                 }
               }
             },
-            "description": "Paginated list of loans originated by this LO"
+            "description": "The LO's blended market footprint"
           },
           "400": {
             "content": {
@@ -79623,7 +80702,7 @@
                 }
               }
             },
-            "description": "Not found"
+            "description": "Originator not found"
           },
           "413": {
             "content": {
@@ -79646,16 +80725,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Loans originated by this LO",
+        "summary": "The markets this LO lends in",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/markets": {
+    "/v1/originators/{nmlsId}/properties": {
       "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",
+        "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",
@@ -79672,7 +80751,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/OriginatorMarketsRequest"
+                "$ref": "#/components/schemas/PropertyListRequest"
               }
             }
           }
@@ -79682,11 +80761,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/OriginatorMarketsResponse"
+                  "$ref": "#/components/schemas/PropertyListResponse"
                 }
               }
             },
-            "description": "The LO's blended market footprint"
+            "description": "Paginated list of parcels attributed to this LO"
           },
           "400": {
             "content": {
@@ -79726,7 +80805,7 @@
                 }
               }
             },
-            "description": "Originator not found"
+            "description": "Not found"
           },
           "413": {
             "content": {
@@ -79749,16 +80828,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "The markets this LO lends in",
+        "summary": "Properties this loan officer has touched",
         "tags": [
           "Originators"
         ]
       }
     },
-    "/v1/originators/{nmlsId}/properties": {
+    "/v1/originators/{nmlsId}/retention": {
       "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",
+        "description": "Classifies every loan this LO originated since 2017 against every later loan and MLS sale on the same parcel, for the period `start`–`end`: borrowers kept (the LO refinanced them again), lost (refinanced elsewhere — `churnedLoans`, with who captured them), sold, or a second lien taken elsewhere. Returns the summary, capture lanes (same funding lender vs other companies), capturing companies / LOs (top 25 + full-population totals), timing, monthly trend, the newest 500 loss rows, and exit signals on the retained book (`atRisk`). `compare` adds a second period's `summary` and monthly trend (`previous`) from the same scan. A very large book that cannot be read in time answers `status: \"timeout\"`.",
+        "operationId": "originatorRetention",
         "parameters": [
           {
             "description": "Originator NMLS ID",
@@ -79775,7 +80854,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/PropertyListRequest"
+                "$ref": "#/components/schemas/OriginatorRetentionRequest"
               }
             }
           }
@@ -79785,11 +80864,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/PropertyListResponse"
+                  "$ref": "#/components/schemas/OriginatorRetention"
                 }
               }
             },
-            "description": "Paginated list of parcels attributed to this LO"
+            "description": "Retention report"
           },
           "400": {
             "content": {
@@ -79852,7 +80931,7 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Properties this loan officer has touched",
+        "summary": "Borrower retention report for this LO",
         "tags": [
           "Originators"
         ]