@model-match/api 3.23.0 → 3.25.0

package/openapi.json

@@ -4739,6 +4739,692 @@
         ],
         "type": "object"
       },
+      "AgentLoanMixRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "advancedFilters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "filters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "flatFilters": {
+            "additionalProperties": false,
+            "properties": {
+              "borrowerStatus": {
+                "$ref": "#/components/schemas/LoanBorrowerStatusFilterValue"
+              },
+              "broker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Broker shop NMLS id (digits only). A broker is a company — resolve a broker name to its NMLS id via instantSearch (or listCompanies)."
+                  }
+                ]
+              },
+              "buyerEntityType": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "city": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "conforming": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "county": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "County name (e.g. \"Broward\") or 5-digit FIPS code. Names resolve to FIPS server-side; include a `state` filter to disambiguate."
+                  }
+                ]
+              },
+              "currentBalance": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Estimated remaining principal balance (~19% populated). Approximate current equity as `homeValue` (AVM) minus this."
+                  }
+                ]
+              },
+              "employer": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Employer/company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "equity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Point-in-time equity recorded on the loan (sparse, ~10%). NOT a live current-equity figure. For HELOC/cash-out targeting on up-to-date equity, use properties search (listProperties) instead — its equity is far better populated and current."
+                  }
+                ]
+              },
+              "excludeBroker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans brokered by this broker-shop NMLS id (digits only) — the inverse of `broker`."
+                  }
+                ]
+              },
+              "excludeCity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this city — the inverse of `city`."
+                  }
+                ]
+              },
+              "excludeLender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans from this lender ID (\"everyone but X\") — the inverse of `lender`, same id contract (resolve via instantSearch/listLenders). Loans with no lender stay in the results."
+                  }
+                ]
+              },
+              "excludeLoanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans funded by this company NMLS id (digits only) — the inverse of `loanCompany`."
+                  }
+                ]
+              },
+              "excludeOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans with this originator NMLS id (digits only) — the inverse of `originator`. Common for 'everyone but my own shop' lists."
+                  }
+                ]
+              },
+              "excludeState": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this state (2-letter code, e.g. \"CA\") — the inverse of `state`. For \"everywhere but this state\" lists."
+                  }
+                ]
+              },
+              "excludeZipCode": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this ZIP code — the inverse of `zipCode`."
+                  }
+                ]
+              },
+              "fips": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exact 5-digit county FIPS code (no name resolution) — the code-only escape hatch alongside `county`."
+                  }
+                ]
+              },
+              "geoPoint": {
+                "$ref": "#/components/schemas/GeoFilterValue"
+              },
+              "homeValue": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "AVM (automated valuation) at the linked property (~26%, MLS-linked). Pair with `currentBalance` to approximate current equity."
+                  }
+                ]
+              },
+              "includeUnknownOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/BooleanFilterValue"
+                  },
+                  {
+                    "description": "Include loans that have no originator NMLS id. Omitted/false (default): such loans are excluded — the vast majority are pre-2016 public records with no linkable originator. true: include them. Note that the default scopes results to loans with a known originator (~2016+ recordings)."
+                  }
+                ]
+              },
+              "interestRate": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "lender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender ID — the normalized lender-dictionary key, NOT a fuzzy name match. Resolve a lender via instantSearch (or listLenders) and pass the `id` it returns (e.g. \"mortgage_rocket\" or \"mortgage rocket\"). Underscores and letter case are normalized, so either id surface works. A stored normalized lender name (what the `slice: \"lender\"` chart buckets emit) is also accepted, so a chart bucket key filters directly. A value that is neither returns 400 rather than silently matching nothing — to search by lender NAME, use `lenderName`."
+                  }
+                ]
+              },
+              "lenderName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender name as recorded on the loan document — fuzzy, all-terms match (e.g. \"Fifth Third\"). The name counterpart to the exact-id `lender` filter; use `lender` when you have a resolved id, and this when you only have a name."
+                  }
+                ]
+              },
+              "loanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Funding/loan company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "loanType": {
+                "$ref": "#/components/schemas/LoanTypeFilterValue"
+              },
+              "ltvAtOrigination": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Loan-to-value at ORIGINATION (sparse), as a PERCENT on a 0-100 scale (`80` = 80% LTV; values above 100 are real underwater loans). This is not a current LTV — there is no stored current-LTV field on loans."
+                  }
+                ]
+              },
+              "mode": {
+                "enum": [
+                  "and",
+                  "or"
+                ],
+                "type": "string"
+              },
+              "mortgageAmount": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "mortgageDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "originator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Loan originator NMLS id (digits only). To search by name use `originatorName`, or resolve a name to its id via instantSearch."
+                  }
+                ]
+              },
+              "originatorName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "deprecated": true,
+                    "description": "DEPRECATED — fuzzy name matching is unreliable (same originator can return wildly different counts by name string). Resolve the loan officer via instantSearch and filter by `originator` (exact NMLS id) instead. Still functional for now."
+                  }
+                ]
+              },
+              "propertyId": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Parcel id — returns every loan recorded against one property. Pass the same string this endpoint returns as `mmPropertyId` on a loan row, or the `mmPropertyId` of a property record.\n\nThis is the parcel's FULL recorded loan history, which is deliberately wider than the loans embedded on a property record: that embed is a snapshot of what is still owed (up to five currently-active loans), so paid-off mortgages are absent from it and present here.\n\nMulti-unit caveat: loans carry a unit-blind parcel id, so for one unit of a multi-unit building this selects every unit in the building, not that unit alone."
+                  }
+                ]
+              },
+              "saleDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "salePrice": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "state": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "transactionType": {
+                "$ref": "#/components/schemas/LoanTransactionTypeFilterValue"
+              },
+              "zip": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Alias of `zipCode` — same ZIP filter, accepted for cross-entity key parity."
+                  }
+                ]
+              },
+              "zipCode": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              }
+            },
+            "type": "object"
+          },
+          "period": {
+            "$ref": "#/components/schemas/DatedPeriod"
+          }
+        },
+        "type": "object"
+      },
+      "AgentLoanMixResponse": {
+        "description": "`buyer` + `listing` = `any` (dual deals are counted on `buyer`).",
+        "properties": {
+          "any": {
+            "$ref": "#/components/schemas/AgentLoanMixSide"
+          },
+          "buyer": {
+            "$ref": "#/components/schemas/AgentLoanMixSide"
+          },
+          "listing": {
+            "$ref": "#/components/schemas/AgentLoanMixSide"
+          }
+        },
+        "required": [
+          "any",
+          "buyer",
+          "listing"
+        ],
+        "type": "object"
+      },
+      "AgentLoanMixSide": {
+        "properties": {
+          "loanTypes": {
+            "description": "Loan-type mix of `units`, most deals first. Deals with no recorded loan type are absent, so the rows can sum to less than `units`.",
+            "items": {
+              "$ref": "#/components/schemas/AgentLoanMixType"
+            },
+            "type": "array"
+          },
+          "tpoUnits": {
+            "description": "Of `units`, deals originated through a mortgage broker (a broker NMLS id on the loan) — third-party origination. TPO share = `tpoUnits / units`.",
+            "type": "number"
+          },
+          "tpoVolume": {
+            "description": "Loan amount of the TPO deals.",
+            "type": "number"
+          },
+          "units": {
+            "description": "Financed deals (recorded loans) on this side in the window.",
+            "type": "number"
+          },
+          "volume": {
+            "description": "Total loan amount of those deals (out-of-range fill amounts excluded).",
+            "type": "number"
+          }
+        },
+        "required": [
+          "units",
+          "volume",
+          "tpoUnits",
+          "tpoVolume",
+          "loanTypes"
+        ],
+        "type": "object"
+      },
+      "AgentLoanMixType": {
+        "properties": {
+          "label": {
+            "description": "Loan type (e.g. `conventional`, `fha`, `va`)",
+            "type": "string"
+          },
+          "units": {
+            "type": "number"
+          },
+          "volume": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "label",
+          "units",
+          "volume"
+        ],
+        "type": "object"
+      },
+      "AgentLoansBreakdownRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "advancedFilters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "filters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "flatFilters": {
+            "additionalProperties": false,
+            "properties": {
+              "borrowerStatus": {
+                "$ref": "#/components/schemas/LoanBorrowerStatusFilterValue"
+              },
+              "broker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Broker shop NMLS id (digits only). A broker is a company — resolve a broker name to its NMLS id via instantSearch (or listCompanies)."
+                  }
+                ]
+              },
+              "buyerEntityType": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "city": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "conforming": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "county": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "County name (e.g. \"Broward\") or 5-digit FIPS code. Names resolve to FIPS server-side; include a `state` filter to disambiguate."
+                  }
+                ]
+              },
+              "currentBalance": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Estimated remaining principal balance (~19% populated). Approximate current equity as `homeValue` (AVM) minus this."
+                  }
+                ]
+              },
+              "employer": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Employer/company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "equity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Point-in-time equity recorded on the loan (sparse, ~10%). NOT a live current-equity figure. For HELOC/cash-out targeting on up-to-date equity, use properties search (listProperties) instead — its equity is far better populated and current."
+                  }
+                ]
+              },
+              "excludeBroker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans brokered by this broker-shop NMLS id (digits only) — the inverse of `broker`."
+                  }
+                ]
+              },
+              "excludeCity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this city — the inverse of `city`."
+                  }
+                ]
+              },
+              "excludeLender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans from this lender ID (\"everyone but X\") — the inverse of `lender`, same id contract (resolve via instantSearch/listLenders). Loans with no lender stay in the results."
+                  }
+                ]
+              },
+              "excludeLoanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans funded by this company NMLS id (digits only) — the inverse of `loanCompany`."
+                  }
+                ]
+              },
+              "excludeOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans with this originator NMLS id (digits only) — the inverse of `originator`. Common for 'everyone but my own shop' lists."
+                  }
+                ]
+              },
+              "excludeState": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this state (2-letter code, e.g. \"CA\") — the inverse of `state`. For \"everywhere but this state\" lists."
+                  }
+                ]
+              },
+              "excludeZipCode": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this ZIP code — the inverse of `zipCode`."
+                  }
+                ]
+              },
+              "fips": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exact 5-digit county FIPS code (no name resolution) — the code-only escape hatch alongside `county`."
+                  }
+                ]
+              },
+              "geoPoint": {
+                "$ref": "#/components/schemas/GeoFilterValue"
+              },
+              "homeValue": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "AVM (automated valuation) at the linked property (~26%, MLS-linked). Pair with `currentBalance` to approximate current equity."
+                  }
+                ]
+              },
+              "includeUnknownOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/BooleanFilterValue"
+                  },
+                  {
+                    "description": "Include loans that have no originator NMLS id. Omitted/false (default): such loans are excluded — the vast majority are pre-2016 public records with no linkable originator. true: include them. Note that the default scopes results to loans with a known originator (~2016+ recordings)."
+                  }
+                ]
+              },
+              "interestRate": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "lender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender ID — the normalized lender-dictionary key, NOT a fuzzy name match. Resolve a lender via instantSearch (or listLenders) and pass the `id` it returns (e.g. \"mortgage_rocket\" or \"mortgage rocket\"). Underscores and letter case are normalized, so either id surface works. A stored normalized lender name (what the `slice: \"lender\"` chart buckets emit) is also accepted, so a chart bucket key filters directly. A value that is neither returns 400 rather than silently matching nothing — to search by lender NAME, use `lenderName`."
+                  }
+                ]
+              },
+              "lenderName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender name as recorded on the loan document — fuzzy, all-terms match (e.g. \"Fifth Third\"). The name counterpart to the exact-id `lender` filter; use `lender` when you have a resolved id, and this when you only have a name."
+                  }
+                ]
+              },
+              "loanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Funding/loan company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "loanType": {
+                "$ref": "#/components/schemas/LoanTypeFilterValue"
+              },
+              "ltvAtOrigination": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Loan-to-value at ORIGINATION (sparse), as a PERCENT on a 0-100 scale (`80` = 80% LTV; values above 100 are real underwater loans). This is not a current LTV — there is no stored current-LTV field on loans."
+                  }
+                ]
+              },
+              "mode": {
+                "enum": [
+                  "and",
+                  "or"
+                ],
+                "type": "string"
+              },
+              "mortgageAmount": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "mortgageDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "originator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Loan originator NMLS id (digits only). To search by name use `originatorName`, or resolve a name to its id via instantSearch."
+                  }
+                ]
+              },
+              "originatorName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "deprecated": true,
+                    "description": "DEPRECATED — fuzzy name matching is unreliable (same originator can return wildly different counts by name string). Resolve the loan officer via instantSearch and filter by `originator` (exact NMLS id) instead. Still functional for now."
+                  }
+                ]
+              },
+              "propertyId": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Parcel id — returns every loan recorded against one property. Pass the same string this endpoint returns as `mmPropertyId` on a loan row, or the `mmPropertyId` of a property record.\n\nThis is the parcel's FULL recorded loan history, which is deliberately wider than the loans embedded on a property record: that embed is a snapshot of what is still owed (up to five currently-active loans), so paid-off mortgages are absent from it and present here.\n\nMulti-unit caveat: loans carry a unit-blind parcel id, so for one unit of a multi-unit building this selects every unit in the building, not that unit alone."
+                  }
+                ]
+              },
+              "saleDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "salePrice": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "state": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "transactionType": {
+                "$ref": "#/components/schemas/LoanTransactionTypeFilterValue"
+              },
+              "zip": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Alias of `zipCode` — same ZIP filter, accepted for cross-entity key parity."
+                  }
+                ]
+              },
+              "zipCode": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              }
+            },
+            "type": "object"
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination"
+          },
+          "period": {
+            "$ref": "#/components/schemas/DatedPeriod"
+          },
+          "side": {
+            "$ref": "#/components/schemas/AgentSide"
+          },
+          "sort": {
+            "$ref": "#/components/schemas/BreakdownSort"
+          }
+        },
+        "type": "object"
+      },
       "AgentMarket": {
         "properties": {
           "avgSalePrice": {
@@ -5221,6 +5907,9 @@
           "period": {
             "$ref": "#/components/schemas/Period"
           },
+          "side": {
+            "$ref": "#/components/schemas/AgentSide"
+          },
           "sort": {
             "items": {
               "properties": {
@@ -5262,10 +5951,96 @@
             "nullable": true,
             "type": "string"
           },
+          "loan": {
+            "description": "The purchase loan recorded against this sale (matched on the sale id), or `null` when none is recorded — a cash deal, or a loan not yet on file.",
+            "nullable": true,
+            "properties": {
+              "amount": {
+                "nullable": true,
+                "type": "number"
+              },
+              "brokerNmlsId": {
+                "description": "Mortgage broker NMLS id when the loan was third-party originated",
+                "nullable": true,
+                "type": "string"
+              },
+              "companyName": {
+                "description": "Mortgage company the loan was written under",
+                "nullable": true,
+                "type": "string"
+              },
+              "companyNmlsId": {
+                "nullable": true,
+                "type": "string"
+              },
+              "id": {
+                "description": "Loan id (`GET /v1/loans/{id}`)",
+                "type": "string"
+              },
+              "lenderId": {
+                "description": "Normalized lender key — the value the `lender` filter accepts",
+                "nullable": true,
+                "type": "string"
+              },
+              "lenderName": {
+                "description": "Lender as written on the loan document",
+                "nullable": true,
+                "type": "string"
+              },
+              "loanType": {
+                "description": "e.g. `conventional`, `fha`, `va`",
+                "nullable": true,
+                "type": "string"
+              },
+              "originatorName": {
+                "nullable": true,
+                "type": "string"
+              },
+              "originatorNmlsId": {
+                "nullable": true,
+                "type": "string"
+              },
+              "titleCompany": {
+                "nullable": true,
+                "type": "string"
+              },
+              "transactionType": {
+                "description": "e.g. `purchase`, `refinance`",
+                "nullable": true,
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "amount",
+              "loanType",
+              "transactionType",
+              "lenderName",
+              "lenderId",
+              "originatorName",
+              "originatorNmlsId",
+              "companyName",
+              "companyNmlsId",
+              "brokerNmlsId",
+              "titleCompany"
+            ],
+            "type": "object"
+          },
           "price": {
             "nullable": true,
             "type": "number"
           },
+          "side": {
+            "description": "Which side of this deal the agent was on: `buyer`, `listing`, or `dual` (both). `null` when the sale names the agent under an id this API cannot place on a side.",
+            "enum": [
+              "buyer",
+              "listing",
+              "dual",
+              null
+            ],
+            "nullable": true,
+            "type": "string"
+          },
           "soldAgentName": {
             "nullable": true,
             "type": "string"
@@ -5310,6 +6085,29 @@
         ],
         "type": "object"
       },
+      "AgentScoredBreakdownRequest": {
+        "properties": {
+          "period": {
+            "$ref": "#/components/schemas/Period"
+          },
+          "side": {
+            "$ref": "#/components/schemas/AgentSide"
+          },
+          "sort": {
+            "$ref": "#/components/schemas/BreakdownSort"
+          }
+        },
+        "type": "object"
+      },
+      "AgentSide": {
+        "description": "Which side of the deal the agent was on. `buyer`: the agent represented the buyer — deals where the agent was on BOTH sides (dual) count here. `listing`: the agent represented the seller only (duals are already in `buyer`). `any` (default): either side, each deal once. `buyer` + `listing` = `any`.",
+        "enum": [
+          "any",
+          "buyer",
+          "listing"
+        ],
+        "type": "string"
+      },
       "AgentSummary": {
         "properties": {
           "avgSoldPrice": {
@@ -5453,6 +6251,316 @@
         },
         "type": "object"
       },
+      "AgentTitleCompanyTimeSeriesRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "advancedFilters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "filters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "flatFilters": {
+            "additionalProperties": false,
+            "properties": {
+              "borrowerStatus": {
+                "$ref": "#/components/schemas/LoanBorrowerStatusFilterValue"
+              },
+              "broker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Broker shop NMLS id (digits only). A broker is a company — resolve a broker name to its NMLS id via instantSearch (or listCompanies)."
+                  }
+                ]
+              },
+              "buyerEntityType": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "city": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "conforming": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "county": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "County name (e.g. \"Broward\") or 5-digit FIPS code. Names resolve to FIPS server-side; include a `state` filter to disambiguate."
+                  }
+                ]
+              },
+              "currentBalance": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Estimated remaining principal balance (~19% populated). Approximate current equity as `homeValue` (AVM) minus this."
+                  }
+                ]
+              },
+              "employer": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Employer/company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "equity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Point-in-time equity recorded on the loan (sparse, ~10%). NOT a live current-equity figure. For HELOC/cash-out targeting on up-to-date equity, use properties search (listProperties) instead — its equity is far better populated and current."
+                  }
+                ]
+              },
+              "excludeBroker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans brokered by this broker-shop NMLS id (digits only) — the inverse of `broker`."
+                  }
+                ]
+              },
+              "excludeCity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this city — the inverse of `city`."
+                  }
+                ]
+              },
+              "excludeLender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans from this lender ID (\"everyone but X\") — the inverse of `lender`, same id contract (resolve via instantSearch/listLenders). Loans with no lender stay in the results."
+                  }
+                ]
+              },
+              "excludeLoanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans funded by this company NMLS id (digits only) — the inverse of `loanCompany`."
+                  }
+                ]
+              },
+              "excludeOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans with this originator NMLS id (digits only) — the inverse of `originator`. Common for 'everyone but my own shop' lists."
+                  }
+                ]
+              },
+              "excludeState": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this state (2-letter code, e.g. \"CA\") — the inverse of `state`. For \"everywhere but this state\" lists."
+                  }
+                ]
+              },
+              "excludeZipCode": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this ZIP code — the inverse of `zipCode`."
+                  }
+                ]
+              },
+              "fips": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exact 5-digit county FIPS code (no name resolution) — the code-only escape hatch alongside `county`."
+                  }
+                ]
+              },
+              "geoPoint": {
+                "$ref": "#/components/schemas/GeoFilterValue"
+              },
+              "homeValue": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "AVM (automated valuation) at the linked property (~26%, MLS-linked). Pair with `currentBalance` to approximate current equity."
+                  }
+                ]
+              },
+              "includeUnknownOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/BooleanFilterValue"
+                  },
+                  {
+                    "description": "Include loans that have no originator NMLS id. Omitted/false (default): such loans are excluded — the vast majority are pre-2016 public records with no linkable originator. true: include them. Note that the default scopes results to loans with a known originator (~2016+ recordings)."
+                  }
+                ]
+              },
+              "interestRate": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "lender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender ID — the normalized lender-dictionary key, NOT a fuzzy name match. Resolve a lender via instantSearch (or listLenders) and pass the `id` it returns (e.g. \"mortgage_rocket\" or \"mortgage rocket\"). Underscores and letter case are normalized, so either id surface works. A stored normalized lender name (what the `slice: \"lender\"` chart buckets emit) is also accepted, so a chart bucket key filters directly. A value that is neither returns 400 rather than silently matching nothing — to search by lender NAME, use `lenderName`."
+                  }
+                ]
+              },
+              "lenderName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender name as recorded on the loan document — fuzzy, all-terms match (e.g. \"Fifth Third\"). The name counterpart to the exact-id `lender` filter; use `lender` when you have a resolved id, and this when you only have a name."
+                  }
+                ]
+              },
+              "loanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Funding/loan company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "loanType": {
+                "$ref": "#/components/schemas/LoanTypeFilterValue"
+              },
+              "ltvAtOrigination": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Loan-to-value at ORIGINATION (sparse), as a PERCENT on a 0-100 scale (`80` = 80% LTV; values above 100 are real underwater loans). This is not a current LTV — there is no stored current-LTV field on loans."
+                  }
+                ]
+              },
+              "mode": {
+                "enum": [
+                  "and",
+                  "or"
+                ],
+                "type": "string"
+              },
+              "mortgageAmount": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "mortgageDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "originator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Loan originator NMLS id (digits only). To search by name use `originatorName`, or resolve a name to its id via instantSearch."
+                  }
+                ]
+              },
+              "originatorName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "deprecated": true,
+                    "description": "DEPRECATED — fuzzy name matching is unreliable (same originator can return wildly different counts by name string). Resolve the loan officer via instantSearch and filter by `originator` (exact NMLS id) instead. Still functional for now."
+                  }
+                ]
+              },
+              "propertyId": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Parcel id — returns every loan recorded against one property. Pass the same string this endpoint returns as `mmPropertyId` on a loan row, or the `mmPropertyId` of a property record.\n\nThis is the parcel's FULL recorded loan history, which is deliberately wider than the loans embedded on a property record: that embed is a snapshot of what is still owed (up to five currently-active loans), so paid-off mortgages are absent from it and present here.\n\nMulti-unit caveat: loans carry a unit-blind parcel id, so for one unit of a multi-unit building this selects every unit in the building, not that unit alone."
+                  }
+                ]
+              },
+              "saleDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "salePrice": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "state": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "transactionType": {
+                "$ref": "#/components/schemas/LoanTransactionTypeFilterValue"
+              },
+              "zip": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Alias of `zipCode` — same ZIP filter, accepted for cross-entity key parity."
+                  }
+                ]
+              },
+              "zipCode": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              }
+            },
+            "type": "object"
+          },
+          "interval": {
+            "$ref": "#/components/schemas/Interval"
+          },
+          "measure": {
+            "$ref": "#/components/schemas/Measure"
+          },
+          "period": {
+            "$ref": "#/components/schemas/DatedPeriod"
+          },
+          "side": {
+            "$ref": "#/components/schemas/AgentSide"
+          }
+        },
+        "type": "object"
+      },
       "AlertConditions": {
         "properties": {
           "epoThresholdDays": {
@@ -11308,12 +12416,30 @@
       },
       "BreakdownItem": {
         "properties": {
+          "company": {
+            "description": "Agent `originators` only: the LO's employer per NMLS licensing as of the agent profile's last refresh — not necessarily the company on the loans, and it can trail a very recent move (`GET /v1/originators/{nmlsId}` is always current). Absent on every other breakdown; `null` leaves when no sponsorship was on file.",
+            "properties": {
+              "name": {
+                "nullable": true,
+                "type": "string"
+              },
+              "nmlsId": {
+                "nullable": true,
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "nmlsId"
+            ],
+            "type": "object"
+          },
           "excluded": {
             "description": "How many of this bucket's documents the volume guard excluded — documents that carry the money field but whose value is an out-of-range fill. Compare against `units` to see what share of the bucket `volume` was actually computed over: a bucket can show many units and still sum a small fraction of them. Absent when the entity's money column is unguarded (the sales-backed agent breakdowns), where nothing can be excluded.",
             "type": "number"
           },
           "id": {
-            "description": "Machine value behind `label` for breakdowns whose bucket key is an id rather than a name (today: `lenders`, where `label` is the dictionary display name and `id` is the normalized lender key). Pass `id` — not `label` — back as a `lender` filter value. Absent on name-keyed breakdowns, where `label` is already the machine value.",
+            "description": "Machine value behind `label` for breakdowns whose bucket key is an id rather than a name (`lenders`, where `label` is the dictionary display name and `id` is the normalized lender key — pass `id`, not `label`, back as a `lender` filter value; agent `originators`, where `id` is the LO's NMLS id; `originatorAgents`, where `id` is the agent id most often recorded under that name; `titleCompanies`, where `id` is the normalized name the spellings were merged under). Absent on name-keyed breakdowns, where `label` is already the machine value.",
             "type": "string"
           },
           "label": {
@@ -30841,6 +31967,324 @@
         ],
         "type": "object"
       },
+      "OriginatorAgentSide": {
+        "description": "Which agent on the LO's loans to rank. `buyer` (default): the buyer's (selling) agent — the agent who brought the borrower. `listing`: the seller's listing agent.",
+        "enum": [
+          "buyer",
+          "listing"
+        ],
+        "type": "string"
+      },
+      "OriginatorAgentsBreakdownRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "advancedFilters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "filters": {
+            "$ref": "#/components/schemas/FilterNode"
+          },
+          "flatFilters": {
+            "additionalProperties": false,
+            "properties": {
+              "borrowerStatus": {
+                "$ref": "#/components/schemas/LoanBorrowerStatusFilterValue"
+              },
+              "broker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Broker shop NMLS id (digits only). A broker is a company — resolve a broker name to its NMLS id via instantSearch (or listCompanies)."
+                  }
+                ]
+              },
+              "buyerEntityType": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "city": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "conforming": {
+                "$ref": "#/components/schemas/BooleanFilterValue"
+              },
+              "county": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "County name (e.g. \"Broward\") or 5-digit FIPS code. Names resolve to FIPS server-side; include a `state` filter to disambiguate."
+                  }
+                ]
+              },
+              "currentBalance": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Estimated remaining principal balance (~19% populated). Approximate current equity as `homeValue` (AVM) minus this."
+                  }
+                ]
+              },
+              "employer": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Employer/company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "equity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Point-in-time equity recorded on the loan (sparse, ~10%). NOT a live current-equity figure. For HELOC/cash-out targeting on up-to-date equity, use properties search (listProperties) instead — its equity is far better populated and current."
+                  }
+                ]
+              },
+              "excludeBroker": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans brokered by this broker-shop NMLS id (digits only) — the inverse of `broker`."
+                  }
+                ]
+              },
+              "excludeCity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this city — the inverse of `city`."
+                  }
+                ]
+              },
+              "excludeLender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans from this lender ID (\"everyone but X\") — the inverse of `lender`, same id contract (resolve via instantSearch/listLenders). Loans with no lender stay in the results."
+                  }
+                ]
+              },
+              "excludeLoanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans funded by this company NMLS id (digits only) — the inverse of `loanCompany`."
+                  }
+                ]
+              },
+              "excludeOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans with this originator NMLS id (digits only) — the inverse of `originator`. Common for 'everyone but my own shop' lists."
+                  }
+                ]
+              },
+              "excludeState": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this state (2-letter code, e.g. \"CA\") — the inverse of `state`. For \"everywhere but this state\" lists."
+                  }
+                ]
+              },
+              "excludeZipCode": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exclude loans in this ZIP code — the inverse of `zipCode`."
+                  }
+                ]
+              },
+              "fips": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Exact 5-digit county FIPS code (no name resolution) — the code-only escape hatch alongside `county`."
+                  }
+                ]
+              },
+              "geoPoint": {
+                "$ref": "#/components/schemas/GeoFilterValue"
+              },
+              "homeValue": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "AVM (automated valuation) at the linked property (~26%, MLS-linked). Pair with `currentBalance` to approximate current equity."
+                  }
+                ]
+              },
+              "includeUnknownOriginator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/BooleanFilterValue"
+                  },
+                  {
+                    "description": "Include loans that have no originator NMLS id. Omitted/false (default): such loans are excluded — the vast majority are pre-2016 public records with no linkable originator. true: include them. Note that the default scopes results to loans with a known originator (~2016+ recordings)."
+                  }
+                ]
+              },
+              "interestRate": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "lender": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender ID — the normalized lender-dictionary key, NOT a fuzzy name match. Resolve a lender via instantSearch (or listLenders) and pass the `id` it returns (e.g. \"mortgage_rocket\" or \"mortgage rocket\"). Underscores and letter case are normalized, so either id surface works. A stored normalized lender name (what the `slice: \"lender\"` chart buckets emit) is also accepted, so a chart bucket key filters directly. A value that is neither returns 400 rather than silently matching nothing — to search by lender NAME, use `lenderName`."
+                  }
+                ]
+              },
+              "lenderName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Lender name as recorded on the loan document — fuzzy, all-terms match (e.g. \"Fifth Third\"). The name counterpart to the exact-id `lender` filter; use `lender` when you have a resolved id, and this when you only have a name."
+                  }
+                ]
+              },
+              "loanCompany": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Funding/loan company NMLS id (digits only). Resolve a company name to its NMLS id via instantSearch."
+                  }
+                ]
+              },
+              "loanType": {
+                "$ref": "#/components/schemas/LoanTypeFilterValue"
+              },
+              "ltvAtOrigination": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/NumericFilterValue"
+                  },
+                  {
+                    "description": "Loan-to-value at ORIGINATION (sparse), as a PERCENT on a 0-100 scale (`80` = 80% LTV; values above 100 are real underwater loans). This is not a current LTV — there is no stored current-LTV field on loans."
+                  }
+                ]
+              },
+              "mode": {
+                "enum": [
+                  "and",
+                  "or"
+                ],
+                "type": "string"
+              },
+              "mortgageAmount": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "mortgageDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "originator": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Loan originator NMLS id (digits only). To search by name use `originatorName`, or resolve a name to its id via instantSearch."
+                  }
+                ]
+              },
+              "originatorName": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "deprecated": true,
+                    "description": "DEPRECATED — fuzzy name matching is unreliable (same originator can return wildly different counts by name string). Resolve the loan officer via instantSearch and filter by `originator` (exact NMLS id) instead. Still functional for now."
+                  }
+                ]
+              },
+              "propertyId": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Parcel id — returns every loan recorded against one property. Pass the same string this endpoint returns as `mmPropertyId` on a loan row, or the `mmPropertyId` of a property record.\n\nThis is the parcel's FULL recorded loan history, which is deliberately wider than the loans embedded on a property record: that embed is a snapshot of what is still owed (up to five currently-active loans), so paid-off mortgages are absent from it and present here.\n\nMulti-unit caveat: loans carry a unit-blind parcel id, so for one unit of a multi-unit building this selects every unit in the building, not that unit alone."
+                  }
+                ]
+              },
+              "saleDate": {
+                "$ref": "#/components/schemas/DateFilterValue"
+              },
+              "salePrice": {
+                "$ref": "#/components/schemas/NumericFilterValue"
+              },
+              "state": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              },
+              "transactionType": {
+                "$ref": "#/components/schemas/LoanTransactionTypeFilterValue"
+              },
+              "zip": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Alias of `zipCode` — same ZIP filter, accepted for cross-entity key parity."
+                  }
+                ]
+              },
+              "zipCode": {
+                "$ref": "#/components/schemas/TextFilterValue"
+              }
+            },
+            "type": "object"
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination"
+          },
+          "period": {
+            "$ref": "#/components/schemas/DatedPeriod"
+          },
+          "side": {
+            "$ref": "#/components/schemas/OriginatorAgentSide"
+          },
+          "sort": {
+            "$ref": "#/components/schemas/BreakdownSort"
+          }
+        },
+        "type": "object"
+      },
       "OriginatorBranchLocation": {
         "description": "The NMLS branch the originator is currently registered at. Null when they have no branch location on file.",
         "nullable": true,
@@ -38897,17 +40341,6 @@
         ],
         "type": "object"
       },
