Skip to main content
GET
List Investorlift listings around a location with what the deeds show

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
lat
number

Point latitude (with lng). With radius_miles it is the search geometry. With bbox it is the reference point only.

Required range: -90 <= x <= 90
​
lng
number

Point longitude (with lat).

Required range: -180 <= x <= 180
​
radius_miles
number

Search radius in miles around the point or around the centre of the property_id parcel, 0.25 to 20 (default 2). Not allowed with bbox.

Required range: 0.25 <= x <= 20
​
bbox
string

Viewport as west,south,east,north (WGS84 degrees). West must be less than east, south less than north, and the diagonal at most 40 mi. It must intersect a loaded market's coverage bbox (422 outside_coverage otherwise). It can carry lat + lng (without radius_miles) as the reference point for distances and sort=distance.

​
property_id
string

Parcel geometry: search around the centre of that parcel, with radius_miles. Not allowed with lat, lng or bbox.

Pattern: ^prop_[0-9a-f]{32}$
​
zip
string[]

Place geometry: the parcels of these 5-digit ZIP codes, as a comma list or a repeated key, up to 50. On the deal and investor routes the Free and Starter plans take exactly one ZIP, and more is 403 plan_limit. You can add lat + lng as the reference point for distances. Not with radius_miles, bbox, property_id or city. A ZIP that no parcel of a loaded market carries is 422 outside_coverage (zips_unknown in the body).

Required array length: 1 - 50 elements
Pattern: ^\d{5}$
​
city
string

Place geometry: the parcels whose postal city is this one, as the county records it ("Scottsdale"). Case does not matter: the API compares the value folded upper case. Never the short-term rental jurisdiction (meta.coverage[].str.jurisdictions[]). You can add lat + lng as the reference point, but not radius_miles, bbox, property_id or zip. On the deal and investor routes of the Free and Starter plans a city-wide search is 403 plan_limit. A city that no parcel of a loaded market carries is 422 outside_coverage.

Required string length: 1 - 100
​
outcome
enum<string>[]

Outcomes to keep (comma list or repeated key). Default: every outcome.

Minimum array length: 1

What the county deeds record for the listing, in detail. The one-word verdict is verification. ASSIGNED: one deed from the homeowner to the buyer, and the listing company is not on title, so a contract assignment. DOUBLE_CLOSED: two chained deeds 0 to 14 days apart, with the company or its buyer in the middle. LISTER_HELD_THEN_SOLD: the company took title and resold within 90 days. LISTER_SOLD_FROM_INVENTORY: the company already owned the house and sold it. SOLD_OFF_MARKET_GRANTOR: one deed from a seller who is neither the homeowner of record nor the company, so an unrecorded step came before it. SOLD_TO_OWNER_OCCUPANT: the buyer moved in, so not an investor sale. FAILED_THEN_RETAIL_MLS: the homeowner sold on the MLS instead. DISTRESSED_TRANSFER: a sheriff's, trustee's or REO deed. LATE_TRANSFER: a deed 180 to 400 days after the listing that nothing ties to it. NO_TRANSFER_400: no deed within 400 days. NO_DEED_120: no deed by the deed data end, 120 to 400 days after the listing, so provisional. PENDING: the company listed the house fewer than 120 days before the deed data end, and no deed exists yet. SUPERSEDED: another Investorlift listing of the same parcel holds the credit for the deed. AMBIGUOUS_DEEDS: two or more unrelated sales that the rules cannot order.

Available options:
ASSIGNED,
DOUBLE_CLOSED,
LISTER_HELD_THEN_SOLD,
LISTER_SOLD_FROM_INVENTORY,
SOLD_OFF_MARKET_GRANTOR,
SOLD_TO_OWNER_OCCUPANT,
FAILED_THEN_RETAIL_MLS,
DISTRESSED_TRANSFER,
LATE_TRANSFER,
NO_TRANSFER_400,
NO_DEED_120,
PENDING,
SUPERSEDED,
AMBIGUOUS_DEEDS
​
verification
enum<string>[]

Verdicts to keep (comma list or repeated key): CONFIRMED for verified transactions, OPEN for listings without a closing deed by the deed data_end. Default: every verdict.

