Originators
Get originator by NMLS ID
Authorization
Path parameters
nmlsIdstringrequiredOriginator NMLS ID
Query parameters
periodenumPeriod for volume/units (default: last12Months)
2017201820192020202120222023202420252026last3Monthslast6Monthslast12Monthslast14Monthslast16Monthslast18Monthslast24MonthsyearToDateallTimeResponses
200objectOriginator detailShow attributesHide attributes
dataobjectrequiredShow child attributesHide child attributes
avgLoanAmountnumber | nullMean loan size for the selected period, derived from the TOTAL volume and units across ALL markets — NOT scoped to any geographic filter in this request. For production INSIDE the geography this request names, read scopedVolume/scopedUnits on the same row, and sort by them to rank originators by it. POST /v1/originators/{nmlsId}/breakdowns/counties (or /cities, /states, /zip-codes) breaks ONE originator's production out by market.
branchLocationobject | nullThe NMLS branch the originator is currently registered at. Null when they have no branch location on file.
Show child attributesHide child attributes
citystring | nullnamestring | nullnmlsIdstring | nullBranch NMLS ID.
statestring | nullcitystring | nullThe city with the most loan volume inside the primary-market state, in the selected period. Null when no city is on record in that state.
companyCategorystring | nullCategory of the current employer: BANK, CU (credit union) or OTHER.
companyNamestring | nullcompanyNmlsIdstring | nullNMLS ID of the originator's current employer (the same value the companyNmlsId filter matches). Null when they are not currently registered with a company.
companyStartDatestring | nullDate (YYYY-MM-DD) the originator started at their current employer: the earliest ACTIVE sponsorship or registration start at that company. Null when not currently working.
contactobject | nullShow child attributesHide child attributes
cellPhonestring | nullemployerAddressstring | nullemployerCitystring | nullemployerCompanystring | nullemployerCompanyIdstring | nullemployerStatestring | nullemployerTypestring | nullemployerWebsitestring | nullemployerZipstring | nullfacebookstring | nulllinkedinstring | nullofficePhonestring | nullofficePhoneExtstring | nullpersonalEmailstring | nulltwitterstring | nullwebsitestring | nullworkEmailstring | nullconventionalPctnumber | nullemailstring | nullemployerCitystring | nullemployerStatestring | nullfhaPctnumber | nullfirstNamestring | nullidstringrequiredDocument ID
isBranchManagerboolean | nullTrue when the originator is a manager of record on any NMLS branch.
isBrokerboolean | nullBroker (true) vs retail (false) for the selected period — the same period-scoped flag the isBroker filter matches. Null when the period bucket is absent.
isWorkingboolean | nullTrue when the originator holds an active company sponsorship or registration.
lastNamestring | nulllastTransactionDatestring | nullISO datetime of the originator's most recent loan INSIDE the selected period — the value the lastTransactionDate filter and sort use. Under the default last12Months this is the originator's most recent loan overall. Null when the period bucket carries no production.
licenseCountnumber | nullCurrent NMLS registration license count — the value the licenseCount filter matches.
licensedSinceDatestring | nullDate (YYYY-MM-DD) the originator's NMLS registration began — the value the licensedSinceDate filter and sort use. Lifetime, not scoped by period. Null when no registration record is on file.
namestring | nullnmlsIdstring | nullofficeCitystring | nullCity of the originator's NMLS-registered office — the value the officeCity filter matches. Null when no office address is on file.
officeStatestring | null2-letter state of the originator's NMLS-registered office — the value the officeState filter matches.
officeZipstring | nullZip of the originator's NMLS-registered office as stored (5-digit, occasionally ZIP+4) — the value the officeZip filter matches.
phonestring | nullpreviousUnitsnumber | nullThe originator's TOTAL loan count in the 12 months BEFORE the last12Months window — months 13-24 back — with the same availability and geography caveats as previousVolume (NMLS 7206: 1,295 → 550). For production INSIDE the geography this request names, read scopedVolume/scopedUnits on the same row, and sort by them to rank originators by it. POST /v1/originators/{nmlsId}/breakdowns/counties (or /cities, /states, /zip-codes) breaks ONE originator's production out by market.
previousVolumenumber | nullThe originator's TOTAL dollar production in the 12 months BEFORE the last12Months window — i.e. months 13-24 back. Pair it with volume for a true trailing year-over-year change (NMLS 7206: $855,758,492 → $440,740,230, −48.5%). Substituting calendar years answers a DIFFERENT question and disagrees materially — 2024 vs 2025 for the same originator reads −39.6%, nine points off — because a calendar year is not a trailing window and the current one is only partly elapsed. ABSENT, not zero, on any period other than last12Months: no other window has a containing block measured in the index, and a zero would read as 'produced nothing' rather than 'not available here'. For production INSIDE the geography this request names, read scopedVolume/scopedUnits on the same row, and sort by them to rank originators by it. POST /v1/originators/{nmlsId}/breakdowns/counties (or /cities, /states, /zip-codes) breaks ONE originator's production out by market.
purchaseSharenumber | nullPurchase loans as a 0–100 percent of the originator's period loan COUNT — the value sort: [{field: "purchaseShare"}] orders by. null when the originator wrote no purchase loans in the period (sorts as 0).
purchaseUnitsnumber | nullpurchaseVolumenumber | nullrefinanceSharenumber | nullRefinance loans as a 0–100 percent of the originator's period loan COUNT — the value sort: [{field: "refinanceShare"}] orders by. null when none (sorts as 0).
refinanceUnitsnumber | nullrefinanceVolumenumber | nullregulatorsstring[] | nullDistinct state regulators across the originator's sponsorships, historical included.
scopedUnitsnumber | nullThe originator's loan count INSIDE the geography this request names, on the same basis as scopedVolume. Sortable. A single positive footprint market (city / county / state / zip, never lender) scopes it too; a negated, any-market (dimension only) or multi-entry footprint names no single place. When the request names no geography — or names one only inside an or group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with POST /v1/originators/{nmlsId}/markets for the same geography and period: both are read from the same per-market rollup on the same record.
scopedVolumenumber | nullThe originator's dollar production INSIDE the geography this request names — what a state/city/county/zip filter was almost certainly asking for, and what the sibling volume is not. Sort by scopedVolume to rank originators by it. A single positive footprint market (city / county / state / zip, never lender) scopes it too; a negated, any-market (dimension only) or multi-entry footprint names no single place. When the request names no geography — or names one only inside an or group or a negation — the scope is everywhere, and this is identical to the unscoped figure beside it. Reconciles with POST /v1/originators/{nmlsId}/markets for the same geography and period: both are read from the same per-market rollup on the same record.
statestring | nullPrimary market state: the state with the most loan volume in the selected period (production geography, not the office). Not a sort axis; sort by officeState to order by state.
tenureMonthsnumber | nullWhole months at the current employer, from companyStartDate, as of the last weekly registration refresh. The value the timeAtCompanyMonths filter matches.
unitsnumber | nullThe originator's TOTAL loan count for the selected period across ALL markets — NOT scoped to any geographic filter in this request, exactly as described on volume. For production INSIDE the geography this request names, read scopedVolume/scopedUnits on the same row, and sort by them to rank originators by it. POST /v1/originators/{nmlsId}/breakdowns/counties (or /cities, /states, /zip-codes) breaks ONE originator's production out by market.
vaPctnumber | nullvolumenumber | nullThe originator's TOTAL dollar production for the selected period across ALL markets — NOT scoped to any geographic filter (state/city/county/countyFips/zip/zipCode) in this request. Those filters select WHICH originators are returned — they produced at least one loan there — and never change WHAT is summed here. Since the list sorts by volume descending by default, a geo-filtered search ranks originators by NATIONAL production, so the top row can be many times larger than that originator's production inside the filtered area. For production INSIDE the geography this request names, read scopedVolume/scopedUnits on the same row, and sort by them to rank originators by it. POST /v1/originators/{nmlsId}/breakdowns/counties (or /cities, /states, /zip-codes) breaks ONE originator's production out by market.
yearsInIndustrynumber | nullYears of recorded industry tenure — the value the yearsInIndustry filter and sort use. Lifetime, not scoped by period.
careerHistoryobject | nullShow child attributesHide child attributes
employerCountnumber | nullNumber of employers on the origination record. May be lower than employers.length, which also counts companies known only from the NMLS sponsorship record.
employersobject[]requiredEmployer history, current employer(s) first, then most recent activity.
recordsobject[]Every NMLS employment record — company sponsorships AND federal registrations — newest start first, each with the company's registered address. Empty until the registration record carries them.
summaryobject | nullCounts over records and the state licenses. Null when the originator has no registration record.
communityLendingobject | nullCommunity Lending — the neighborhood (U.S. Census tract) mix of the loans this entity produced in the selected period: program shares and counts, the averaged neighborhood profile, and the local mortgage market. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100. Every share is taken over loansWithCommunityData, NOT over the entity's total production. Two fields are deliberately not 0-100: avgIncomeVsMetroPct is a ratio where 100 means parity with the metro (it exceeds 100), and ruralGradient is an ordinal 1-10 code. null — not an all-null object — when the entity had no tract-resolved loans in the window. Returned by the entity DETAIL routes only (getOriginator / getCompany / getBranch); list rows omit the block. Every key here is also a filter key on the matching list route.
Show child attributesHide child attributes
affordableHousingTractCountnumber | nullrequiredLoans in qualified affordable-housing neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
affordableHousingTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in qualified neighborhoods for affordable-housing programs, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgAsianPctnumber | nullrequiredMean Asian (non-Hispanic) share of the population in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgBlackPctnumber | nullrequiredMean Black (non-Hispanic) share of the population in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgDenialRatenumber | nullrequiredMean share of mortgage applications denied in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgFamilyIncomenumber | nullrequiredMean median family income of those neighborhoods, in whole dollars. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgHispanicPctnumber | nullrequiredMean Hispanic or Latino share of the population in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgHomeValuenumber | nullrequiredMean median home value across those neighborhoods, in whole dollars — a neighborhood statistic, not the entity's average loan size (avgLoanAmount). Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgHomeownershipRatenumber | nullrequiredMean owner-occupied share of housing units in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgHouseholdIncomenumber | nullrequiredMean median household income of those neighborhoods, in whole dollars. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgIncomeVsMetroPctnumber | nullrequiredMean neighborhood income relative to its metro area, where 100 is parity. Legitimately exceeds 100 — a ratio, not a share. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgLowModHouseholdPctnumber | nullrequiredMean HUD block-group low/moderate-income HOUSEHOLD share across those neighborhoods, 0-100 — a finer measure than lowModIncomeTractPct, which counts whole neighborhoods. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgMedianAgenumber | nullrequiredMean median age of the population in those neighborhoods, in years. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgMilesToCollegenumber | nullrequiredMean straight-line distance to the nearest college, in miles. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgMilesToSchoolnumber | nullrequiredMean straight-line distance to the nearest school, in miles. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgMilesToWorshipnumber | nullrequiredMean straight-line distance to the nearest place of worship, in miles. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgMinorityPctnumber | nullrequiredMean non-white share of the population in those neighborhoods, 0-100. majorityMinorityTractPct is the per-neighborhood-threshold form of the same question. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgPopulationnumber | nullrequiredMean population of those neighborhoods. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgPovertyRatenumber | nullrequiredMean share of the population below the poverty line in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgTractApplicationsnumber | nullrequiredMean number of mortgage applications reported in those neighborhoods, over the year. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgTractLoanVolumenumber | nullrequiredMean mortgage dollar volume reported in those neighborhoods, over the year. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgTractOriginationsnumber | nullrequiredMean number of mortgage originations reported in those neighborhoods, over the year. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
avgWhiteNonHispanicPctnumber | nullrequiredMean White (non-Hispanic) share of the population in those neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
difficultDevelopmentAreaCountnumber | nullrequiredLoans in HUD-designated difficult development areas, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
difficultDevelopmentAreaPctnumber | nullrequiredShare of the entity's tract-resolved loans in HUD-designated difficult development areas, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
distressedTractCountnumber | nullrequiredLoans in distressed-or-underserved neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
distressedTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in distressed-or-underserved nonmetropolitan middle-income neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
floodHazardTractCountnumber | nullrequiredLoans in a FEMA special flood hazard area, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
floodHazardTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in a FEMA special flood hazard area, 0-100. predominantFloodZone names the specific zone. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
loansWithCommunityDatanumber | nullrequiredHow many of the entity's loans in the selected period resolved to a neighborhood — the DENOMINATOR every share in this block is taken over. Read it first: a 100% share off two loans is not a 100% share off two hundred. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
lowModIncomeTractCountnumber | nullrequiredLoans in low- or moderate-income neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
lowModIncomeTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in low- or moderate-income neighborhoods under the Community Reinvestment Act, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
majorityMinorityTractCountnumber | nullrequiredLoans in majority-minority neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
majorityMinorityTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in majority-minority neighborhoods, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
opportunityZoneCountnumber | nullrequiredLoans in Opportunity Zones, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
opportunityZonePctnumber | nullrequiredShare of the entity's tract-resolved loans in federally designated Opportunity Zones, 0-100. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
predominantFloodZonestring | nullrequiredFEMA flood-zone code most common across those neighborhoods (e.g. AE). Null means no special flood hazard area on file. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
predominantIncomeLevelenum | nullrequiredThe relative-income classification most of the entity's loans landed in: low, moderate, middle or upper. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
lowmoderatemiddleuppernullruralGradientnumber | nullrequiredMean remoteness of those neighborhoods on an ORDINAL 1-10 scale (1 = metropolitan core, 10 = most remote). A code, not a percent. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
ruralTractCountnumber | nullrequiredLoans in rural neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
ruralTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in rural neighborhoods, 0-100. ruralGradient is the finer, ordinal form. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
usdaEligibleTractCountnumber | nullrequiredLoans in USDA-eligible neighborhoods, as a count. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
usdaEligibleTractPctnumber | nullrequiredShare of the entity's tract-resolved loans in neighborhoods eligible for USDA rural housing programs, 0-100. Broader than ruralTractPct. Values describe the U.S. Census tract (neighborhood) as a whole — tract-level aggregate statistics, never an individual, household or applicant attribute. Percentages are 0-100.
hasScoredDatabooleanfalse on an originator who is in the NMLS registry but has no production record — typically newly licensed. Their production fields (volume, units, the mix and share fields, lastTransactionDate) are null because none exists, not because it is zero: label the row (e.g. "no transactions yet") rather than rendering zeros. ABSENT on every originator with a production record. Such rows appear on the list only for an identity search (nmlsId, name or namePrefix) sent with producersOnly: false, after the rows that have production.
licensesnulllocationsnullmanagedBranchesobject[] | nullNMLS branches that list this originator as a manager of record. Empty when they manage none.
Show child attributesHide child attributes
citystring | nullcompanyNamestring | nullcompanyNmlsIdstring | nullnamestring | nullnmlsIdstring | nullrosterCountnumber | nullOriginators actively registered at the branch.
statestring | nullprofileInsightsobjectProfile read-outs computed server-side from the LO's production in the requested period (default last12Months) — the same volume / units this response reports. Labels and descriptions are display copy; branch on the enum fields.
Show child attributesHide child attributes
producerTierobjectrequiredFrom the period's units and volume, first match wins: topProducer ≥ 60 units OR ≥ $25M; strongProducer ≥ 36 units OR ≥ $12M; midTier ≥ 18 units OR ≥ $5M; else lowVolume.
registrationobject | nullShow child attributesHide child attributes
addressnullcitystring | nullcompanyCategorystring | nullcompanyNamestring | nullcompanyNmlsIdstring | nullhasDisciplinaryActionboolean | nullisBranchManagerboolean | nullisWorkingboolean | nulllicenseCountnumber | nulllicensedSinceDatestring | nulllicensedStatesstring[] | nulllicensesnullotherNamesnullregulatorsstring[] | nullsponsorshipsnullstatestring | nullregistrationsnullscorednullsponsorshipsnullstateLicensesobject[] | nullEvery state license on the originator's NMLS record, active and historical, as typed rows. The untyped licenses array carries the same rows verbatim.
Show child attributesHide child attributes
isAuthorizedboolean | nullTrue when the license currently authorizes origination.
issueDatestring | nulllicenseIdstring | nulllicenseNumberstring | nulllicenseTypestring | nullregulatorstring | nullIssuing regulator — a state name or "<State> - <Agency>"; not a normalized state code.
statusstring | nulltitlestring | null404objectOriginator not found413objectResponse payload too large