@model-match/api 3.13.0 → 3.15.0

package/openapi.json

@@ -582,6 +582,357 @@
         ],
         "type": "object"
       },
+      "AdminCadLinks": {
+        "properties": {
+          "current": {
+            "nullable": true,
+            "properties": {
+              "companyName": {
+                "nullable": true,
+                "type": "string"
+              },
+              "companyNmlsId": {
+                "nullable": true,
+                "type": "string"
+              },
+              "startDate": {
+                "nullable": true,
+                "type": "string"
+              }
+            },
+            "required": [
+              "companyNmlsId",
+              "companyName",
+              "startDate"
+            ],
+            "type": "object"
+          },
+          "explanation": {
+            "properties": {
+              "activeLogic": {
+                "type": "string"
+              },
+              "registrationLink": {
+                "type": "string"
+              },
+              "sponsorshipLink": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "sponsorshipLink",
+              "registrationLink",
+              "activeLogic"
+            ],
+            "type": "object"
+          },
+          "indexGaps": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "isWorking": {
+            "nullable": true,
+            "type": "boolean"
+          },
+          "name": {
+            "nullable": true,
+            "type": "string"
+          },
+          "nmlsId": {
+            "type": "string"
+          },
+          "registrations": {
+            "properties": {
+              "active": {
+                "type": "number"
+              },
+              "inactive": {
+                "type": "number"
+              },
+              "rows": {
+                "items": {
+                  "properties": {
+                    "companyName": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "companyNmlsId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "endDate": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "isActive": {
+                      "type": "boolean"
+                    },
+                    "licenseType": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "locationNmlsId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "regulator": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "source": {
+                      "enum": [
+                        "sponsorship",
+                        "registration",
+                        null
+                      ],
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "startDate": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "source",
+                    "companyNmlsId",
+                    "companyName",
+                    "startDate",
+                    "endDate",
+                    "isActive",
+                    "regulator",
+                    "licenseType",
+                    "locationNmlsId"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "total": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "total",
+              "active",
+              "inactive",
+              "rows"
+            ],
+            "type": "object"
+          },
+          "sponsorships": {
+            "properties": {
+              "active": {
+                "type": "number"
+              },
+              "inactive": {
+                "type": "number"
+              },
+              "rows": {
+                "items": {
+                  "properties": {
+                    "companyName": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "companyNmlsId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "endDate": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "isActive": {
+                      "type": "boolean"
+                    },
+                    "licenseType": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "locationNmlsId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "regulator": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "source": {
+                      "enum": [
+                        "sponsorship",
+                        "registration",
+                        null
+                      ],
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "startDate": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "source",
+                    "companyNmlsId",
+                    "companyName",
+                    "startDate",
+                    "endDate",
+                    "isActive",
+                    "regulator",
+                    "licenseType",
+                    "locationNmlsId"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "total": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "total",
+              "active",
+              "inactive",
+              "rows"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "nmlsId",
+          "name",
+          "isWorking",
+          "current",
+          "sponsorships",
+          "registrations",
+          "explanation",
+          "indexGaps"
+        ],
+        "type": "object"
+      },
+      "AdminCadLoadLaunch": {
+        "properties": {
+          "payload": {
+            "additionalProperties": {
+              "nullable": true
+            },
+            "type": "object"
+          },
+          "taskArn": {
+            "type": "string"
+          },
+          "taskId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "taskId",
+          "taskArn",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "AdminCadLoadRequest": {
+        "properties": {
+          "bucket": {
+            "description": "Source bucket (default `nmls-raw-data`).",
+            "minLength": 1,
+            "type": "string"
+          },
+          "loadType": {
+            "description": "`sample` loads only the first file. Default `full`.",
+            "enum": [
+              "full",
+              "sample"
+            ],
+            "type": "string"
+          },
+          "prefix": {
+            "description": "S3 prefix of one month's NMLS file set. Required unless resuming.",
+            "example": "consumer-access/2026/ConsumerAccess_nmlsb2bfiles_Sep2026/",
+            "minLength": 1,
+            "type": "string"
+          },
+          "reindex": {
+            "description": "Launch a full `index-cad` run when the load completes.",
+            "type": "boolean"
+          },
+          "restartFromFile": {
+            "description": "With `resumeLoadId`: reset this file (e.g. `Branch.csv`) and every later one first.",
+            "minLength": 1,
+            "type": "string"
+          },
+          "resumeLoadId": {
+            "description": "Resume an existing load by its id (resets stuck/failed files).",
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "AdminCadLoadTaskStatus": {
+        "properties": {
+          "createdAt": {
+            "nullable": true,
+            "type": "string"
+          },
+          "desiredStatus": {
+            "nullable": true,
+            "type": "string"
+          },
+          "exitCode": {
+            "nullable": true,
+            "type": "number"
+          },
+          "lastStatus": {
+            "type": "string"
+          },
+          "startedAt": {
+            "nullable": true,
+            "type": "string"
+          },
+          "state": {
+            "enum": [
+              "pending",
+              "running",
+              "succeeded",
+              "failed"
+            ],
+            "type": "string"
+          },
+          "stoppedAt": {
+            "nullable": true,
+            "type": "string"
+          },
+          "stoppedReason": {
+            "nullable": true,
+            "type": "string"
+          },
+          "taskArn": {
+            "type": "string"
+          },
+          "taskId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "taskId",
+          "taskArn",
+          "state",
+          "lastStatus",
+          "desiredStatus",
+          "exitCode",
+          "stoppedReason",
+          "createdAt",
+          "startedAt",
+          "stoppedAt"
+        ],
+        "type": "object"
+      },
       "AdminPushAlertRequest": {
         "properties": {
           "dedupeKey": {
@@ -4918,7 +5269,7 @@
             "$ref": "#/components/schemas/Pagination"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "sort": {
             "$ref": "#/components/schemas/BreakdownSort"
@@ -5293,6 +5644,10 @@
           "measure": {
             "type": "string"
           },
+          "nextCursor": {
+            "description": "Paged party slices only (a chart request that passed `size` or `after` with `slice` `originator` / `broker` / `loanCompany`). Opaque cursor for the next page of the ranking — send it back as `after` with the same body. Absent on the last page.",
+            "type": "string"
+          },
           "omittedCount": {
             "description": "How many documents fell outside the bars — the size of the dropped tail, not its value. A chart groups by a capped number of distinct values, so a slice with more of them than the cap returns its largest groups and drops the rest; `zip`, `city`, `lender` and `originator` are the ones that reach it. It is the documents in the groups past the size cap, and only those: documents excluded from the slice by its empty-value filter, or carrying no value for it at all, are never grouped and are not counted here either. Where the response carries an `unattributed` row that row collects them; elsewhere a small residual against `/analytics/summary` can remain on `city`, `lender`, `originator` and similar, so bars plus this count reconcile with the summary's population exactly only on a slice with no such documents. `0` means the bars ARE the complete set, and the field is absent only where the grouping cannot truncate at all — so `0` and missing are different claims. Unlike a breakdown there is no next page to fetch: narrow the filters or pick a coarser slice. It is a DOCUMENT count and never a dollar or an average — the aggregation reports how many rows it left out, not what they were worth, so a truncated volume chart cannot be completed from this figure. One exception it does not cover: the average measures drop buckets thinner than a minimum sample size, and those are not counted here — compare against the summary when a mean matters.",
             "type": "number"
@@ -5303,6 +5658,14 @@
           },
           "slice": {
             "type": "string"
+          },
+          "total": {
+            "description": "Paged party slices only. Distinct bucket keys (e.g. originators) in the filtered population — what a consumer paginates against. A cardinality ESTIMATE (see `totalApproximate`): near-exact below 40,000, approximate above. On an average measure it can exceed the ranked buckets, which drop keys under the 5-document floor. Use `nextCursor`, not `total`, to decide whether another page exists.",
+            "type": "integer"
+          },
+          "totalApproximate": {
+            "description": "Present (always `true`) alongside `total`: the total is a cardinality estimate, not an exact count.",
+            "type": "boolean"
           }
         },
         "required": [
@@ -15724,6 +16087,36 @@
           }
         ]
       },
+      "DatedPeriod": {
+        "description": "Date window for loans / sales / market endpoints. Accepts every `Period` value plus rolling windows: `last30Days` / `last60Days` / `last90Days` (today minus 30 / 60 / 90 days through today), `previousMonth` (the last complete calendar month) and `currentMonth` (the 1st of this month through today). All windows are resolved in UTC with inclusive calendar-date bounds. Rolling windows are only accepted by the loans, sales and market endpoints (list, count, breakdowns, analytics summary / time-series / chart); originators / companies / branches / agents / offices endpoints return 400 for them.",
+        "enum": [
+          "2017",
+          "2018",
+          "2019",
+          "2020",
+          "2021",
+          "2022",
+          "2023",
+          "2024",
+          "2025",
+          "2026",
+          "last3Months",
+          "last6Months",
+          "last12Months",
+          "last14Months",
+          "last16Months",
+          "last18Months",
+          "last24Months",
+          "yearToDate",
+          "allTime",
+          "last30Days",
+          "last60Days",
+          "last90Days",
+          "previousMonth",
+          "currentMonth"
+        ],
+        "type": "string"
+      },
       "EarlyExitCounterparty": {
         "properties": {
           "name": {
@@ -18026,6 +18419,11 @@
           "advancedFilters": {
             "$ref": "#/components/schemas/FilterNode"
           },
+          "after": {
+            "description": "PARTY slices only. Opaque cursor from a previous page's `nextCursor`; send the same body otherwise. A cursor is bound to the `slice` and `measure` it was issued for (400 if they change). It is an offset into the ranking, so a rolling `period` re-resolved on a later UTC day ranks a shifted window.",
+            "minLength": 1,
+            "type": "string"
+          },
           "filters": {
             "$ref": "#/components/schemas/FilterNode"
           },
@@ -18319,7 +18717,13 @@
             "$ref": "#/components/schemas/ChartMeasure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
+          },
+          "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,
+            "minimum": 1,
+            "type": "integer"
           },
           "slice": {
             "$ref": "#/components/schemas/LoanSlice"
@@ -18717,7 +19121,7 @@
             "$ref": "#/components/schemas/Pagination"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "sort": {
             "items": {
@@ -19260,7 +19664,7 @@
             "type": "object"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           }
         },
         "type": "object"
@@ -19567,7 +19971,7 @@
             "$ref": "#/components/schemas/Measure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "segment": {
             "$ref": "#/components/schemas/LoanSlice"
@@ -19870,7 +20274,7 @@
             "$ref": "#/components/schemas/MarketChartMeasure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "slice": {
             "$ref": "#/components/schemas/MarketSliceDimension"
@@ -20062,7 +20466,7 @@
             "type": "integer"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "slice": {
             "description": "Break the mix down by a market dimension — `metro` for the metro (CBSA) grain, `state` / `county` / `zip` for geography, or any product dimension. Each bucket reports its OWN denominators, so bucket shares are comparable to each other and to the overall mix. Omit for the overall mix only.",
@@ -20488,7 +20892,7 @@
             "$ref": "#/components/schemas/Pagination"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "sort": {
             "items": {
@@ -20847,7 +21251,7 @@
             "$ref": "#/components/schemas/MarketFlatFilters"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           }
         },
         "type": "object"
@@ -20940,7 +21344,7 @@
             "$ref": "#/components/schemas/MarketMeasure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "segment": {
             "$ref": "#/components/schemas/MarketSliceDimension"
@@ -24338,6 +24742,46 @@
               "nmlsId": {
                 "$ref": "#/components/schemas/TextFilterValue"
               },
+              "officeCity": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Office city — matches originators whose NMLS-registered office is in this city (NOT where they produced loans; that is `city`). Resolved through the location dictionary, so spelling variants match (`Saint Louis` = `St. Louis`); pair it with `officeState` to pick one of several same-named cities (a sibling production `state` does NOT disambiguate it), or pass a dictionary city id. An unrecognized city is a 400 naming `instantSearch`. Pass an array to match any of several."
+                  }
+                ]
+              },
+              "officeCounty": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Office county — matches originators whose NMLS-registered office zip lies in this county. Accepts a county name (`Orleans`, with a sibling `officeState` when the name exists in several states), a 5-digit FIPS code (`22071`) or a dictionary county id. The office address carries no county of its own, so it is derived from the office zip: each zip is assigned to the ONE county holding most of its parcels, which makes the counties of a state partition its offices but attributes an office in a zip that straddles a county line to the zip's main county. An unrecognized county is a 400."
+                  }
+                ]
+              },
+              "officeState": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Office state — matches originators whose NMLS-registered office is in this state (NOT where they produced loans; that is `state`). A 2-letter code or full name (`LA` or `Louisiana`), any case; pass an array to match any of several. Period-independent. Originators with no office address on file never match."
+                  }
+                ]
+              },
+              "officeZip": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/TextFilterValue"
+                  },
+                  {
+                    "description": "Office zip code — matches originators whose NMLS-registered office is in this 5-digit zip (ZIP+4 office addresses match their 5-digit prefix). Pass an array to match any of several."
+                  }
+                ]
+              },
               "opportunityZoneCount": {
                 "allOf": [
                   {
@@ -24741,7 +25185,9 @@
                     "city",
                     "countyFips",
                     "producersOnly",
-                    "yearsInIndustry"
+                    "yearsInIndustry",
+                    "officeState",
+                    "officeCity"
                   ],
                   "type": "string"
                 },
@@ -25667,6 +26113,21 @@
             "nullable": true,
             "type": "string"
           },
+          "officeCity": {
+            "description": "City of the originator's NMLS-registered office — the value the `officeCity` filter matches. Null when no office address is on file.",
+            "nullable": true,
+            "type": "string"
+          },
+          "officeState": {
+            "description": "2-letter state of the originator's NMLS-registered office — the value the `officeState` filter matches.",
+            "nullable": true,
+            "type": "string"
+          },
+          "officeZip": {
+            "description": "Zip of the originator's NMLS-registered office as stored (5-digit, occasionally ZIP+4) — the value the `officeZip` filter matches.",
+            "nullable": true,
+            "type": "string"
+          },
           "phone": {
             "nullable": true,
             "type": "string"
@@ -26459,6 +26920,7 @@
         "type": "object"
       },
       "Period": {
+        "description": "Pre-aggregated period block. Rolling windows (last30Days, last60Days, last90Days, previousMonth, currentMonth) are NOT accepted here and return 400; they are supported on the loans, sales and market endpoints (list, count, breakdowns, analytics summary / time-series / chart) (see `DatedPeriod`).",
         "enum": [
           "2017",
           "2018",
@@ -29578,7 +30040,7 @@
             "$ref": "#/components/schemas/ChartMeasure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "slice": {
             "$ref": "#/components/schemas/SaleChartSlice"
@@ -29778,7 +30240,7 @@
             "$ref": "#/components/schemas/Pagination"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "sort": {
             "items": {
@@ -30032,7 +30494,7 @@
             "$ref": "#/components/schemas/SaleFlatFilters"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           }
         },
         "type": "object"
@@ -30056,7 +30518,7 @@
             "$ref": "#/components/schemas/Measure"
           },
           "period": {
-            "$ref": "#/components/schemas/Period"
+            "$ref": "#/components/schemas/DatedPeriod"
           },
           "segment": {
             "$ref": "#/components/schemas/SegmentDimension"
@@ -31284,7 +31746,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.57.0"
+    "version": "3.59.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -34972,6 +35434,210 @@
         ]
       }
     },
+    "/v1/admin/cad/links/{nmlsId}": {
+      "get": {
+        "description": "Diagnostic: the LO's indexed employment union (sponsorships + registrations), split by source with active counts. `indexGaps` lists what the former database diagnostic showed that the index does not carry.",
+        "operationId": "adminGetCadLinks",
+        "parameters": [
+          {
+            "description": "Individual NMLS id.",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Individual NMLS id.",
+              "example": "3352",
+              "pattern": "^\\d+$/u",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AdminCadLinks"
+                }
+              }
+            },
+            "description": "Links"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not authenticated"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Admin role required"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No individual with that NMLS id"
+          }
+        },
+        "summary": "An LO's sponsorship / registration links (admin)",
+        "tags": [
+          "Admin: NMLS"
+        ]
+      }
+    },
+    "/v1/admin/cad/load": {
+      "post": {
+        "description": "Starts the `load-cad` ECS task and returns its id. Poll `GET /v1/admin/cad/load/{taskId}`. The load writes the licensing database only; run `index-cad` afterwards (or pass `reindex: true`) to publish it.",
+        "operationId": "adminLaunchCadLoad",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AdminCadLoadRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "202": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AdminCadLoadLaunch"
+                }
+              }
+            },
+            "description": "Task launched"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Invalid body"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not authenticated"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Admin role required"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "ECS not configured (local dev)"
+          }
+        },
+        "summary": "Launch the NMLS loader (admin)",
+        "tags": [
+          "Admin: NMLS"
+        ]
+      }
+    },
+    "/v1/admin/cad/load/{taskId}": {
+      "get": {
+        "description": "ECS lifecycle of a `load-cad` task. `succeeded` = exited 0 (load completed or paused); `failed` = any other stop. Per-file progress is in the task logs and the load bookkeeping tables.",
+        "operationId": "adminGetCadLoadTask",
+        "parameters": [
+          {
+            "description": "ECS task id returned by the launch route.",
+            "in": "path",
+            "name": "taskId",
+            "required": true,
+            "schema": {
+              "description": "ECS task id returned by the launch route.",
+              "example": "0123456789abcdef0123456789abcdef",
+              "pattern": "^[a-f0-9]{32}$/u",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AdminCadLoadTaskStatus"
+                }
+              }
+            },
+            "description": "Task status"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not authenticated"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Admin role required"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No load-cad task with that id (or ECS expired it)"
+          }
+        },
+        "summary": "Status of a loader task (admin)",
+        "tags": [
+          "Admin: NMLS"
+        ]
+      }
+    },
     "/v1/admin/jobs/{jobId}": {
       "get": {
         "description": "Returns any org's bulk job (delivery or enrichment) with a freshly signed download URL for its result file. Cross-org: signs against the job's own stored org. `resultsUrl` is null until the job is completed.",
@@ -55297,6 +55963,7 @@
     },
     "/v1/loans/analytics/chart": {
       "post": {
+        "description": "Buckets the filtered loans by `slice` and ranks them by `measure`, descending. Party slices (`originator`, `broker`, `loanCompany`) are pageable: send `size` (1–1000) and follow `nextCursor` via `after` to walk the whole ranking, with `total` giving the (approximate) number of distinct parties. Other slices return their fixed top-N. `period` accepts rolling windows (`last30Days`, `last60Days`, `last90Days`, `previousMonth`, `currentMonth`) resolved in UTC; `/loans/analytics/summary` with the same filters and period returns the matching population totals.",
         "operationId": "loansAnalyticsChart",
         "requestBody": {
           "content": {