-      "ScoredBreakdownRequest": {
-        "properties": {
-          "period": {
-            "$ref": "#/components/schemas/Period"
-          },
-          "sort": {
-            "$ref": "#/components/schemas/BreakdownSort"
-          }
-        },
-        "type": "object"
-      },
       "SearchTokenResponse": {
         "properties": {
           "expiresAt": {
@@ -40129,7 +41562,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.75.0"
+    "version": "3.77.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -40761,7 +42194,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"
@@ -41200,6 +42633,192 @@
         ]
       }
     },
+    "/v1/agents/{id}/analytics/loan-mix": {
+      "post": {
+        "description": "Scoped to the agent's FINANCED deals: recorded loans on which the agent is the buyer's agent or the listing / co-listing agent, matched through the agent's MLS ids. Cash deals carry no loan and are not counted. The date window is the loan's recording date. Returns, for each side at once (`any`, `buyer`, `listing` — duals on `buyer`): the financed deal count and loan volume, how many were brokered (third-party origination), and the loan-type mix. For the prior period, call again with that period.",
+        "operationId": "agentLoanMix",
+        "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/AgentLoanMixRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentLoanMixResponse"
+                }
+              }
+            },
+            "description": "Per-side financing profile"
+          },
+          "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": "Financing profile of the agent's deals, per side",
+        "tags": [
+          "Agents"
+        ]
+      }
+    },
+    "/v1/agents/{id}/breakdowns/builders": {
+      "post": {
+        "description": "New-construction builders named on the agent's deals in the period, ranked by units. 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": [
+          {
+            "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/AgentScoredBreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Pre-aggregated builders 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": "Home builders on the agent's deals (pre-aggregated)",
+        "tags": [
+          "Agents"
+        ]
+      }
+    },
     "/v1/agents/{id}/breakdowns/cities": {
       "post": {
         "operationId": "agentCities",
@@ -41311,7 +42930,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
+                "$ref": "#/components/schemas/AgentScoredBreakdownRequest"
               }
             }
           }
@@ -41495,7 +43114,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
+                "$ref": "#/components/schemas/AgentScoredBreakdownRequest"
               }
             }
           }
