NMLS Scraper — Mortgage Loan Originators, Lenders & Branches

The only NMLS Consumer Access scraper on the Apify Store that actually returns data. Pull mortgage loan originator (MLO), lender, and branch records — state licenses, federal registrations, regulator disclosures, sponsor relationships, contact info, and computed risk-rollup flags — by NMLS ID or by name. Open source, agent-ready, no required survey form.

Use it to verify mortgage license status, build licensee lists for recruiting and sales, run compliance checks against the NMLS database, and enrich your mortgage CRM with structured Nationwide Multistate Licensing System data.

Why this exists

The other NMLS scraper on the Apify Store ships with a mandatory three-field intake survey, hides its source, and (as of 2026-05) doesn't actually return data on its own prefilled examples — mode=by_name for "Rocket Mortgage" returns 0 records and mode=by_nmls_id for 3030 (Rocket Mortgage's actual NMLS ID) returns lookup_status: "not_found". This actor is the response. It actually works on those exact inputs, it's open source, and it returns 25+ fields per entity.

Who this is for

• Mortgage recruiters building outreach lists of MLOs by state, sponsoring company, or license status
• Wholesale lender BD teams mapping broker territories and identifying licensed counterparties in target states
• Compliance and risk onboarding teams screening MLO and lender counterparties for active regulatory actions, license status, and disclosure history before approval
• Mortgage CRMs and fintech integrators enriching contact records with verified NMLS IDs, multi-state license coverage, sponsor relationships, and regulator disclosures
• Market researchers sizing the mortgage origination market by state, license type, sponsor, or branch footprint

What you get

One structured JSON record per NMLS entity (MLO, mortgage company, or branch), written to the default Apify Dataset. Re-runs deduplicate cleanly on the id field (which equals nmls_id), so you can upsert into your warehouse without extra work.

Example input

{
  "mode": "by_nmls_id",
  "nmlsIds": ["3030"],
  "includeDisclosures": true,
  "maxItems": 100,
  "capsolverApiKey": "<your-capsolver-key>",
  "proxyConfiguration": { "useApifyProxy": true }
}

Example output (one row)

{
  "id": "3030",
  "nmls_id": "3030",
  "entity_type": "COMPANY",
  "legal_name": "Rocket Mortgage, LLC",
  "other_trade_names": [
    "Champion Mortgage", "Champion Mortgage Company", "Rocket",
    "Rocket HQ", "Rocket Mortgage", "Rocket Pro", "Rocket Professional",
    "Rushmore Servicing", "Rushmore Servicing Group"
  ],
  "primary_address": {
    "street": "1050 Woodward Avenue",
    "city": "Detroit",
    "state": "MI",
    "zip": "48226",
    "country": "US"
  },
  "mailing_address": {
    "street": "1050 Woodward Avenue",
    "city": "Detroit",
    "state": "MI",
    "zip": "48226",
    "country": "US"
  },
  "state_licenses": [
    {
      "state": "Alabama",
      "regulator": "Alabama",
      "license_name": "Consumer Credit License",
      "license_number": "20979",
      "status": "Approved",
      "issue_date": "2009-11-10",
      "original_issue_date": "2009-11-10"
    }
  ],
  "federal_registrations": [],
  "sponsorships": null,
  "sponsored_individuals_count": 3705,
  "branch_count": 83,
  "employment_history": null,
  "disclosures": [
    {
      "date": "2021-09-22",
      "regulator": "Alabama",
      "action_type": "Order - Settlement Agreement and Order",
      "description": "Docket MC-2018-04; Multi-state ID M104096",
      "length_in_days": null,
      "settled": true
    }
  ],
  "has_active_regulatory_action": true,
  "total_state_licenses_active": 165,
  "contact_email": "CompanyLicensing@rocketmortgage.com",
  "source_url": "https://www.nmlsconsumeraccess.org/EntityDetails.aspx/COMPANY/3030",
  "scraped_at": "2026-05-03T03:44:31.340Z"
}

Field notes

• id is always equal to nmls_id. Use it as your upsert key.
• entity_type is one of INDIVIDUAL, COMPANY, or BRANCH. The actor auto-detects when not pinned.
• state_licenses is one row per state-regulator pairing. An entity licensed in 51 jurisdictions returns 51 rows here.
• sponsorships is populated for INDIVIDUAL records (current sponsoring company); null otherwise.
• sponsored_individuals_count and branch_count are populated for COMPANY records; null otherwise.
• has_active_regulatory_action and total_state_licenses_active are computed rollups — visible at-a-glance in the dataset preview without an ETL step on your side.
• contact_email is decoded from Cloudflare's data-cfemail obfuscation.
• All timestamps are ISO-8601 UTC.

Inputs

Field	Type	Default	Notes
mode	enum	by_nmls_id	by_nmls_id or by_name
nmlsIds	string[]	["3030"]	Used when mode=by_nmls_id
names	string[]	["Rocket Mortgage"]	Used when mode=by_name
entityType	enum	""	"" (all), INDIVIDUAL, COMPANY, BRANCH
includeDisclosures	boolean	true	Parse regulator action history
maxItems	int	100	Hard cap, max 10,000
proxyConfiguration	object	Apify default	Switch to RESIDENTIAL if you see Cloudflare blocks
capsolverApiKey	secret string	none	Required to actually fetch data — see below
maxConcurrency	int	4	Polite default

