List every record that names one person of the dataset
curl --request GET \
--url https://api.investorlift.com/v3/people/{id}/timeline \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/people/{id}/timeline', 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}/timeline"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-10-01",
"amount": null,
"record_id": "3e9eb0f98c93d9a6dd6f09249f1cc77e",
"property_id": "af3af85f9f21671a0c7b7728a6faade3",
"parcel": {
"line": null,
"unit": null,
"city": "Phoenix",
"zip": "85031",
"county_fips": "04013",
"apn": null,
"latitude": 33.499313,
"longitude": -112.180484,
"address_held_back": "listed_on_investorlift",
"location_radius_m": 1200,
"bedrooms": 3,
"bathrooms": 2,
"living_area_sqft": 1293,
"year_built": 1957
},
"marketplace": null,
"other": {
"kind": "agent",
"id": "AZ:agt:035c981692e5",
"name": null,
"from_registry": null,
"company_like": null
},
"n_other": 1,
"via": "AZ:L09606353",
"via_kind": "company",
"proof": "direct"
},
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-09-19",
"amount": null,
"record_id": "2604c9299a12fcf69a6bc2f36cb219f1",
"property_id": "257da807820caace20677071e9f0deac",
"parcel": {
"line": null,
"unit": null,
"city": "Peoria",
"zip": "85345",
"county_fips": "04013",
"apn": null,
"latitude": 33.579483,
"longitude": -112.218947,
"address_held_back": "listed_on_investorlift",
"location_radius_m": 1200,
"bedrooms": 3,
"bathrooms": 1,
"living_area_sqft": 928,
"year_built": 1961
},
"marketplace": null,
"other": null,
"n_other": 0,
"via": "AZ:L09606353",
"via_kind": "company",
"proof": "direct"
},
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-09-16",
"amount": null,
"record_id": "c45c2826a89caabf5f317c3c872f0ecd",
"property_id": "7fa9c87c256e6e7f594db268c67e7c51",
"parcel": {
"line": "6014 W Avalon Dr",
"unit": null,
"city": "Phoenix",
"zip": "85033",
"county_fips": "04013",
"apn": "103-45-032",
"latitude": 33.483541,
"longitude": -112.188761,
"address_held_back": null,
"location_radius_m": null,
"bedrooms": 4,
"bathrooms": 2,
"living_area_sqft": 1665,
"year_built": 1960
},
"marketplace": null,
"other": {
"kind": "agent",
"id": "AZ:agt:0cfd14f8ee8f",
"name": null,
"from_registry": null,
"company_like": null
},
"n_other": 1,
"via": "AZ:L12070783",
"via_kind": "company",
"proof": "direct"
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8QVoxNzkyNDQ5MzYyLUNBMTc5MDIxNTE5MC1GTDE3OTAyNjI2ODItVFgxNzkwMjQ4MjEzIiwicSI6ImM5NGM3MTRmNjYxOWExODk4ZTk5YWVlZDAxZTFlOGE1OGRkYjMwNjhiZjVlZDkzZDUzZmRlMDMyYzc2Y2U5ZmUiLCJrIjpbIjIwMjYtMDktMTYiLCJsaXN0aW5nIiwiYzQ1YzI4MjZhODljYWFiZjVmMzE3YzNjODcyZjBlY2QiLCI4NjE5YzhhNzg3MGUyZTZhNjE4ZDQ4ODM0YjE0OWFiYiIsImhvbGRlciJdfQ",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-10-21T05:27:18.402Z",
"resolved_from": [
"AZ:person:0cfd14f8ee8f"
],
"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-10-19T22:34:59.714Z",
"published_at": "2026-10-20T00:16:56.637Z",
"run_id": 1792449362,
"financing_as_of": "2026-06-25",
"recordings_through": "2026-06-11",
"financing_source": "replay_887",
"str_as_of": "2026-10-18"
},
{
"state": "CA",
"build_id": null,
"built_at": "2026-09-24T01:58:30.453Z",
"published_at": "2026-09-24T03:15:56.838Z",
"run_id": 1790215190,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "FL",
"build_id": "0e5fa9bc",
"built_at": "2026-09-24T15:08:23.506Z",
"published_at": "2026-09-24T18:59:42.805Z",
"run_id": 1790262682,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "TX",
"build_id": "775ed08d",
"built_at": "2026-09-24T11:08:10.587Z",
"published_at": "2026-09-24T13:16:03.157Z",
"run_id": 1790248213,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
}
]
}
}
}The dataset (/v3)
List every record that names one person of the dataset
Every record of the ledger of the person, its own and those of its companies, newest first, one page.
GET
/
v3
/
people
/
{id}
/
timeline
List every record that names one person of the dataset
curl --request GET \
--url https://api.investorlift.com/v3/people/{id}/timeline \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/people/{id}/timeline', 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}/timeline"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-10-01",
"amount": null,
"record_id": "3e9eb0f98c93d9a6dd6f09249f1cc77e",
"property_id": "af3af85f9f21671a0c7b7728a6faade3",
"parcel": {
"line": null,
"unit": null,
"city": "Phoenix",
"zip": "85031",
"county_fips": "04013",
"apn": null,
"latitude": 33.499313,
"longitude": -112.180484,
"address_held_back": "listed_on_investorlift",
"location_radius_m": 1200,
"bedrooms": 3,
"bathrooms": 2,
"living_area_sqft": 1293,
"year_built": 1957
},
"marketplace": null,
"other": {
"kind": "agent",
"id": "AZ:agt:035c981692e5",
"name": null,
"from_registry": null,
"company_like": null
},
"n_other": 1,
"via": "AZ:L09606353",
"via_kind": "company",
"proof": "direct"
},
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-09-19",
"amount": null,
"record_id": "2604c9299a12fcf69a6bc2f36cb219f1",
"property_id": "257da807820caace20677071e9f0deac",
"parcel": {
"line": null,
"unit": null,
"city": "Peoria",
"zip": "85345",
"county_fips": "04013",
"apn": null,
"latitude": 33.579483,
"longitude": -112.218947,
"address_held_back": "listed_on_investorlift",
"location_radius_m": 1200,
"bedrooms": 3,
"bathrooms": 1,
"living_area_sqft": 928,
"year_built": 1961
},
"marketplace": null,
"other": null,
"n_other": 0,
"via": "AZ:L09606353",
"via_kind": "company",
"proof": "direct"
},
{
"record_kind": "listing",
"role": "holder",
"observed_on": "2026-09-16",
"amount": null,
"record_id": "c45c2826a89caabf5f317c3c872f0ecd",
"property_id": "7fa9c87c256e6e7f594db268c67e7c51",
"parcel": {
"line": "6014 W Avalon Dr",
"unit": null,
"city": "Phoenix",
"zip": "85033",
"county_fips": "04013",
"apn": "103-45-032",
"latitude": 33.483541,
"longitude": -112.188761,
"address_held_back": null,
"location_radius_m": null,
"bedrooms": 4,
"bathrooms": 2,
"living_area_sqft": 1665,
"year_built": 1960
},
"marketplace": null,
"other": {
"kind": "agent",
"id": "AZ:agt:0cfd14f8ee8f",
"name": null,
"from_registry": null,
"company_like": null
},
"n_other": 1,
"via": "AZ:L12070783",
"via_kind": "company",
"proof": "direct"
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8QVoxNzkyNDQ5MzYyLUNBMTc5MDIxNTE5MC1GTDE3OTAyNjI2ODItVFgxNzkwMjQ4MjEzIiwicSI6ImM5NGM3MTRmNjYxOWExODk4ZTk5YWVlZDAxZTFlOGE1OGRkYjMwNjhiZjVlZDkzZDUzZmRlMDMyYzc2Y2U5ZmUiLCJrIjpbIjIwMjYtMDktMTYiLCJsaXN0aW5nIiwiYzQ1YzI4MjZhODljYWFiZjVmMzE3YzNjODcyZjBlY2QiLCI4NjE5YzhhNzg3MGUyZTZhNjE4ZDQ4ODM0YjE0OWFiYiIsImhvbGRlciJdfQ",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-10-21T05:27:18.402Z",
"resolved_from": [
"AZ:person:0cfd14f8ee8f"
],
"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-10-19T22:34:59.714Z",
"published_at": "2026-10-20T00:16:56.637Z",
"run_id": 1792449362,
"financing_as_of": "2026-06-25",
"recordings_through": "2026-06-11",
"financing_source": "replay_887",
"str_as_of": "2026-10-18"
},
{
"state": "CA",
"build_id": null,
"built_at": "2026-09-24T01:58:30.453Z",
"published_at": "2026-09-24T03:15:56.838Z",
"run_id": 1790215190,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "FL",
"build_id": "0e5fa9bc",
"built_at": "2026-09-24T15:08:23.506Z",
"published_at": "2026-09-24T18:59:42.805Z",
"run_id": 1790262682,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "TX",
"build_id": "775ed08d",
"built_at": "2026-09-24T11:08:10.587Z",
"published_at": "2026-09-24T13:16:03.157Z",
"run_id": 1790248213,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
}
]
}
}
}This route serves the dataset under
/v3/people/{id}/timeline. See The dataset for the tier rules. A row is one record under one role, with the date, the amount, the parcel and the other side.
The route reads the ledger of the person when the build row of its state counts one. The ledger holds the records of each sighting of the person and of each company it files on as a principal. Each row then names its via, the sighting or the company that carries it, and its proof. A state with no ledger serves the listings of the agent of the person and the deeds of its deed name, and via is null.
Every row carries marketplace, the key of the listing of the Investorlift marketplaces the record is or closed. The key is listing_id, source and source_listing_id. A marketplace_listing row carries its own listing. A deal row carries the listing its deed closed, the first by publication date when it closed several. Every other row carries null.
The parcel of a row carries apn and county_fips. A parcel listed on the marketplace now carries address_held_back and no apn, no street and no exact point. The listed-address rule hides each fact that finds the address in one lookup.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, or the id of a sighting of the person.
Query Parameters
Keep the records of one kind.
Available options:
deal, loan, listing, marketplace_listing, filing, holding Keep the records where the subject has this role.
Available options:
buyer, seller, lender, borrower, holder, listing_agent, wholesaler, closing_buyer, principal, statutory_agent, owner, entity Keep records observed on or after this date, YYYY-MM-DD. An undated record leaves the page.
Keep records observed on or before this date, YYYY-MM-DD. An undated record leaves the page.
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 records of the person. meta.resolved_from lists the ids that redirected here.
The records of the person. meta.resolved_from lists the ids that redirected here.
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 /v3 family: when the API produced it, and the publishes behind the rows.
Show child attributes
Show child attributes
Was this page helpful?