List the listings of the agent of one person of the lean set
curl --request GET \
--url https://api.investorlift.com/v3/people/{id}/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/people/{id}/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/people/{id}/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"mention_id": "c83931973e1adf3c14c1ad5a704f5097",
"listing_id": "386938926c3d4ebd513c918c49cb0318",
"property_id": "e62002ce553085933b9913984ad447dc",
"is_current": true,
"seen_from": "2025-09-04",
"seen_to": null,
"listed_on": "2022-05-14",
"status": "SOLD",
"sold_on": "2022-06-17",
"zip": "85029",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": "West USA Realty",
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_basis": "deed",
"self_listing": false,
"buyer_org_ids": [
"AZ:23331261"
],
"buyer_rule": "purchase_after_sale",
"buyer_deed_date": "2022-06-14",
"buyer_flagged": true,
"price_match": true
},
{
"mention_id": "8a21ab5fbacc6692bca92396edfc27b6",
"listing_id": "1c63d9ce42b6958bfc76eee0fe6210dd",
"property_id": "65abd1f20306b37a7968ee4a3e33131c",
"is_current": true,
"seen_from": "2025-08-14",
"seen_to": null,
"listed_on": "2020-12-22",
"status": "SOLD",
"sold_on": "2021-02-19",
"zip": "85051",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": "West USA Realty",
"holder_org_ids": [
"AZ:L11962260"
],
"n_holder_orgs": 1,
"holder_basis": "deed",
"self_listing": true,
"buyer_org_ids": [],
"buyer_rule": "purchase_after_sale",
"buyer_deed_date": "2021-01-31",
"buyer_flagged": false,
"price_match": true
},
{
"mention_id": "36f896c86074d8fbcf8c87d042da04bb",
"listing_id": "4912ea7c86089c4790c56054baba7186",
"property_id": "81090d0b2400501cca10a9f6d1764286",
"is_current": true,
"seen_from": "2025-09-04",
"seen_to": null,
"listed_on": "2020-08-19",
"status": "OFF_MARKET",
"sold_on": null,
"zip": "85029",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": null,
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_basis": "deed",
"self_listing": false,
"buyer_org_ids": [],
"buyer_rule": null,
"buyer_deed_date": null,
"buyer_flagged": null,
"price_match": null
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTAxMjM3NTItVFgxNzkwMTMwMTc4IiwicSI6IjgwZDk3M2ViZWVlOGQxYzViZjZlNTEwYzhkOGM1MDYzNDZlYTEzN2U1NjcyMDFiMzFiOGYyNjdhYThkZjY2MDEiLCJrIjpbIjIwMjAtMDgtMTkiLCIzNmY4OTZjODYwNzRkOGZiY2Y4Yzg3ZDA0MmRhMDRiYiJdfQ",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-09-23T03:14:40.792Z",
"coverage": [],
"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",
"build": {
"states": [
{
"state": "AZ",
"build_id": null,
"built_at": "2026-09-22T13:41:32.949Z",
"published_at": "2026-09-23T01:02:16.717Z",
"run_id": 1790123752
},
{
"state": "TX",
"build_id": null,
"built_at": "2026-09-22T16:11:23.904Z",
"published_at": "2026-09-23T03:14:20.380Z",
"run_id": 1790130178
}
]
}
}
}Lean set (/v3)
List the listings of the agent of one person of the lean set
List the listings of the agent of one person of the lean set.
GET
/
v3
/
people
/
{id}
/
listings
List the listings of the agent of one person of the lean set
curl --request GET \
--url https://api.investorlift.com/v3/people/{id}/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/people/{id}/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/people/{id}/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"mention_id": "c83931973e1adf3c14c1ad5a704f5097",
"listing_id": "386938926c3d4ebd513c918c49cb0318",
"property_id": "e62002ce553085933b9913984ad447dc",
"is_current": true,
"seen_from": "2025-09-04",
"seen_to": null,
"listed_on": "2022-05-14",
"status": "SOLD",
"sold_on": "2022-06-17",
"zip": "85029",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": "West USA Realty",
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_basis": "deed",
"self_listing": false,
"buyer_org_ids": [
"AZ:23331261"
],
"buyer_rule": "purchase_after_sale",
"buyer_deed_date": "2022-06-14",
"buyer_flagged": true,
"price_match": true
},
{
"mention_id": "8a21ab5fbacc6692bca92396edfc27b6",
"listing_id": "1c63d9ce42b6958bfc76eee0fe6210dd",
"property_id": "65abd1f20306b37a7968ee4a3e33131c",
"is_current": true,
"seen_from": "2025-08-14",
"seen_to": null,
"listed_on": "2020-12-22",
"status": "SOLD",
"sold_on": "2021-02-19",
"zip": "85051",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": "West USA Realty",
"holder_org_ids": [
"AZ:L11962260"
],
"n_holder_orgs": 1,
"holder_basis": "deed",
"self_listing": true,
"buyer_org_ids": [],
"buyer_rule": "purchase_after_sale",
"buyer_deed_date": "2021-01-31",
"buyer_flagged": false,
"price_match": true
},
{
"mention_id": "36f896c86074d8fbcf8c87d042da04bb",
"listing_id": "4912ea7c86089c4790c56054baba7186",
"property_id": "81090d0b2400501cca10a9f6d1764286",
"is_current": true,
"seen_from": "2025-09-04",
"seen_to": null,
"listed_on": "2020-08-19",
"status": "OFF_MARKET",
"sold_on": null,
"zip": "85029",
"county_fips": "04013",
"roles": "Listing Agent",
"is_team": false,
"brokerage_name": "West USA Realty",
"office_name": null,
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_basis": "deed",
"self_listing": false,
"buyer_org_ids": [],
"buyer_rule": null,
"buyer_deed_date": null,
"buyer_flagged": null,
"price_match": null
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTAxMjM3NTItVFgxNzkwMTMwMTc4IiwicSI6IjgwZDk3M2ViZWVlOGQxYzViZjZlNTEwYzhkOGM1MDYzNDZlYTEzN2U1NjcyMDFiMzFiOGYyNjdhYThkZjY2MDEiLCJrIjpbIjIwMjAtMDgtMTkiLCIzNmY4OTZjODYwNzRkOGZiY2Y4Yzg3ZDA0MmRhMDRiYiJdfQ",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-09-23T03:14:40.792Z",
"coverage": [],
"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",
"build": {
"states": [
{
"state": "AZ",
"build_id": null,
"built_at": "2026-09-22T13:41:32.949Z",
"published_at": "2026-09-23T01:02:16.717Z",
"run_id": 1790123752
},
{
"state": "TX",
"build_id": null,
"built_at": "2026-09-22T16:11:23.904Z",
"published_at": "2026-09-23T03:14:20.380Z",
"run_id": 1790130178
}
]
}
}
}This route serves the lean set under
/v3/people/{id}/listings. See The lean dataset for the tier rules.Authorizations
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
The person id, as a search hit, an organization or a listing carries it.
Query Parameters
Keep these statuses of the listing (comma list or repeated key): ACTIVE, PENDING, SOLD, OFF_MARKET or another status of the build.
Minimum array length:
1Required string length:
1 - 20Keep the listings dated on or after this date, YYYY-MM-DD.
True includes every version the weekly cuts recorded, one row for each mention. Default false: the current version of each listing alone.
Available options:
true, false True keeps the self-listings alone: the agent is a person of the organization that held the parcel.
Available options:
true, false True keeps the listings whose deed after the sale was a flagged purchase.
Available options:
true, false Page size, 1-500 (default 100).
Required range:
1 <= x <= 500Opaque 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 - 4096Response
The listings of the agent of the person, newest first, an undated one last and the mention id as the tie-break, one page. Empty when the person is no agent.
The listings of the agent of the person, newest first, an undated one last and the mention id as the tie-break, one page. Empty when the person is no agent.
The rows of this page.
Show child attributes
Show child attributes
Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.
Show child attributes
Show child attributes
Response metadata of the lean family: when the API produced it, and the publishes behind the rows.
Show child attributes
Show child attributes
Was this page helpful?