@model-match/api 3.16.0 → 3.17.0

package/openapi.json

@@ -3189,6 +3189,16 @@
           "period": {
             "$ref": "#/components/schemas/Period"
           },
+          "segment": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/BranchSlice"
+              },
+              {
+                "description": "Optional second dimension. Each bucket of `slice` then carries `segments`: the same `measure` broken down by this dimension (e.g. `slice: \"loanType\", segment: \"lender\"` is loan type × lender in one call), top 25 per bucket ranked by `measure`, with the remainder counted in `segmentsOmittedCount`. Omit it and the response is the one-dimensional chart, unchanged. Must differ from `slice`, and cannot be combined with `size` / `after` paging (400)."
+              }
+            ]
+          },
           "slice": {
             "$ref": "#/components/schemas/BranchSlice"
           }
@@ -4144,7 +4154,24 @@
         ],
         "type": "string"
       },
+      "BranchSegment": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`. Time-series only: `titleCompany` groups on the title company named on the deed, with spellings of one company merged per bucket (`label` = most-used spelling across the response, `id` = normalized name — match on `id`) and \"none available\"-style placeholders excluded.",
+        "enum": [
+          "transactionType",
+          "loanType",
+          "city",
+          "county",
+          "state",
+          "zip",
+          "lender",
+          "propertyType",
+          "conforming",
+          "titleCompany"
+        ],
+        "type": "string"
+      },
       "BranchSlice": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`.",
         "enum": [
           "transactionType",
           "loanType",
@@ -4152,7 +4179,9 @@
           "county",
           "state",
           "zip",
-          "lender"
+          "lender",
+          "propertyType",
+          "conforming"
         ],
         "type": "string"
       },
@@ -4918,7 +4947,7 @@
             "$ref": "#/components/schemas/Period"
           },
           "segment": {
-            "$ref": "#/components/schemas/BranchSlice"
+            "$ref": "#/components/schemas/BranchSegment"
           }
         },
         "required": [
@@ -5589,18 +5618,23 @@
             "type": "number"
           },
           "id": {
-            "description": "Machine value behind `label` when the bucket key is an id rather than a name (today: the `lender` slice/segment, where `label` is the dictionary display name). Pass `id` — not `label` — back as a `lender` filter value. Absent on slices whose `label` is already the machine value.",
+            "description": "Machine value behind `label` when the bucket key is not itself the label. `lender`: `label` is the dictionary display name and `id` the normalized lender key — pass `id`, not `label`, back as a `lender` filter value. `conforming`: `label` is `conforming` / `nonConforming` and `id` the raw `true` / `false` flag. `titleCompany` (time-series segment): `label` is the most-used spelling and `id` the normalized name every spelling was merged under — match segments across buckets on `id`. Absent on slices whose `label` is already the machine value.",
             "type": "string"
           },
           "label": {
             "type": "string"
           },
           "segments": {
+            "description": "Present only when the request named a `segment`: this bucket broken down by that second dimension, ranked by the same `measure` and capped at 25 per bucket (the rest is counted in `segmentsOmittedCount`). Documents with no value for the segment are not grouped and appear nowhere here, so segment `count`s sum to at most the bucket's `count`.",
             "items": {
               "$ref": "#/components/schemas/ChartSegment"
             },
             "type": "array"
           },