Minimum array length: 1

The API derives the one-word verdict of the deeds on the listing from outcome alone, and the Investorlift status plays no part. CONFIRMED: a recorded deed closed it to a buyer, so a verified wholesale transaction. RETAIL: it closed, but to an owner-occupant or through the MLS, so not an investor sale. OPEN: the deeds record no transfer yet, up to the deed data_end. NONE: no transfer within 400 days, a distressed deed, or a transfer the rules cannot tie to this listing. NONE also when the credit went to another listing of the parcel.

Available options:
CONFIRMED,
RETAIL,
OPEN,
NONE
​
buyer_tier
enum<string>[]

Buyer tiers to keep (comma list or repeated key). Default: every tier.

Minimum array length: 1

Who the buyer on the closing deed is, strongest first. REGISTRY_STRONG: a registry investor at STRONG or PROBABLE confidence, named, with an investor id. REGISTRY_WEAK: a registry investor at WEAK confidence, named, with an id. IL_BUYER_CONFIRMED: not in the registry, but the accepted offer's buyer or an Investorlift buyer account keys to the deed. On that tier the API names an entity and never a person. ENTITY_UNREGISTERED: an LLC or corporation not yet in the registry, often a fresh single-deed entity, named, no id. PERSON_ABSENTEE: a person whose mailing address is not the house, never named: show "individual buyer, not a known investor". OWNER_OCCUPANT: the buyer moved in, never named. UNRESOLVED: no closing deed. The first three count as a known investor.

Available options:
REGISTRY_STRONG,
REGISTRY_WEAK,
IL_BUYER_CONFIRMED,
ENTITY_UNREGISTERED,
PERSON_ABSENTEE,
OWNER_OCCUPANT,
UNRESOLVED
​
known_investor
enum<string>

Keep only listings bought by a known investor (buyer_tier REGISTRY_STRONG, REGISTRY_WEAK or IL_BUYER_CONFIRMED).

Available options:
true,
false
​
listed_after
string

Keep listings published on or after this date.

​
listed_before
string

Keep listings published on or before this date.

​
closed_after
string

Keep listings whose closing deed is on or after this date. Once you set closed_after or closed_before, the list drops rows without a deed.

​
closed_before
string

Keep listings whose closing deed is on or before this date.

​
asking_min
integer

Minimum asking price, inclusive, whole dollars. Once you set asking_min or asking_max, the list drops unpriced rows.

Required range: 0 <= x <= 9007199254740991
​
asking_max
integer

Maximum asking price, inclusive, whole dollars.

Required range: 0 <= x <= 9007199254740991
​
primary_only
enum<string>
default:true

Default true: drop SUPERSEDED rows and the non-credited members of a SHARED(n) group, so the list shows one closing deed once. The filter does not touch rows without a closing deed, so the list keeps every listing. primary_only=false lists every row, duplicates included.

Available options:
true,
false
​
sort
enum<string>

The row order. The default closed_on puts the newest closing deed first, rows without a deed last, then the newest listing first. With listed_on, the newest listing comes first. With asking_price, the highest asking price comes first and unpriced rows last. Every sort breaks ties on the listing id.

Available options:
closed_on,
listed_on,
asking_price
​
limit
integer
default:500

Page size, 1-500 (default 500).

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
​
wholesaler_id
string

Scope the rows to one listing company.

Pattern: ^wsr_[0-9a-f]{12}$
​
buyer_investor_id
string

Scope the rows to listings bought by one registry investor, the buyer on the closing deed. The API follows an old id from an earlier data refresh to the investor id that replaced it, and echoes the old id in meta.resolved_from. A retired id answers 410 gone.

Pattern: ^inv_[0-9a-f]{12}$

Response

One page of Investorlift listings inside the geometry after the filters, in the requested sort, with the summary and the cursor for the next page.

Investorlift listings inside the geometry after the filters, one page, with the counts over the whole geometry.

​
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: when the API produced it, which markets it covers, and how fresh they are.

​
summary
object
required

Counts for the whole geometry after the filters (not just the page).