Get one deal by id
curl --request GET \
--url https://api.investorlift.com/v1/deals/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/deals/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/deals/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "deal_0057a742ff88160e961dfc73fbefb687",
"market": "phx",
"kind": "hold",
"deal_type": "HOLDING",
"deal_kind": "CURRENT_HOLDING",
"ownership_confirmed": true,
"buyer_status": "registered",
"buyer_exclusion": null,
"property": {
"id": "prop_e672d15ae9e8e7bdcbc15c3f1235d48a",
"market": "phx",
"apn": "501-44-328",
"apn_norm": "50144328",
"county_fips": "04013",
"address_short": "12105 N 129th Dr",
"street_no_unit": "12105 N 129th Dr",
"unit": null,
"city": "EL MIRAGE",
"state": "AZ",
"zip": "85335",
"latitude": 33.593424,
"longitude": -112.337933,
"segment": "SFR",
"bedrooms": null,
"bathrooms": 2,
"sqft": 1090,
"year_built": 2001,
"pool": null
},
"distance_miles": null,
"bought_on": "2026-08-05",
"date_quality": "deed",
"held_since_source": "DEED_ACQUISITION",
"bought_price": 205000,
"sold_on": null,
"sold_price": null,
"hold_days": null,
"gross_profit": null,
"spread_ratio": null,
"price_quality": "BUY_ONLY",
"days_held_to_data_end": 7,
"sold_to_wholesaler": null,
"round_trip": null,
"is_purchase_event": true,
"n_parcels_in_event": 1,
"bought_from_wholesaler": false,
"bought_from_wholesaler_via": null,
"wholesaler_investor_id": null,
"bought_from_investor": false,
"bought_distressed": false,
"bought_auction_kind": null,
"holding_kind": "OWNER_OCCUPIED",
"acquisition_kind": "PURCHASE",
"investor": {
"id": "inv_abaf618f44a3",
"market": "phx",
"name": "ZAK VENTURES LLC",
"display_name": "ZAK VENTURES LLC",
"state": "AZ",
"kind": "LANDLORD",
"confidence": "STRONG",
"scale": "large",
"institutional": false,
"is_public": false,
"last_bought_on": "2026-08-05",
"n_deals": 775,
"buyer_status": "registered"
},
"seller": {
"id": null,
"name": null,
"display_name": null,
"kind": "PERSON",
"kinds": null
},
"end_buyer": {
"id": null,
"name": null,
"display_name": null,
"kind": null,
"kinds": null
},
"owner": {
"names": null,
"name_order": "given_first",
"kind": "ENTITY",
"is_trust": false,
"is_public": false,
"owner_occupied": true,
"absentee": false,
"mailing": null,
"rental_registered": false,
"held_since": "2026-08-05",
"months_held": 0.2,
"permits_last_24m": 0
},
"listing": null,
"short_term_rental": null,
"wholesale_listing": null,
"financing": {
"purchase_loan_status": "NOT_MEASURED",
"purchase_loan": null,
"secondary_loans_n": null,
"link_window": null,
"outcome": null,
"as_of": "2026-06-25",
"dated": true
}
},
"meta": {
"generated_at": "2026-09-03T21:40:00.000Z",
"coverage": [
{
"market": "phx",
"state": "AZ",
"counties": [
{
"fips": "04013",
"name": "Maricopa",
"data_end": "2026-08-12"
},
{
"fips": "04021",
"name": "Pinal",
"data_end": "2026-08-06"
}
],
"bbox": [
-113.332773,
32.46915,
-110.455491,
33.999503
],
"data_end": "2026-08-12",
"build_run_id": 1,
"registry_run": 7,
"registry_version": "v4-metro-review-fixes",
"dataset_version": 1788469819,
"loaded_at": "2026-09-03T21:10:18.682Z",
"metro_buy_to_resale_ratio": 0.7192,
"universe_kind": "metro",
"universe_zips": null,
"point_tolerance_miles": 20,
"n_parcels": null,
"listings_data_end": "2026-08-31",
"agents_data_end": "2026-08-31",
"wholesale_as_of": "2026-09-09",
"str_as_of": null,
"str": null,
"auction_counted": true,
"parcel_as_of": null,
"address_as_of": null,
"parcel": null,
"lenders": null
}
],
"terms": "Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms"
}
}Deals
Get one deal
Everything the API knows about one deal, with the owner to contact on a confirmed holding.
GET
/
v1
/
deals
/
{id}
Get one deal by id
curl --request GET \
--url https://api.investorlift.com/v1/deals/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/deals/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/deals/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "deal_0057a742ff88160e961dfc73fbefb687",
"market": "phx",
"kind": "hold",
"deal_type": "HOLDING",
"deal_kind": "CURRENT_HOLDING",
"ownership_confirmed": true,
"buyer_status": "registered",
"buyer_exclusion": null,
"property": {
"id": "prop_e672d15ae9e8e7bdcbc15c3f1235d48a",
"market": "phx",
"apn": "501-44-328",
"apn_norm": "50144328",
"county_fips": "04013",
"address_short": "12105 N 129th Dr",
"street_no_unit": "12105 N 129th Dr",
"unit": null,
"city": "EL MIRAGE",
"state": "AZ",
"zip": "85335",
"latitude": 33.593424,
"longitude": -112.337933,
"segment": "SFR",
"bedrooms": null,
"bathrooms": 2,
"sqft": 1090,
"year_built": 2001,
"pool": null
},
"distance_miles": null,
"bought_on": "2026-08-05",
"date_quality": "deed",
"held_since_source": "DEED_ACQUISITION",
"bought_price": 205000,
"sold_on": null,
"sold_price": null,
"hold_days": null,
"gross_profit": null,
"spread_ratio": null,
"price_quality": "BUY_ONLY",
"days_held_to_data_end": 7,
"sold_to_wholesaler": null,
"round_trip": null,
"is_purchase_event": true,
"n_parcels_in_event": 1,
"bought_from_wholesaler": false,
"bought_from_wholesaler_via": null,
"wholesaler_investor_id": null,
"bought_from_investor": false,
"bought_distressed": false,
"bought_auction_kind": null,
"holding_kind": "OWNER_OCCUPIED",
"acquisition_kind": "PURCHASE",
"investor": {
"id": "inv_abaf618f44a3",
"market": "phx",
"name": "ZAK VENTURES LLC",
"display_name": "ZAK VENTURES LLC",
"state": "AZ",
"kind": "LANDLORD",
"confidence": "STRONG",
"scale": "large",
"institutional": false,
"is_public": false,
"last_bought_on": "2026-08-05",
"n_deals": 775,
"buyer_status": "registered"
},
"seller": {
"id": null,
"name": null,
"display_name": null,
"kind": "PERSON",
"kinds": null
},
"end_buyer": {
"id": null,
"name": null,
"display_name": null,
"kind": null,
"kinds": null
},
"owner": {
"names": null,
"name_order": "given_first",
"kind": "ENTITY",
"is_trust": false,
"is_public": false,
"owner_occupied": true,
"absentee": false,
"mailing": null,
"rental_registered": false,
"held_since": "2026-08-05",
"months_held": 0.2,
"permits_last_24m": 0
},
"listing": null,
"short_term_rental": null,
"wholesale_listing": null,
"financing": {
"purchase_loan_status": "NOT_MEASURED",
"purchase_loan": null,
"secondary_loans_n": null,
"link_window": null,
"outcome": null,
"as_of": "2026-06-25",
"dated": true
}
},
"meta": {
"generated_at": "2026-09-03T21:40:00.000Z",
"coverage": [
{
"market": "phx",
"state": "AZ",
"counties": [
{
"fips": "04013",
"name": "Maricopa",
"data_end": "2026-08-12"
},
{
"fips": "04021",
"name": "Pinal",
"data_end": "2026-08-06"
}
],
"bbox": [
-113.332773,
32.46915,
-110.455491,
33.999503
],
"data_end": "2026-08-12",
"build_run_id": 1,
"registry_run": 7,
"registry_version": "v4-metro-review-fixes",
"dataset_version": 1788469819,
"loaded_at": "2026-09-03T21:10:18.682Z",
"metro_buy_to_resale_ratio": 0.7192,
"universe_kind": "metro",
"universe_zips": null,
"point_tolerance_miles": 20,
"n_parcels": null,
"listings_data_end": "2026-08-31",
"agents_data_end": "2026-08-31",
"wholesale_as_of": "2026-09-09",
"str_as_of": null,
"str": null,
"auction_counted": true,
"parcel_as_of": null,
"address_as_of": null,
"parcel": null,
"lenders": null
}
],
"terms": "Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms"
}
}One Deal: the parcel, the dates and prices, the investor and the counterparties. For a
confirmed current holding, it also carries the owner to contact.
Use it when
Your user clicks a row of the table or a marker on the map, opens a deep link, or exports a selection. To list deals around a location, useGET /v1/deals.
Read the response
- The row has the same shape as a
/v1/dealsrow.distance_milesis null because the request has no reference point. owneris present only whendeal_typeisHOLDINGandownership_confirmedis true. For a purchase with no resale and no ownership confirmation yet (deal_type: "PURCHASE"), the API returnsowner: null. To contact that investor, use the investor profile.n_parcels_in_eventabove 1 means a bulk buy. The investor bought that many parcels on the same day, and this parcel is one of them.owner.kindis the kind of the name on the county roll. For an entity,owner.names[].surnamecarries the whole entity name andgivenis null.financing(since 0.16.0) says if a purchase loan appears on record in the 45 days frombought_on. It also says which lender made the loan, the loan against the price and the outcome of the loan.NONE_CAPTUREDis not evidence of a cash purchase. The Deal object has the detail.
Gotchas
- The id must carry the
deal_prefix. For any other shape, the API answers400 invalid_id. For an id that no longer exists, the API answers404 not_found. A data refresh retires a purchase row when its resale deed arrives. - This route does not hide institutional and public investors. The API always returns a deal reached by id.
- This host does not serve
owner.namesandowner.mailing. They come back null withcontact_redacted: true.
Authorizations
API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.
Path Parameters
The deal id as the API serves it, deal_ followed by 32 hex characters, for example deal_5d1b2c3d4e5f60718293a4b5c6d7e8f9. The prefix is part of the id. The API answers 400 invalid_id to any other shape.
Response
The deal, in the same shape as a /v1/deals row, with distance_miles null.
The deal, in the same shape as a /v1/deals row, with distance_miles null.
One deal: what occurred on a parcel, when, for how much, who took part and how the investor financed it. Every field is present on every row. Fields that apply only to holdings are null elsewhere.
Show child attributes
Show child attributes
Response metadata: when the API produced it, which markets it covers, and how fresh they are.
Show child attributes
Show child attributes
Was this page helpful?