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 by id
One deal: the parcel, the dates and prices, the investor, the counterparties, and, on a confirmed current holding, the owner of record.
Use it for the card behind a table row or a map marker, and for deep links. To list deals around a location use /v1/deals.
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"
}
}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?