Skip to main content
GET
List the sales of one organization of the dataset
This route serves the dataset under /v3/orgs/{id}/sales. 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 the deeds dated on or after this date, YYYY-MM-DD.

to
string<date>

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

flagged
enum<string>

True keeps the deeds the build flagged as investor purchases alone, false the others. Default: every deed the organization sold on.

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 deeds the organization sold on, 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 deeds the organization sold on, 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.