CAPTCHA setup

NMLS Consumer Access uses BotDetect CAPTCHA at the session-warmup step. The actor solves it once per run, then reuses the session for every subsequent record — so the CAPTCHA cost amortizes to fractions of a cent per record.

The default integration is CapSolver, pay-as-you-go (~$0.0005/solve, ~$5 minimum top-up). Set your key as capsolverApiKey in the input or as the CAPSOLVER_API_KEY environment variable.

Without a key, the actor exits cleanly with a clear error rather than burning your account on a half-broken run.

Alternatives the actor's solver interface supports (one-line swap in src/solver/index.ts):

• 2Captcha or Anti-Captcha (equivalent pricing, different vendor)
• Self-hosted OCR (free, more work — write a CaptchaSolver implementation)
• Manual session caching (warm once, save cookies to KV store, reuse)

Pricing

Pay-per-event:

• Actor Start → $0.05 per run (covers session warmup, including the BotDetect CAPTCHA solve)
• Record scraped → $0.001 per entity record saved to the dataset

A few worked examples so you can budget:

Records returned	You pay
1 (single MLO lookup)	$0.051
100 (recruit / sales list)	$0.15
1,000 (territory map)	$1.05
10,000 (quarterly compliance sweep)	$10.05

Per-record charges only fire when records actually save to the dataset — so a search that legitimately matches nothing only incurs the small start fee for the warmup work, not per-record fees.

v1.1 roadmap (additive — no breaking changes): a Compliance event ($0.005/record) for parsed disclosures + cross-state risk score; a Bulk discount tier above 10K records in a single run; a Standby event ($0.01/call) for synchronous single-record lookups via the Apify Standby endpoint.

Limitations

• v1 supports by_nmls_id and by_name. by_state, by_company_employees, and by_license_status ship in v1.1.
• All three entity types are supported (COMPANY, INDIVIDUAL, BRANCH). For INDIVIDUAL records, sponsorships and federal_registrations are populated when present; employment_history is reconstructed from per-license sponsorship history and aggregated to one entry per unique employer.
• Disclosures are parsed from the public regulator-actions table. Length-in-days and full action descriptions live behind a "View Details" expansion not currently scraped (v1.1).
• The portal updates nightly on business days — fresher data than that requires hitting NMLS directly.

FAQ

Is there a public NMLS API? No — NMLS does not publish a free public API for company, branch, or MLO records. NMLS Consumer Access (the public web portal at nmlsconsumeraccess.org) is the only public source, and it's CAPTCHA-protected behind a Cloudflare-fronted Turing Test page. This actor wraps the portal as a stable, structured pay-per-record data feed.

What data does NMLS Consumer Access include? Mortgage Loan Originators (~500K active), mortgage companies (~40K), and branches (~125K). Per entity: identity, current and historical legal names, state licenses (regulator, license number, status, dates), federal registrations for depository-institution MLOs, regulator disclosures, sponsor relationships, employment history reconstructed from per-license sponsorships, branch counts, sponsored-MLO counts, and contact info.

How do I verify a mortgage loan originator's license? Pass the MLO's NMLS ID with mode=by_nmls_id. The returned record includes every state license they hold (state, license number, status, issue date), any federal registration, current sponsoring company, and the count and details of any regulator disclosures.

Can I bulk-verify mortgage lender licenses? Yes — pass an array of NMLS IDs in nmlsIds (up to 10,000 per run) and the actor returns one normalized record per ID. Compliance teams use this for quarterly renewal sweeps and pre-onboarding screens.

How do I find an MLO if I don't know their NMLS ID? Use mode=by_name. The actor calls the same JSON search API the NMLS frontend uses and auto-iterates COMPANY and INDIVIDUAL entity types if you don't pin one. For very common names, narrow with entityType to avoid the portal's "too many results" cap.

Why is the source open? Compliance and risk teams audit their data sources. An auditable scraper sells better — and lets you fork it if you ever need a custom field added.

Can I run on a schedule? Yes — Apify Schedules. Recommended cadence: weekly for license-renewal monitoring, monthly for full portfolio refreshes, on-demand for fraud / pre-onboarding lookups.

How does this handle the Cloudflare block and BotDetect CAPTCHA? One CAPTCHA solve at session warmup, then session cookies carry the rest of the run. CapSolver is the default solver (~$0.0004/solve, amortized to fractions of a cent per record at typical run sizes). Two-Captcha and Anti-Captcha are one-line drop-in alternatives.

MCP / agentic support? Planned for v1.2. The actor's input shape is already designed to be MCP-packaged with no breaking changes — AI agents will be able to call it as a tool for live MLO verification.

Running locally

npm install
npm run typecheck
npm run start:dev

Set capsolverApiKey in storage/key_value_stores/default/INPUT.json for the dev loop. Run apify push to deploy.

License

MIT.