Skip to main content
GET
List the map pins of the flagged purchases of a place
This route serves the dataset under /v3/deals/pins. See The 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 60.

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

Keep the purchases a loan of this lender organization financed, by the links of the build (strict or loose). The request is refused while the state of the lender has no loan links.

Pattern: ^[A-Z]{2}:(name:.{1,200}|[A-Z0-9-]{1,40})$
​
marketplace
enum<string>

True keeps the purchases that closed a listing of the Investorlift marketplaces. A closing is the first purchase deed of the parcel in the 400 days after the publication of the listing. False keeps the others. The request is refused while a state of the place has no marketplace match table.

Available options:
true,
false
​
cap
integer
default:20000

The most pins the API returns, 1 to 50,000 (default 20,000). Above it the route answers 422 pin_cap_exceeded: use the cells.

Required range: 1 <= x <= 50000

Response

Every flagged purchase of the place as parallel arrays.

Every flagged purchase of the place as parallel arrays.

​
data
object
required

Every flagged purchase of the place as parallel arrays, for a map.

​
meta
object
required

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