Companies

List a company's loan officers: current roster, hires, or exits

getapi.modelmatch.com/v1/companies/{nmlsId}/employment

Loan officers employed by (sponsored or registered with) this company, one row per person, from NMLS employment records. status picks the current roster, the window's hires, the window's complete departures, or everyone; asOf gives the roster on a past date. Rows carry tenure dates, branch-manager status, branch location, current employer, contact details and period production.

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Path parameters

nmlsIdstringrequired

Company NMLS ID

Query parameters

statusenum

active (default): currently employed — any open employment record. entered: hired inside the window. exited: completely departed inside the window. all: everyone with a record relevant to the window. A hire is a loan officer whose earliest employment record at this company still relevant to the window (open, or ended on/after the window start) starts inside it — so someone who fully left and came back inside the window counts, and an existing employee who adds a state license does not. An exit is a loan officer whose latest record at this company ended inside the window and who holds NO open record there — a complete departure.

Options:activeenteredexitedall

periodenum

Preset window when from/to are not given (default last12Months). Rolling periods start on the FIRST day of the month N months back and end today; a year is Jan 1 – Dec 31; allTime starts 2017-01-01, the earliest reliable registration data. Also selects the production period for volume/units.

Options:2017201820192020202120222023202420252026last3Monthslast6Monthslast12Monthslast14Monthslast16Monthslast18Monthslast24MonthsyearToDateallTime

fromstring

Window start, inclusive (YYYY-MM-DD). Overrides period.

tostring

Window end, inclusive (YYYY-MM-DD). Overrides period.

asOfstring

Roster AS OF this date (YYYY-MM-DD): loan officers with a record covering it. Replaces the window; status must be active or omitted.

searchstring

Loan officer name (all words, fuzzy) or an exact NMLS ID when numeric.

pageinteger

1-based page (default 1).

limitinteger

Rows per page (default 25, max 500).

sortenum

Sort key (default name). volume/units rank by the loan officer's production in period across all employers; companyVolume/companyUnits by their production AT this company inside the window.

Options:namenmlsIdstartDateexitDatevolumeunitscompanyVolumecompanyUnits

orderenum

Default asc for text/date keys, desc for the production keys.

Options:ascdesc

Responses

200objectEmployment rows

Show attributes

dataobject[]required

Show child attributes

branchLocationobject | nullrequired

Show child attributes

citystring | nullrequired

namestring | nullrequired

nmlsIdstring | nullrequired

statestring | nullrequired

citystring | nullrequired

companyUnitsnumberrequired

Loans the loan officer closed while employed here, recorded inside the window. 0 when none.

companyVolumenumberrequired

Dollar volume the loan officer closed WHILE EMPLOYED HERE (employer at time of loan = this company), recorded inside the window. 0 when none.

contactobject | nullrequired

Show child attributes

cellPhonestring | nullrequired

employerAddressstring | nullrequired

employerCitystring | nullrequired

employerCompanystring | nullrequired

employerCompanyIdstring | nullrequired

employerStatestring | nullrequired

employerTypestring | nullrequired

employerWebsitestring | nullrequired

employerZipstring | nullrequired

facebookstring | nullrequired

linkedinstring | nullrequired

officePhonestring | nullrequired

officePhoneExtstring | nullrequired

personalEmailstring | nullrequired

twitterstring | nullrequired

websitestring | nullrequired

workEmailstring | nullrequired

currentCompanyNamestring | nullrequired

currentCompanyNmlsIdstring | nullrequired

enteredbooleanrequired

Hired inside the window.

exitDatestring | nullrequired

Complete-departure date; null while still employed.

exitedbooleanrequired

Completely departed inside the window.

isActivebooleanrequired

Holds an open employment record at this company (under asOf: a record covering that date).

isBranchManagerboolean | nullrequired

namestring | nullrequired

nmlsIdstringrequired

previousEmployerobjectrequired

The employer whose record ended most recently on or before this loan officer's start here (the same rule talent-flow attributes hires by). Both null when none is on file.

Show child attributes

namestring | nullrequired

nmlsIdstring | nullrequired

startDatestring | nullrequired

For current employees, the start of the earliest OPEN record here (current tenure); otherwise the earliest record relevant to the window.

statestring | nullrequired

unitsnumber | nullrequired

volumenumber | nullrequired

The loan officer's production in period, across ALL employers (not only this company). Null when they have no production profile.

limitnumberrequired

pagenumberrequired

totalnumberrequired

totalPagesnumberrequired

truncatedbooleanrequired

true when the company has more than 100,000 loan officers in scope and only the first 100,000 (by NMLS ID) were counted. false means every figure covers the full population.

windowobjectrequired

Show child attributes

fromstringrequired

tostringrequired

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/companies/<nmlsId>/employment" \
  -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.companies.employment({
  path: {
    nmlsId: "<nmlsId>"
  }
});

import os
import requests

res = requests.get(
    "https://api.modelmatch.com/v1/companies/<nmlsId>/employment",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
)
data = res.json()

200 response

{
  "data": [
    {
      "branchLocation": {
        "city": "<string>",
        "name": "<string>",
        "nmlsId": "<string>",
        "state": "<string>"
      },
      "city": "<string>",
      "companyUnits": 123.45,
      "companyVolume": 123.45,
      "contact": {
        "cellPhone": "<string>",
        "employerAddress": "<string>",
        "employerCity": "<string>",
        "employerCompany": "<string>",
        "employerCompanyId": "<string>",
        "employerState": "<string>",
        "employerType": "<string>",
        "employerWebsite": "<string>",
        "employerZip": "<string>",
        "facebook": "<string>",
        "linkedin": "<string>",
        "officePhone": "<string>",
        "officePhoneExt": "<string>",
        "personalEmail": "<string>",
        "twitter": "<string>",
        "website": "<string>",
        "workEmail": "<string>"
      },
      "currentCompanyName": "<string>",
      "currentCompanyNmlsId": "<string>",
      "entered": true,
      "exitDate": "<string>",
      "exited": true,
      "isActive": true,
      "isBranchManager": true,
      "name": "<string>",
      "nmlsId": "<string>",
      "previousEmployer": {
        "name": "<string>",
        "nmlsId": "<string>"
      },
      "startDate": "<string>",
      "state": "<string>",
      "units": 123.45,
      "volume": 123.45
    }
  ],
  "limit": 123.45,
  "page": 123.45,
  "total": 123.45,
  "totalPages": 123.45,
  "truncated": true,
  "window": {
    "from": "<string>",
    "to": "<string>"
  }
}