Companies

Look up companies in the NMLS registry

postapi.modelmatch.com/v1/companies/lookup

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-keystringrequired

API key or OAuth token. See Authentication.

Body application/json

activeLoCountobject

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

Show child attributes

gtenumber

ltenumber

branchCountobject

Bound the number of registered branch offices.

Show child attributes

gtenumber

ltenumber

citystring

Registered address city.

namestring

Company name — all words must match, fuzzily.

nmlsIdsstring[]

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

paginationobject

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

Show child attributes

limitinteger

offsetinteger

regulatorCategoryenum[]

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.

Options:BANKCUOTHER

sortobject[]

Default: name ascending.

Show child attributes

fieldenumrequired

Options:namenmlsIdbranchCountactiveLoCountavgTenureMonths

orderenum

Options:ascdesc

statestring

Registered address state (2-letter code).

Responses

200objectRegistered companies

Show attributes

dataobject[]required

Show child attributes

activeLoCountnumber | nullrequired

Distinct loan officers currently sponsored or registered with the company.

avgTenureMonthsnumber | nullrequired

Average months the current loan officers have been at the company, as of the last weekly registry refresh. Null when it has none.

branchCountnumber | nullrequired

businessStructurestring | nullrequired

citystring | nullrequired

namestring | nullrequired

nmlsIdstring | nullrequired

primaryFederalRegulatorstring | nullrequired

registrationStatusstring | nullrequired

regulatorCategoryenum | nullrequired

Options:BANKCUOTHERnull

statestring | nullrequired

totalnumberrequired

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 POST "https://api.modelmatch.com/v1/companies/lookup" \
  -H "x-api-key: $MODEL_MATCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "<string>",
    "name": "<string>",
    "state": "<string>"
  }'

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

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

const { data, error } = await client.companies.lookup({
  body: {
    city: "<string>",
    name: "<string>",
    state: "<string>"
  }
});

import os
import requests

res = requests.post(
    "https://api.modelmatch.com/v1/companies/lookup",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
    json={
        "city": "<string>",
        "name": "<string>",
        "state": "<string>"
    },
)
data = res.json()

200 response

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