Skip to main content
POST
Read the investor transactions of up to 500 parcels at once

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.

Body

application/json

The list form: up to 500 parcels and transactions in all, answered at once.

​
property_ids
string[]

The parcels to read, 32 hex characters each. A duplicate is answered once. The list form takes 500 parcels and transactions in all, the job form 10,000.

Maximum array length: 20000

An id of the deed cut: 32 hex characters.

Pattern: ^[0-9a-f]{32}$
​
transactions
object[]

The transactions to place: each a parcel id with a date, or a deal id. The parcel of a transaction joins the parcels of the request.

Maximum array length: 20000
​
since
string<date>

Keep the investor purchases dated on or after this day, YYYY-MM-DD. The set holds 20 deeds at most on a parcel, so an old purchase is absent anyway.

​
outcomes
enum<string>[]

Keep the investor purchases of these outcomes. The counts of the block and the role of a transaction still read every investor purchase.

Minimum array length: 1

The outcome of the investor purchase, one word over its resale and the data end of the state. quick_resale: the next priced deed of the parcel is 0 to 29 days after the purchase. flip: the next priced deed is 30 to 365 days after the purchase, both legs carry a price, and the resale price over the price minus one is 0.10 to 1.50. flip_window_other: the next priced deed is 30 to 365 days after the purchase, and the spread is outside that band or a leg carries no price. long_hold_sale: the next priced deed is more than 365 days after the purchase. held: no later priced deed by the data end, and the purchase is more than 365 days before the data end. open: no later priced deed by the data end, and the purchase is inside the 365 days before the data end, so the outcome is not known yet. The thresholds are the ones of the organization profile.

Available options:
quick_resale,
flip,
flip_window_other,
long_hold_sale,
held,
open
​
detail
boolean

True adds the blocks that cost a probe each: the track record of each buyer, the sellers, the buyers of the resale, the entry, the purchase loan, the exit and the owner. False, the default, answers the outcome, both legs, the flags and the investor by name and id, and reads null for the rest. The default is the fast shape.

Response

The investor transactions of the parcels of the request, one block each, in the order of first mention.

The investor transactions of the parcels of the request, one block each, in the order of first mention.

​
data
object[]
required

One block for each distinct parcel, in the order of first mention.

​
summary
object
required

The counts over the blocks of the answer.

​
meta
object
required

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