Skip to main content
GET
List the flagged purchases of a place
This route serves the lean set under /v3/deals. See The lean dataset for the tier rules.

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

​
lat
number

Point latitude, with lng: the centre of a radius. One of lat with lng, property_id, zip, or bbox is required.

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

Point longitude, with lat.

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

The radius in miles around the point or the parcel, 0.25 to 20 (default 1).

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

A parcel of the place index: the centre of a radius. The API resolves it to its point.

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

A place as a list of 5-digit ZIPs (comma list or repeated key), at most 20.

Minimum array length: 1
Pattern: ^\d{5}$
​
bbox
string

Viewport as west,south,east,north (WGS84 degrees), the diagonal at most 40 mi.

​
from
string<date>

Keep deals dated on or after this date, YYYY-MM-DD.

​
to
string<date>

Keep deals dated on or before this date, YYYY-MM-DD.

​
price_min
integer

Keep deals priced at or above this, whole US dollars. An unpriced deal leaves.

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

Keep deals priced at or below this, whole US dollars. An unpriced deal leaves.

Required range: 0 <= x <= 9007199254740991
​
segment
string[]

Keep these segments of the parcel (comma list or repeated key): SFR, CONDO_TH or OTHER.

Minimum array length: 1
Required string length: 1 - 20
​
doc_class
string[]

Keep these classes of the deed (comma list or repeated key): ECONOMIC, DISTRESSED or another class of the build.

Minimum array length: 1
Required string length: 1 - 20
​
tag
string[]

Keep deals whose buyer carries any of these tags (comma list or repeated key), for example investor, ibuyer, builder, bank.

Minimum array length: 1
Required string length: 1 - 40
​
buyer
enum<string>

Keep the deals of one buyer kind. Default: both.

Available options:
registry,
deed_name
​
repeat
enum<string>

True keeps the deals of a buyer that bought another parcel in the 12 months before, false the others.

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

True keeps the deals whose parcel was sold again within 12 months, false the others.

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

True keeps the clean purchases alone, the deeds with no hard reason.

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

True keeps the purchases at a foreclosure auction: a trustee sale or a sheriff sale that passed the five tests of the build. False keeps the others.

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

True keeps the purchases from a lender, a servicer or an agency after a take-back (REO). False keeps the others.

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

The row order. sale_date_desc puts the newest deed first, an undated deed last. price_desc and price_asc order on the price, unpriced deeds last. distance puts the nearest parcel first and needs a point or a parcel. The default is sale_date_desc. Every sort breaks a tie on the deal id, then the buyer key.

Available options:
sale_date_desc,
price_desc,
price_asc,
distance
​
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 flagged purchases of the place, newest first by default, one page.

The flagged purchases of the place, newest first by default, one page.

​
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 lean family: when the API produced it, and the publishes behind the rows.