Market

Monthly NMLS activity: newly licensed, active, leaving

getapi.modelmatch.com/v1/market/movement/activity

Monthly series of newly licensed loan officers, loan officers with an open employment at month end, and loan officers who left the industry (no open employment; last one ended that month). becameInactive (license authorization lapses) is not available and is always null. all_time charts the last 60 months. A move is dated by the loan officer's FIRST record at the new company; a loan officer licensed in several states counts once per company. Location filters use the loan officer's CURRENT NMLS location. Results refresh weekly. A response not ready within 25 s answers 202 (MovementComputing): repeat the same request after retryAfterMs.

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Query parameters

dateRangestring

Reporting window. last_N_months = the N most recent COMPLETED calendar months (the current month is excluded); year_to_date = Jan 1 through the end of last month; YYYY (or fy_YYYY) = that calendar year; all_time. Default last_12_months.

statestring

Two-letter state. Matches the loan officer's CURRENT NMLS location, not where they were when they moved.

statesstring

Comma-separated two-letter states (e.g. a region). ORed; combined with state when both are sent.

citystring

Exact city name of the loan officer's current NMLS location. Pair with state.

Responses

200objectOK

Show attributes

chartDataobject[]required

Show child attributes

activeLosnumberrequired

Loan officers with an open employment record at month end.

becameInactivenumber | nullrequired

Always null: license-authorization history is not available on this surface.

leftIndustrynumberrequired

Loan officers with no open employment whose last employment ended this month. NOT the same as license inactivation.

monthstringrequired

monthEndstringrequired

monthStartstringrequired

newlyLicensednumberrequired

windowobjectrequired

The resolved reporting window (inclusive dates).

Show child attributes

endDatestringrequired

monthsnumberrequired

startDatestringrequired

202objectStill computing — poll the same request after `retryAfterMs`. See `MovementComputing`.

Show attributes

retryAfterMsintegerrequired

Suggested wait before repeating the SAME request (also sent as Retry-After, in seconds).

statusenumrequired

Options:computing

400objectValidation error

401objectUnauthorized

403objectForbidden (authenticated, but missing required context — e.g. no active organization)

404objectNot found

413objectResponse payload too large — detail endpoint capped to fit Lambda response limits

503objectSearch timed out or the cluster is overloaded — retry after `Retry-After` seconds.

curl -X GET "https://api.modelmatch.com/v1/market/movement/activity" \
  -H "x-api-key: $MODEL_MATCH_API_KEY"

import { createClient } from "@model-match/api";

const client = createClient({ apiKey: process.env.MODEL_MATCH_API_KEY });

const { data, error } = await client.market.movementActivity();

import os
import requests

res = requests.get(
    "https://api.modelmatch.com/v1/market/movement/activity",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
)
data = res.json()

200 response

{
  "chartData": [
    {
      "activeLos": 123.45,
      "becameInactive": 123.45,
      "leftIndustry": 123.45,
      "month": "Jan 2026",
      "monthEnd": "<string>",
      "monthStart": "<string>",
      "newlyLicensed": 123.45
    }
  ],
  "window": {
    "endDate": "<string>",
    "months": 123.45,
    "startDate": "<string>"
  }
}