Skip to main content
GET
List the purchases of one organization of the dataset
This route serves the dataset under /v3/orgs/{id}/deals. See The dataset for the tier rules. Each row carries parcel, the place and the four home facts of the parcel under the listed-address rule. It is the same block as the rows of GET /v3/deals. Send lat and lng to get distance_miles on each row, and sort=distance to put the nearest parcel first. Without a point the order is the newest deed first and distance_miles is null.

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.

Path Parameters

id
string
required

The organization id, as a search hit or a deal row carries it.

Query Parameters

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.

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 the state of the organization has no marketplace match table.

Available options:
true,
false
lat
number

Point latitude, with lng: the reference point of distance_miles and of sort=distance. No radius: the rows stay the rows of the organization.

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

Point longitude, with lat.

Required range: -180 <= x <= 180
sort
enum<string>

The row order. sale_date_desc puts the newest deed first, an undated deed last. distance puts the nearest parcel first, a row with no place last, and needs lat and lng. The default is sale_date_desc. Every sort breaks a tie on the deal id.

Available options:
sale_date_desc,
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 purchases of the organization, newest first, an undated deed last and the deal id as the tie-break, one page. With lat and lng the nearest first when sort is distance.

The purchases of the organization, newest first, an undated deed last and the deal id as the tie-break, one page. With lat and lng the nearest first when sort is distance.

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.