+          "segmentsOmittedCount": {
+            "description": "Present only with `segments`: documents in this bucket whose segment value fell past the 25-per-bucket cap. A document COUNT, never a dollar figure. `0` means `segments` is the complete breakdown of every document that carries a segment value.",
+            "type": "number"
+          },
           "unattributed": {
             "description": "Present and `true` on at most one bucket, which is NOT a real category: it collects the documents this breakdown could not attribute to any value of the slice, and its `label` (`\"(unknown)\"`) is prose, not an identifier. Filter on THIS field, never on the label — a consumer plotting a map or joining the label to a real code must drop this row. It is always the LAST element of `data`, appended after ranking rather than placed by value, so it is the one bucket that does not obey the ordering `measure` describes. It exists so the bars account for the same population the summary reports: a document whose slice field holds no indexed term is absent from a terms breakdown entirely rather than forming a small bucket, so without it a chart silently omits part of its own corpus. That reconciliation is exact for `units`; on an average it is not, because buckets under the five-document floor are dropped and a slice with more than 200 distinct values still truncates — neither loss is collected in this row (the truncated tail is reported response-wide as `omittedCount`; the floor is reported nowhere). Absent when there is nothing unattributed, never `false` and never a zero-valued row.",
             "enum": [
@@ -5653,6 +5687,7 @@
             "type": "number"
           },
           "segment": {
+            "description": "The second dimension echoed from the request, or `null` for a one-dimensional chart (then no bucket carries `segments`).",
             "nullable": true,
             "type": "string"
           },
@@ -5678,16 +5713,26 @@
       },
       "ChartSegment": {
         "properties": {
+          "count": {
+            "description": "Documents in this segment of the parent bucket — the denominator behind `value`, whatever the measure.",
+            "type": "number"
+          },
+          "id": {
+            "description": "Machine value behind `label` when the bucket key is not itself the label. `lender`: `label` is the dictionary display name and `id` the normalized lender key — pass `id`, not `label`, back as a `lender` filter value. `conforming`: `label` is `conforming` / `nonConforming` and `id` the raw `true` / `false` flag. `titleCompany` (time-series segment): `label` is the most-used spelling and `id` the normalized name every spelling was merged under — match segments across buckets on `id`. Absent on slices whose `label` is already the machine value.",
+            "type": "string"
+          },
           "label": {
             "type": "string"
           },
           "value": {
+            "description": "The requested `measure` over the documents in BOTH this segment and its parent bucket.",
             "type": "number"
           }
         },
         "required": [
           "label",
-          "value"
+          "value",
+          "count"
         ],
         "type": "object"
       },
@@ -6514,6 +6559,16 @@
           "period": {
             "$ref": "#/components/schemas/Period"
           },
+          "segment": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/CompanySlice"
+              },
+              {
+                "description": "Optional second dimension. Each bucket of `slice` then carries `segments`: the same `measure` broken down by this dimension (e.g. `slice: \"loanType\", segment: \"lender\"` is loan type × lender in one call), top 25 per bucket ranked by `measure`, with the remainder counted in `segmentsOmittedCount`. Omit it and the response is the one-dimensional chart, unchanged. Must differ from `slice`, and cannot be combined with `size` / `after` paging (400)."
+              }
+            ]
+          },
           "slice": {
             "$ref": "#/components/schemas/CompanySlice"
           }
@@ -8828,7 +8883,24 @@
         },
         "type": "object"
       },
+      "CompanySegment": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`. Time-series only: `titleCompany` groups on the title company named on the deed, with spellings of one company merged per bucket (`label` = most-used spelling across the response, `id` = normalized name — match on `id`) and \"none available\"-style placeholders excluded.",
+        "enum": [
+          "transactionType",
+          "loanType",
+          "city",
+          "county",
+          "state",
+          "zip",
+          "lender",
+          "propertyType",
+          "conforming",
+          "titleCompany"
+        ],
+        "type": "string"
+      },
       "CompanySlice": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`.",
         "enum": [
           "transactionType",
           "loanType",
@@ -8836,7 +8908,9 @@
           "county",
           "state",
           "zip",
-          "lender"
+          "lender",
+          "propertyType",
+          "conforming"
         ],
         "type": "string"
       },
@@ -10308,7 +10382,7 @@
             "$ref": "#/components/schemas/Period"
           },
           "segment": {
-            "$ref": "#/components/schemas/CompanySlice"
+            "$ref": "#/components/schemas/CompanySegment"
           }
         },
         "type": "object"
@@ -10572,6 +10646,10 @@
             },
             "type": "array"
           },
+          "occurredAt": {
+            "nullable": true,
+            "type": "number"
+          },
           "parentId": {
             "nullable": true,
             "type": "string"
@@ -10601,7 +10679,8 @@
           "actorEmail",
           "actorImage",
           "createdAt",
-          "editedAt"
+          "editedAt",
+          "occurredAt"
         ],
         "type": "object"
       },
@@ -11738,6 +11817,25 @@
         ],
         "type": "object"
       },
