Skip to main content
GET
List the sold listings of a place with the deed that matched

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, address with zip, 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 address, 0.25 to 20 (default 1).

Required range: 0.25 <= x <= 20
address
string

A street line, with zip: the API resolves it to a parcel and searches the radius around it. For example 7522 E Cholla St with zip 85254.

Required string length: 3 - 200
zip
string[]

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

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

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

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
from
string<date>

Keep the listings sold on or after this date, YYYY-MM-DD. Default: 12 months before the newest listing data end of the served states.

to
string<date>

Keep the listings sold on or before this date, YYYY-MM-DD.

sort
enum<string>

The row order. sold_desc puts the newest sale first. distance puts the nearest first and needs a point. price_desc and price_asc order on the sale price, unpriced rows last. The default is sold_desc. Every sort breaks a tie on the listing id.

Available options:
sold_desc,
distance,
price_desc,
price_asc

Response

The sold listings of the place, newest sale first by default, one page.

The sold listings of the place, newest sale 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.