Companies

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

GET
/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-key<token>

In: header

Path Parameters

nmlsId*string

Company NMLS ID

Query Parameters

status?string

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.

Value in"active" | "entered" | "exited" | "all"
period?string

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.

Value in"2017" | "2018" | "2019" | "2020" | "2021" | "2022" | "2023" | "2024" | "2025" | "2026" | "last3Months" | "last6Months" | "last12Months" | "last14Months" | "last16Months" | "last18Months" | "last24Months" | "yearToDate" | "allTime"
from?string

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

Match^\d{4}-\d{2}-\d{2}$
to?string

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

Match^\d{4}-\d{2}-\d{2}$
asOf?string

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

Match^\d{4}-\d{2}-\d{2}$
search?string

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

Lengthlength <= 200
page?integer

1-based page (default 1).

Range1 <= value
limit?integer

Rows per page (default 25, max 500).

Range1 <= value <= 500
sort?string

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.

Value in"name" | "nmlsId" | "startDate" | "exitDate" | "volume" | "units" | "companyVolume" | "companyUnits"
order?string

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

Value in"asc" | "desc"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/companies/string/employment"
{
  "data": [
    {
      "branchLocation": {
        "city": "string",
        "name": "string",
        "nmlsId": "string",
        "state": "string"
      },
      "city": "string",
      "companyUnits": 0,
      "companyVolume": 0,
      "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": 0,
      "volume": 0
    }
  ],
  "limit": 0,
  "page": 0,
  "total": 0,
  "totalPages": 0,
  "truncated": true,
  "window": {
    "from": "string",
    "to": "string"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string",
  "limit": 0,
  "size": 0
}