Look up companies in the NMLS registry

Search the NMLS company registry by id, name, registered address, regulator category and size — one row per registered company, INCLUDING companies with no production on file (which listCompanies does not return). Use it to resolve canonical company names for a list of NMLS ids, or to filter/sort companies by regulatorCategory, branchCount, activeLoCount or avgTenureMonths. For production metrics use listCompanies.

Authorization

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

activeLoCount?

Bound the number of loan officers currently sponsored OR registered with the company (distinct people).

branchCount?

Bound the number of registered branch offices.

city?string

Registered address city.

name?string

Company name — all words must match, fuzzily.

Lengthlength <= 200

nmlsIds?array<string>

Exact NMLS company ids (up to 1000). Every id registered with NMLS is returned, including companies with no production on file.

Itemsitems <= 1000

pagination?

limit default 100 (max 1000); offset + limit may not exceed 10,000.

regulatorCategory?array<>

BANK (OCC / FDIC, or a Federal Reserve–regulated company whose name contains 'bank'), CU (NCUA), OTHER (every other company, including every state-licensed non-bank lender). Several values union.

sort?array<>

Default: name ascending.

state?string

Registered address state (2-letter code).

Response Body

`application/json`

curl -X POST "https://example.com/v1/companies/lookup" \  -H "Content-Type: application/json" \  -d '{}'

{
  "data": [
    {
      "activeLoCount": 0,
      "avgTenureMonths": 0,
      "branchCount": 0,
      "businessStructure": "string",
      "city": "string",
      "name": "string",
      "nmlsId": "string",
      "primaryFederalRegulator": "string",
      "registrationStatus": "string",
      "regulatorCategory": "BANK",
      "state": "string"
    }
  ],
  "total": 0
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string",
  "limit": 0,
  "size": 0
}

Look up companies in the NMLS registry

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`