@@ -41679,7 +43298,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/ScoredBreakdownRequest"
+                "$ref": "#/components/schemas/AgentScoredBreakdownRequest"
               }
             }
           }
@@ -41844,6 +43463,192 @@
         ]
       }
     },
+    "/v1/agents/{id}/breakdowns/title-companies": {
+      "post": {
+        "description": "Scoped to the agent's FINANCED deals: recorded loans on which the agent is the buyer's agent or the listing / co-listing agent, matched through the agent's MLS ids. Cash deals carry no loan and are not counted. The date window is the loan's recording date. Ranks the title companies named on those loans. Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under. \"None available\"-style placeholders and names shorter than 3 characters are excluded. `pctUnits` / `pctVolume` are shares of ALL the side's financed deals in the window, including those with no title company, so they do not sum to 1. `side` defaults to `any`; title company is usually picked on the buyer side, so `buyer` is the view that reads as \"who this agent's buyers close with\".",
+        "operationId": "agentTitleCompanies",
+        "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/AgentLoansBreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the agent's financed deals 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 the agent's financed deals (spellings merged)",
+        "tags": [
+          "Agents"
+        ]
+      }
+    },
+    "/v1/agents/{id}/breakdowns/title-companies/time-series": {
+      "post": {
+        "description": "Scoped to the agent's FINANCED deals: recorded loans on which the agent is the buyer's agent or the listing / co-listing agent, matched through the agent's MLS ids. Cash deals carry no loan and are not counted. The date window is the loan's recording date. One bucket per `interval` (default monthly), each segmented by title company with spellings merged per bucket: `segments[].label` is the company's most-used spelling across the whole response and `segments[].id` the normalized name — match a company across buckets on `id`. `previous` is the same series for the prior window. `side` defaults to `any`.",
+        "operationId": "agentTitleCompaniesTimeSeries",
+        "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/AgentTitleCompanyTimeSeriesRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SimpleTimeSeriesResponse"
+                }
+              }
+            },
+            "description": "Title-company-segmented time series"
+          },
+          "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 the agent's financed deals, over time",
+        "tags": [
+          "Agents"
+        ]
+      }
+    },
     "/v1/agents/{id}/breakdowns/zip-codes": {
       "post": {
         "operationId": "agentZipCodes",
@@ -42233,6 +44038,7 @@
     },
     "/v1/agents/{id}/sales": {
       "post": {
+        "description": "The agent's deals, newest first: every sale on which the agent is the buyer's agent or the listing / co-listing agent. `side` narrows to one half (`buyer` includes deals where the agent was on both sides; `listing` excludes them). Each row says which `side` the agent was on and carries the sale's recorded purchase `loan` — lender, loan officer, loan type, amount, title company — or `null` for a cash deal or a loan not yet on file. Pass `flatFilters.mlsStatus: \"SLD\"` for closed deals only.",
         "operationId": "agentSales",
         "parameters": [
           {
@@ -45344,7 +47150,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"
@@ -46857,7 +48663,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"
@@ -62798,7 +64604,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"
@@ -66460,7 +68266,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"
@@ -67002,7 +68808,7 @@
     },
     "/v1/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.",
+        "description": "Ranks the real-estate agents on this LO's loans, by volume — the buyer's agent by default, the listing agent with `side: \"listing\"`. Buckets whose name is an MLS placeholder for \"no agent recorded\" (`non member`, `non listed agent`, and ~140 board-specific spellings) are excluded rather than ranked as agents — they are not people. `id` is the agent id most often recorded under the name on these loans (pass it to `GET /v1/agents/{id}`); absent when none is recorded. Percentages are shares of the LO's whole loan population, so they do not sum to 100 across the page.",
         "operationId": "originatorAgents",
         "parameters": [
           {
@@ -67020,7 +68826,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/BreakdownRequest"
+                "$ref": "#/components/schemas/OriginatorAgentsBreakdownRequest"
               }
             }
           }
@@ -67034,7 +68840,7 @@
                 }
               }
             },
-            "description": "Breakdown of the LO's loans by agents"
+            "description": "Breakdown of the LO's loans by real-estate agent"
           },
           "400": {
             "content": {
@@ -68561,7 +70367,7 @@
                         "$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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). 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.",
+                        "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; `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on; and the computed `governmentPct` (originators: FHA + VA percent of loans, 0–100), `branchCount` (companies: NMLS branch count) and `managerName` / `managerNmlsId` (branches: the first branch manager). Agents also offer `email2` / `phone2` (the best-ranked email / phone distinct from `email` / `phone`, admitted by the `email` / `phone` entitlement field), `officePhone` (admitted by `phone`), `activeListings` (current active listings; null when unknown), and the profile-link columns `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `zillow`, `otherLinks` (a `; `-joined list of profile URLs on no known platform) — all admitted by the `links` entitlement field. 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"