+      "CrmEditLoggedActivityResult": {
+        "properties": {
+          "data": {
+            "properties": {
+              "updated": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "updated"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "CrmEditNoteResult": {
         "properties": {
           "data": {
@@ -13032,6 +13130,34 @@
         ],
         "type": "object"
       },
+      "CrmLogActivityResult": {
+        "properties": {
+          "data": {
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "CrmLoggedActivityType": {
+        "enum": [
+          "call",
+          "meeting",
+          "email",
+          "task"
+        ],
+        "type": "string"
+      },
       "CrmMailProvider": {
         "enum": [
           "google",
@@ -18965,6 +19091,16 @@
           "period": {
             "$ref": "#/components/schemas/DatedPeriod"
           },
+          "segment": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/LoanSlice"
+              },
+              {
+                "description": "Optional second dimension. Each bucket of `slice` then carries `segments`: the same `measure` broken down by this dimension (e.g. `slice: \"loanType\", segment: \"lender\"` is loan type × lender in one call), top 25 per bucket ranked by `measure`, with the remainder counted in `segmentsOmittedCount`. Omit it and the response is the one-dimensional chart, unchanged. Must differ from `slice`, and cannot be combined with `size` / `after` paging (400)."
+              }
+            ]
+          },
           "size": {
             "description": "PARTY slices only (`originator`, `broker`, `loanCompany`; 400 on any other slice). Page size for the ranking, 1–1000. Passing `size` (or `after`) turns on paging: the response gains `total` / `totalApproximate` and, when more buckets remain, `nextCursor`, and drops `omittedCount`. Buckets stay ranked by `measure` descending (ties broken by key), and bucket labels stay NMLS ids. Default when only `after` is sent: 200, the fixed chart's bucket count. Paging reaches the top 10,000 ranked buckets.",
             "maximum": 1000,
@@ -19448,7 +19584,27 @@
         ],
         "type": "object"
       },
+      "LoanSegment": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`. Time-series only: `titleCompany` groups on the title company named on the deed, with spellings of one company merged per bucket (`label` = most-used spelling across the response, `id` = normalized name — match on `id`) and \"none available\"-style placeholders excluded.",
+        "enum": [
+          "transactionType",
+          "loanType",
+          "city",
+          "county",
+          "state",
+          "zip",
+          "lender",
+          "propertyType",
+          "conforming",
+          "broker",
+          "loanCompany",
+          "originator",
+          "titleCompany"
+        ],
+        "type": "string"
+      },
       "LoanSlice": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`.",
         "enum": [
           "transactionType",
           "loanType",
@@ -19457,6 +19613,8 @@
           "state",
           "zip",
           "lender",
+          "propertyType",
+          "conforming",
           "broker",
           "loanCompany",
           "originator"
@@ -20220,7 +20378,7 @@
             "$ref": "#/components/schemas/DatedPeriod"
           },
           "segment": {
-            "$ref": "#/components/schemas/LoanSlice"
+            "$ref": "#/components/schemas/LoanSegment"
           }
         },
         "type": "object"
@@ -23816,6 +23974,16 @@
           "period": {
             "$ref": "#/components/schemas/Period"
           },
+          "segment": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/OriginatorSlice"
+              },
+              {
+                "description": "Optional second dimension. Each bucket of `slice` then carries `segments`: the same `measure` broken down by this dimension (e.g. `slice: \"loanType\", segment: \"lender\"` is loan type × lender in one call), top 25 per bucket ranked by `measure`, with the remainder counted in `segmentsOmittedCount`. Omit it and the response is the one-dimensional chart, unchanged. Must differ from `slice`, and cannot be combined with `size` / `after` paging (400)."
+              }
+            ]
+          },
           "slice": {
             "$ref": "#/components/schemas/OriginatorSlice"
           }
@@ -24232,6 +24400,16 @@
                         "nullable": true,
                         "type": "number"
                       },
+                      "careerYears": {
+                        "description": "Years since the earliest employer start on `records`, to 0.1 — the career length the recruiting signal is judged on. Null when no record carries a start date.",
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "currentTenureYears": {
+                        "description": "Years at the current employer (the first employer with an active record), from its earliest record start to today, to 0.1. Null when no employer is active or its start date is unknown. A 365-day year, matching the profile's recruiting signal.",
+                        "nullable": true,
+                        "type": "number"
+                      },
                       "employerChanges": {
                         "nullable": true,
                         "type": "number"
@@ -24242,6 +24420,37 @@
                         },
                         "type": "array"
                       },
+                      "recruitingSignal": {
+                        "description": "One-line read of this career for recruiting, rule-based over `records` (employers grouped by company NMLS id): no records → `none`; over half the employers missing a start date → `incompleteData`; under 2 career years with one employer → `limitedHistory`; one employer for 2+ years → `singleEmployerCareer`; 5+ years at the current employer with ≤3 employers → `longTermStability`; 3+ employers at ≥0.6 per career year → `highMobility`; under 1 year at the current employer with >1 employer → `recentMove`; 3-4 employers over 5+ years → `multiSponsorships`; otherwise `establishedAtCurrent`. First matching rule wins. `label`/`subtext` are display copy.",
+                        "properties": {
+                          "code": {
+                            "enum": [
+                              "singleEmployerCareer",
+                              "longTermStability",
+                              "establishedAtCurrent",
+                              "recentMove",
+                              "highMobility",
+                              "multiSponsorships",
+                              "limitedHistory",
+                              "incompleteData",
+                              "none"
+                            ],
+                            "type": "string"
+                          },
+                          "label": {
+                            "type": "string"
+                          },
+                          "subtext": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "code",
+                          "label",
+                          "subtext"
+                        ],
+                        "type": "object"
+                      },
                       "totalEmployers": {
                         "type": "number"
                       },
@@ -24284,6 +24493,9 @@
                 "nullable": true,
                 "type": "array"
               },
