Companies

Monthly loan officer headcount, hires and exits for a company

GET
/v1/companies/{nmlsId}/headcount

Authorization

x-api-key<token>

In: header

Path Parameters

nmlsId*string

Company NMLS ID

Query Parameters

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}$
interval?string

Series granularity. Only month is supported.

Value in"month"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/companies/string/headcount"
{
  "series": [
    {
      "active": 0,
      "entered": 0,
      "exited": 0,
      "net": 0,
      "period": "string"
    }
  ],
  "summary": {
    "change1y": 0,
    "change30d": 0,
    "change90d": 0,
    "current": 0,
    "entered": 0,
    "exited": 0,
    "net": 0
  },
  "truncated": true,
  "window": {
    "from": "string",
    "to": "string"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string",
  "limit": 0,
  "size": 0
}