Skip to main content
GET
Rank the lenders of a place

Authorizations

​
Authorization
string
header
required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key. The same key works on POST /mcp.

Query Parameters

​
state
string
required

The served state of the ranking, two letters. A ranking is a ranking in a place.

Pattern: ^[A-Z]{2}$
​
county
string

One county by its 5-digit FIPS. Default: the whole state. A county the served state does not list answers 404: GET /v3/coverage lists them. county and zip together answer 400 geometry_conflict.

Pattern: ^[0-9]{5}$
​
zip
string[]

A place as a list of 5-digit ZIPs (comma list or repeated key), at most 60. Default: the whole state. One ZIP ranks its own bucket. Several rank the sum of their buckets, one row for each lender over the set. A ZIP with no parcel in the place index leaves the set, and a list with none answers 404. county and zip together answer 400 geometry_conflict.

Minimum array length: 1
Pattern: ^\d{5}$
​
period
enum<string>

The window of the ranking, anchored on financing_as_of of the state: all, 24m (the 730 days before), 12m (the 365 days before). Default 24m.

Available options:
all,
24m,
12m
​
tags
enum<string>[]

Keep the lenders that carry every tag given (comma list or repeated key): government, bank, credit_union, trust, person, hard_money, institution. Default: every lender.

Minimum array length: 1

A reading of the name of the lender, each by its rule in the build. government: a public body. bank: the bank, thrift and charter words. credit_union: a credit union. trust: a trust, an IRA, an estate or a seller carry-back. person: a name that reads as a person. hard_money: the hard-money vocabulary and brands. institution: the party-wide reading of an institutional word, by the rule tag_institution of the build. It reads a bank, mortgage, loan, lending, funding, finance or servicing word. It also reads a credit union, a GSE or HUD form, a public body, a title or escrow company and an association. It also reads a school, a hospital, a church, a club, an insurer, a pension or retirement plan, a securitization or loan trust and a REIT brand. It excludes FBO, custodian, IRA, seller financing, insurance trust and the iBuyer brands. A bank, a credit union, a public body and a hard-money REIT carry it beside their own tag. It never means a bank: a mortgage company and an investor lender carry it alike. A tag decides no row: a lender keeps its loans and gets a tag. The tags of an organization are the union of the tags of its spellings, less person when the organization reads as a company. The list can grow with the rules of the build: a client keeps an unknown tag.

Available options:
government,
bank,
credit_union,
trust,
person,
hard_money,
institution
​
min_n
integer

Keep the lenders with at least this many loans in the place and the period. Default: 1.

Required range: 1 <= x <= 9007199254740991
​
min_investor_loans
integer

Keep the lenders with at least this many loans to an investor borrower in the place and the period. Default: every lender. Refused with 422 fact_unavailable while the state has no investor counts.

Required range: 1 <= x <= 9007199254740991
​
sort
enum<string>

The row order. loans_desc puts the most loans in the place first, then the largest volume. volume_desc puts the largest volume first, then the most loans. open_liens_desc puts the most open positions first, and needs period=all: the open book is counted on the all period alone. last_recorded_desc puts the newest recording first. investor_loans_desc puts the most recordings to an investor borrower first, then the most such loans: a blanket recording to one investor counts once. deals_financed_desc puts the most flagged purchases financed first, then the most loans. recordings_desc puts the most recordings first, then the most loans. A lender with none of the counted thing stays on the page after every lender with one, so rank keeps its meaning. The two investor sorts are refused with 422 fact_unavailable while the state has no investor counts. Every sort breaks a tie on the organization id. Default loans_desc.

Available options:
loans_desc,
volume_desc,
open_liens_desc,
last_recorded_desc,
investor_loans_desc,
deals_financed_desc,
recordings_desc
​
limit
integer
default:100

Page size, 1-500 (default 100).

Required range: 1 <= x <= 500
​
cursor
string

Opaque cursor from page.next_cursor of the previous page. A change of query, sort, weights or data version invalidates it (400 invalid_cursor). Then restart from page 1.

Required string length: 1 - 4096

Response

The lenders of the place in the order of the sort, the most loans first by default, one page. The loans are a dated slice. meta.build.states[].financing_as_of and recordings_through give the dates.

The lenders of the place in the order of the sort, the most loans first by default, one page. The loans are a dated slice. meta.build.states[].financing_as_of and recordings_through give the dates.

​
data
object[]
required

The rows of this page.

​
page
object
required

Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.

​
meta
object
required

Response metadata of the /v3 family: when the API produced it, and the publishes behind the rows.