+              "profileInsights": {
+                "$ref": "#/components/schemas/OriginatorProfileInsights"
+              },
               "registration": {
                 "$ref": "#/components/schemas/OriginatorRegistration"
               },
@@ -26077,6 +26289,41 @@
         ],
         "type": "object"
       },
+      "OriginatorProfileInsights": {
+        "description": "Profile read-outs computed server-side from the LO's production in the requested `period` (default `last12Months`) — the same `volume` / `units` this response reports. Labels and descriptions are display copy; branch on the enum fields.",
+        "properties": {
+          "producerTier": {
+            "description": "From the period's units and volume, first match wins: `topProducer` ≥ 60 units OR ≥ $25M; `strongProducer` ≥ 36 units OR ≥ $12M; `midTier` ≥ 18 units OR ≥ $5M; else `lowVolume`.",
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "tier": {
+                "enum": [
+                  "topProducer",
+                  "strongProducer",
+                  "midTier",
+                  "lowVolume"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "tier",
+              "label",
+              "description"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "producerTier"
+        ],
+        "type": "object"
+      },
       "OriginatorRegistration": {
         "nullable": true,
         "properties": {
@@ -26149,7 +26396,24 @@
         },
         "type": "object"
       },
+      "OriginatorSegment": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`. Time-series only: `titleCompany` groups on the title company named on the deed, with spellings of one company merged per bucket (`label` = most-used spelling across the response, `id` = normalized name — match on `id`) and \"none available\"-style placeholders excluded.",
+        "enum": [
+          "transactionType",
+          "loanType",
+          "city",
+          "county",
+          "state",
+          "zip",
+          "lender",
+          "propertyType",
+          "conforming",
+          "titleCompany"
+        ],
+        "type": "string"
+      },
       "OriginatorSlice": {
+        "description": "Dimension to group by. Most are the loan's own field (`loanType`, `transactionType`, `state`, …). `lender` groups on the normalized lender (label = display name, `id` = filter key). `propertyType` is the recorder's land-use code of the collateral (`SFR` single-family, `PUD` planned unit development, `CND` condo, `RES` residential-other, `MFD` multi-family dwelling, `2ND` second home, `MFG` manufactured, `TWN` townhouse, `LAN` land, `COM` commercial, …); loans with no code are not grouped (≈20% of recent loans). `conforming` splits on the conforming-loan-limit flag: `conforming` vs `nonConforming` (above the county conforming limit — i.e. jumbo, not Non-QM), raw `true`/`false` on `id`.",
         "enum": [
           "transactionType",
           "loanType",
@@ -26157,7 +26421,9 @@
           "county",
           "state",
           "zip",
-          "lender"
+          "lender",
+          "propertyType",
+          "conforming"
         ],
         "type": "string"
       },
@@ -27080,7 +27346,7 @@
             "$ref": "#/components/schemas/Period"
           },
           "segment": {
-            "$ref": "#/components/schemas/OriginatorSlice"
+            "$ref": "#/components/schemas/OriginatorSegment"
           }
         },
         "type": "object"
@@ -31445,7 +31711,7 @@
       "SimpleTimeSeriesSegment": {
         "properties": {
           "id": {
-            "description": "Machine value behind `label` when the bucket key is an id rather than a name (today: the `lender` slice/segment, where `label` is the dictionary display name). Pass `id` — not `label` — back as a `lender` filter value. Absent on slices whose `label` is already the machine value.",
+            "description": "Machine value behind `label` when the bucket key is not itself the label. `lender`: `label` is the dictionary display name and `id` the normalized lender key — pass `id`, not `label`, back as a `lender` filter value. `conforming`: `label` is `conforming` / `nonConforming` and `id` the raw `true` / `false` flag. `titleCompany` (time-series segment): `label` is the most-used spelling and `id` the normalized name every spelling was merged under — match segments across buckets on `id`. Absent on slices whose `label` is already the machine value.",
             "type": "string"
           },
           "label": {
@@ -32310,7 +32576,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 1,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 1,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.",
     "title": "ModelMatch API",
-    "version": "3.62.0"
+    "version": "3.63.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -35628,6 +35894,99 @@
         ]
       }
     },
+    "/originators/{nmlsId}/breakdowns/title-companies": {
+      "post": {
+        "description": "Ranks the title companies on this entity's loans (recorded deeds, `recording_date` window — the same population and period axis as every other loans breakdown). Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under (legal-form and filler words such as `inc`, `llc`, `co`, `company`, `title`, `escrow` removed; `natl` → `national`). Placeholder entries meaning \"no title company recorded\" (`none available` and its misspellings, `unknown`, `n/a`, …) and names shorter than 3 characters are excluded rather than ranked. `attorney` and `accommodation` are kept: they say who closed. `pctUnits` / `pctVolume` are shares of the entity's WHOLE loan population in the window, including loans with no title company, so they do not sum to 100 across the page. Pages of up to 100 via `pagination`.",
+        "operationId": "originatorTitleCompanies",
+        "parameters": [
+          {
+            "description": "Originator NMLS ID",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Originator NMLS ID",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the entity's loans by title company"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          }
+        },
+        "summary": "Title companies on this LO's loans (spellings merged)",
+        "tags": [
+          "Originators"
+        ]
+      }
+    },
     "/originators/{nmlsId}/breakdowns/zip-codes": {
       "post": {
         "operationId": "originatorZipCodes",
@@ -40761,6 +41120,99 @@
         ]
       }
     },
+    "/v1/branches/{nmlsId}/breakdowns/title-companies": {
+      "post": {
+        "description": "Ranks the title companies on this entity's loans (recorded deeds, `recording_date` window — the same population and period axis as every other loans breakdown). Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under (legal-form and filler words such as `inc`, `llc`, `co`, `company`, `title`, `escrow` removed; `natl` → `national`). Placeholder entries meaning \"no title company recorded\" (`none available` and its misspellings, `unknown`, `n/a`, …) and names shorter than 3 characters are excluded rather than ranked. `attorney` and `accommodation` are kept: they say who closed. `pctUnits` / `pctVolume` are shares of the entity's WHOLE loan population in the window, including loans with no title company, so they do not sum to 100 across the page. Pages of up to 100 via `pagination`.",
+        "operationId": "branchTitleCompanies",
+        "parameters": [
+          {
+            "description": "Branch NMLS ID",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Branch NMLS ID",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the entity's loans by title company"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          }
+        },
+        "summary": "Title companies on this branch's loans (spellings merged)",
+        "tags": [
+          "Branches"
+        ]
+      }
+    },
     "/v1/branches/{nmlsId}/loans": {
       "post": {
         "description": "Returns the individual loans attributed to this branch office — the branch's own book, not its parent company's. Accepts the same filters, sorts and pagination as the main loan search. Attribution comes from public record, so this is the branch's recorded footprint and can be smaller than the production totals on `GET /v1/branches/{nmlsId}`.",
@@ -42694,6 +43146,99 @@
         ]
       }
     },
+    "/v1/companies/{nmlsId}/breakdowns/title-companies": {
+      "post": {
+        "description": "Ranks the title companies on this entity's loans (recorded deeds, `recording_date` window — the same population and period axis as every other loans breakdown). Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under (legal-form and filler words such as `inc`, `llc`, `co`, `company`, `title`, `escrow` removed; `natl` → `national`). Placeholder entries meaning \"no title company recorded\" (`none available` and its misspellings, `unknown`, `n/a`, …) and names shorter than 3 characters are excluded rather than ranked. `attorney` and `accommodation` are kept: they say who closed. `pctUnits` / `pctVolume` are shares of the entity's WHOLE loan population in the window, including loans with no title company, so they do not sum to 100 across the page. Pages of up to 100 via `pagination`.",
+        "operationId": "companyTitleCompanies",
+        "parameters": [
+          {
+            "description": "Company NMLS ID",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Company NMLS ID",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the entity's loans by title company"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          }
+        },
+        "summary": "Title companies on this company's loans (spellings merged)",
+        "tags": [
+          "Companies"
+        ]
+      }
+    },
     "/v1/companies/{nmlsId}/breakdowns/zip-codes": {
       "post": {
         "operationId": "companyZipCodes",
@@ -43804,27 +44349,222 @@
             "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
           }
         },
-        "summary": "Where a company's hires came from and where its exits went",
+        "summary": "Where a company's hires came from and where its exits went",
+        "tags": [
+          "Companies"
+        ]
+      }
+    },
+    "/v1/crm/activity": {
+      "delete": {
+        "operationId": "deleteCrmNote",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "id": {
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmDeleteNoteResult"
+                }
+              }
+            },
+            "description": "Whether the note was soft-deleted."
+          },
+          "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": "Soft-delete a note",
+        "tags": [
+          "CRM"
+        ]
+      },
+      "get": {
+        "operationId": "listCrmActivity",
+        "parameters": [
+          {
+            "description": "The CRM record id whose timeline to read.",
+            "in": "query",
+            "name": "entityId",
+            "required": true,
+            "schema": {
+              "description": "The CRM record id whose timeline to read.",
+              "minLength": 1,
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmActivityList"
+                }
+              }
+            },
+            "description": "The record's timeline entries, newest first."
+          },
+          "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": "List a record's activity timeline (newest first)",
         "tags": [
-          "Companies"
+          "CRM"
         ]
-      }
-    },
-    "/v1/crm/activity": {
-      "delete": {
-        "operationId": "deleteCrmNote",
+      },
+      "patch": {
+        "operationId": "editCrmNote",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
                 "properties": {
+                  "body": {
+                    "type": "string"
+                  },
+                  "bodyHtml": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "grantRecordAccessUserIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
                   "id": {
                     "minLength": 1,
                     "type": "string"
+                  },
+                  "listId": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "recordName": {
+                    "type": "string"
+                  },
+                  "recordUrl": {
+                    "deprecated": true,
+                    "description": "Ignored — the record link is server-built.",
+                    "type": "string"
                   }
                 },
                 "required": [
-                  "id"
+                  "id",
+                  "body"
                 ],
                 "type": "object"
               }
@@ -43836,11 +44576,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CrmDeleteNoteResult"
+                  "$ref": "#/components/schemas/CrmEditNoteResult"
                 }
               }
             },
-            "description": "Whether the note was soft-deleted."
+            "description": "Whether the note was updated, plus its record + prior body."
           },
           "400": {
             "content": {
@@ -43893,36 +44633,75 @@
             "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
           }
         },
-        "summary": "Soft-delete a note",
+        "summary": "Edit a note's body",
         "tags": [
           "CRM"
         ]
       },
-      "get": {
-        "operationId": "listCrmActivity",
-        "parameters": [
-          {
-            "description": "The CRM record id whose timeline to read.",
-            "in": "query",
-            "name": "entityId",
-            "required": true,
-            "schema": {
-              "description": "The CRM record id whose timeline to read.",
-              "minLength": 1,
-              "type": "string"
+      "post": {
+        "operationId": "addCrmNote",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "body": {
+                    "type": "string"
+                  },
+                  "bodyHtml": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "callId": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "entityId": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "grantRecordAccessUserIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "listId": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "parentId": {
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "recordName": {
+                    "type": "string"
+                  },
+                  "recordUrl": {
+                    "deprecated": true,
+                    "description": "Ignored — the record link is server-built.",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "entityId",
+                  "body"
+                ],
+                "type": "object"
+              }
             }
           }
-        ],
+        },
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CrmActivityList"
+                  "$ref": "#/components/schemas/CrmAddNoteResult"
                 }
               }
             },
-            "description": "The record's timeline entries, newest first."
+            "description": "The new note's id + its resolved thread root (null if top-level)."
           },
           "400": {
             "content": {
@@ -43975,18 +44754,23 @@
             "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
           }
         },
-        "summary": "List a record's activity timeline (newest first)",
+        "summary": "Append a note to a record's timeline",
         "tags": [
           "CRM"
         ]
-      },
+      }
+    },
+    "/v1/crm/activity/log": {
       "patch": {
-        "operationId": "editCrmNote",
+        "operationId": "editCrmLoggedActivity",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
                 "properties": {
+                  "activityType": {
+                    "$ref": "#/components/schemas/CrmLoggedActivityType"
+                  },
                   "body": {
                     "type": "string"
                   },
@@ -43994,6 +44778,23 @@
                     "nullable": true,
                     "type": "string"
                   },
+                  "direction": {
+                    "description": "call + email only.",
+                    "enum": [
+                      "inbound",
+                      "outbound",
+                      null
+                    ],
+                    "nullable": true,
+                    "type": "string"
+                  },
+                  "durationMinutes": {
+                    "description": "call + meeting only, in minutes.",
+                    "maximum": 1440,
+                    "minimum": 0,
+                    "nullable": true,
+                    "type": "integer"
+                  },
                   "grantRecordAccessUserIds": {
                     "items": {
                       "type": "string"
@@ -44008,17 +44809,31 @@
                     "nullable": true,
                     "type": "string"
                   },
+                  "occurredAt": {
+                    "description": "Epoch ms the activity actually happened. Must be ≤ now + 5 minutes.",
+                    "exclusiveMinimum": true,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "outcome": {
+                    "description": "call: connected | voicemail | no_answer | busy. meeting: held | no_show. Not allowed for email/task.",
+                    "nullable": true,
+                    "type": "string"
+                  },
                   "recordName": {
                     "type": "string"
                   },
-                  "recordUrl": {
-                    "deprecated": true,
-                    "description": "Ignored — the record link is server-built.",
+                  "title": {
+                    "description": "Meeting title / email subject / task title. Not allowed for a call; required for a task.",
+                    "maxLength": 200,
+                    "nullable": true,
                     "type": "string"
                   }
                 },
                 "required": [
                   "id",
+                  "activityType",
+                  "occurredAt",
                   "body"
                 ],
                 "type": "object"
@@ -44031,11 +44846,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CrmEditNoteResult"
+                  "$ref": "#/components/schemas/CrmEditLoggedActivityResult"
                 }
               }
             },
-            "description": "Whether the note was updated, plus its record + prior body."
+            "description": "Whether the logged entry was updated."
           },
           "400": {
             "content": {
@@ -44075,7 +44890,7 @@
                 }
               }
             },
-            "description": "Not found"
+            "description": "No live logged entry with that id — either it doesn't exist, was deleted, or isn't a logged entry (this route can't edit a plain note)."
           },
           "413": {
             "content": {
@@ -44088,18 +44903,21 @@
             "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
           }
         },
-        "summary": "Edit a note's body",
+        "summary": "Edit a logged activity entry",
         "tags": [
           "CRM"
         ]
       },
       "post": {
-        "operationId": "addCrmNote",
+        "operationId": "logCrmActivity",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
                 "properties": {
+                  "activityType": {
+                    "$ref": "#/components/schemas/CrmLoggedActivityType"
+                  },
                   "body": {
                     "type": "string"
                   },
@@ -44107,10 +44925,23 @@
                     "nullable": true,
                     "type": "string"
                   },
-                  "callId": {
+                  "direction": {
+                    "description": "call + email only.",
+                    "enum": [
+                      "inbound",
+                      "outbound",
+                      null
+                    ],
                     "nullable": true,
                     "type": "string"
                   },
+                  "durationMinutes": {
+                    "description": "call + meeting only, in minutes.",
+                    "maximum": 1440,
+                    "minimum": 0,
+                    "nullable": true,
+                    "type": "integer"
+                  },
                   "entityId": {
                     "minLength": 1,
                     "type": "string"
@@ -44125,21 +44956,31 @@
                     "nullable": true,
                     "type": "string"
                   },
-                  "parentId": {
+                  "occurredAt": {
+                    "description": "Epoch ms the activity actually happened. Must be ≤ now + 5 minutes.",
+                    "exclusiveMinimum": true,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "outcome": {
+                    "description": "call: connected | voicemail | no_answer | busy. meeting: held | no_show. Not allowed for email/task.",
                     "nullable": true,
                     "type": "string"
                   },
                   "recordName": {
                     "type": "string"
                   },
-                  "recordUrl": {
-                    "deprecated": true,
-                    "description": "Ignored — the record link is server-built.",
+                  "title": {
+                    "description": "Meeting title / email subject / task title. Not allowed for a call; required for a task.",
+                    "maxLength": 200,
+                    "nullable": true,
                     "type": "string"
                   }
                 },
                 "required": [
                   "entityId",
+                  "activityType",
+                  "occurredAt",
                   "body"
                 ],
                 "type": "object"
@@ -44152,11 +44993,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CrmAddNoteResult"
+                  "$ref": "#/components/schemas/CrmLogActivityResult"
                 }
               }
             },
-            "description": "The new note's id + its resolved thread root (null if top-level)."
+            "description": "The new logged entry's id."
           },
           "400": {
             "content": {
@@ -44209,7 +45050,7 @@
             "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
           }
         },
-        "summary": "Append a note to a record's timeline",
+        "summary": "Log a Call/Meeting/Email/Task that happened outside Model Match",
         "tags": [
           "CRM"
         ]
@@ -61721,6 +62562,99 @@
         ]
       }
     },
+    "/v1/originators/{nmlsId}/breakdowns/title-companies": {
+      "post": {
+        "description": "Ranks the title companies on this entity's loans (recorded deeds, `recording_date` window — the same population and period axis as every other loans breakdown). Spellings of one company are MERGED: `label` is its most-used spelling, `id` the normalized name every spelling was grouped under (legal-form and filler words such as `inc`, `llc`, `co`, `company`, `title`, `escrow` removed; `natl` → `national`). Placeholder entries meaning \"no title company recorded\" (`none available` and its misspellings, `unknown`, `n/a`, …) and names shorter than 3 characters are excluded rather than ranked. `attorney` and `accommodation` are kept: they say who closed. `pctUnits` / `pctVolume` are shares of the entity's WHOLE loan population in the window, including loans with no title company, so they do not sum to 100 across the page. Pages of up to 100 via `pagination`.",
+        "operationId": "originatorTitleCompanies",
+        "parameters": [
+          {
+            "description": "Originator NMLS ID",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Originator NMLS ID",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BreakdownRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakdownResponse"
+                }
+              }
+            },
+            "description": "Breakdown of the entity's loans by title company"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          }
+        },
+        "summary": "Title companies on this LO's loans (spellings merged)",
+        "tags": [
+          "Originators"
+        ]
+      }
+    },
     "/v1/originators/{nmlsId}/breakdowns/zip-codes": {
       "post": {
         "operationId": "originatorZipCodes",