Get the profile of one listing agent
curl --request GET \
--url https://api.investorlift.com/v1/agents/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/agents/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "agt_fdfd4a0f8bae",
"market": "phx",
"kind": "PERSON",
"name": null,
"name_variants": null,
"n_name_variants": 1,
"license": null,
"identity_basis": "LICENSE_NAME",
"license_candidates": 1,
"brokerages": [
"Delex Realty",
"Opendoor Brokerage LLC",
"DeLex Realty LLC",
"Clients First Realty LLC"
],
"current_brokerage": "Delex Realty",
"listings": {
"n_total": 105,
"n_active": 3,
"n_pending": 0,
"n_on_market": 3,
"n_sold": 66,
"n_off_market": 36,
"first_listed_on": "2011-01-15",
"last_listed_on": "2026-07-24",
"n_listed_12m": 14,
"n_sold_12m": 1,
"median_list_price": 449950,
"median_sold_price": 278000,
"by_year": [
{
"year": 2011,
"n_listed": 1,
"n_sold": 1,
"n_self": 0
},
{
"year": 2012,
"n_listed": 2,
"n_sold": 2,
"n_self": 2
},
{
"year": 2013,
"n_listed": 1,
"n_sold": 1,
"n_self": 1
},
{
"year": 2015,
"n_listed": 2,
"n_sold": 2,
"n_self": 1
},
{
"year": 2016,
"n_listed": 2,
"n_sold": 2,
"n_self": 0
},
{
"year": 2017,
"n_listed": 11,
"n_sold": 8,
"n_self": 4
},
{
"year": 2018,
"n_listed": 17,
"n_sold": 11,
"n_self": 5
},
{
"year": 2019,
"n_listed": 10,
"n_sold": 7,
"n_self": 2
},
{
"year": 2020,
"n_listed": 7,
"n_sold": 4,
"n_self": 3
},
{
"year": 2021,
"n_listed": 5,
"n_sold": 5,
"n_self": 0
},
{
"year": 2022,
"n_listed": 12,
"n_sold": 6,
"n_self": 5
},
{
"year": 2023,
"n_listed": 5,
"n_sold": 5,
"n_self": 0
},
{
"year": 2024,
"n_listed": 11,
"n_sold": 9,
"n_self": 2
},
{
"year": 2025,
"n_listed": 11,
"n_sold": 2,
"n_self": 7
},
{
"year": 2026,
"n_listed": 8,
"n_sold": 1,
"n_self": 6
}
]
},
"n_self_listings": 38,
"investor_links": [
{
"investor_id": "inv_0a20a550f33b",
"investor_name": "ZAK VENTURES LLC",
"investor_display_name": "ZAK VENTURES LLC",
"kind": "LANDLORD",
"member_name": null,
"link_basis": "SELF_LISTING",
"confidence": "HIGH",
"n_self_listings": 38
},
{
"investor_id": "inv_0a20a550f33b",
"investor_name": "ZAK VENTURES LLC",
"investor_display_name": "ZAK VENTURES LLC",
"kind": "LANDLORD",
"member_name": null,
"link_basis": "SELF_LISTING",
"confidence": "HIGH",
"n_self_listings": 38
}
],
"has_investor_link": true
},
"meta": {
"generated_at": "2026-09-09T12:00: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": 8,
"registry_version": "v4-metro-review-fixes",
"dataset_version": 1788982375,
"loaded_at": "2026-09-09T19:32:54.902Z",
"metro_buy_to_resale_ratio": 0.7192,
"universe_kind": "metro",
"universe_zips": null,
"point_tolerance_miles": 20,
"n_parcels": 1836307,
"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"
}
}Listing agents
Get one listing agent
Every spelling, the licence the registry keyed them on, their brokerages, their counts, and the investors they belong to.
GET
/
v1
/
agents
/
{id}
Get the profile of one listing agent
curl --request GET \
--url https://api.investorlift.com/v1/agents/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/agents/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "agt_fdfd4a0f8bae",
"market": "phx",
"kind": "PERSON",
"name": null,
"name_variants": null,
"n_name_variants": 1,
"license": null,
"identity_basis": "LICENSE_NAME",
"license_candidates": 1,
"brokerages": [
"Delex Realty",
"Opendoor Brokerage LLC",
"DeLex Realty LLC",
"Clients First Realty LLC"
],
"current_brokerage": "Delex Realty",
"listings": {
"n_total": 105,
"n_active": 3,
"n_pending": 0,
"n_on_market": 3,
"n_sold": 66,
"n_off_market": 36,
"first_listed_on": "2011-01-15",
"last_listed_on": "2026-07-24",
"n_listed_12m": 14,
"n_sold_12m": 1,
"median_list_price": 449950,
"median_sold_price": 278000,
"by_year": [
{
"year": 2011,
"n_listed": 1,
"n_sold": 1,
"n_self": 0
},
{
"year": 2012,
"n_listed": 2,
"n_sold": 2,
"n_self": 2
},
{
"year": 2013,
"n_listed": 1,
"n_sold": 1,
"n_self": 1
},
{
"year": 2015,
"n_listed": 2,
"n_sold": 2,
"n_self": 1
},
{
"year": 2016,
"n_listed": 2,
"n_sold": 2,
"n_self": 0
},
{
"year": 2017,
"n_listed": 11,
"n_sold": 8,
"n_self": 4
},
{
"year": 2018,
"n_listed": 17,
"n_sold": 11,
"n_self": 5
},
{
"year": 2019,
"n_listed": 10,
"n_sold": 7,
"n_self": 2
},
{
"year": 2020,
"n_listed": 7,
"n_sold": 4,
"n_self": 3
},
{
"year": 2021,
"n_listed": 5,
"n_sold": 5,
"n_self": 0
},
{
"year": 2022,
"n_listed": 12,
"n_sold": 6,
"n_self": 5
},
{
"year": 2023,
"n_listed": 5,
"n_sold": 5,
"n_self": 0
},
{
"year": 2024,
"n_listed": 11,
"n_sold": 9,
"n_self": 2
},
{
"year": 2025,
"n_listed": 11,
"n_sold": 2,
"n_self": 7
},
{
"year": 2026,
"n_listed": 8,
"n_sold": 1,
"n_self": 6
}
]
},
"n_self_listings": 38,
"investor_links": [
{
"investor_id": "inv_0a20a550f33b",
"investor_name": "ZAK VENTURES LLC",
"investor_display_name": "ZAK VENTURES LLC",
"kind": "LANDLORD",
"member_name": null,
"link_basis": "SELF_LISTING",
"confidence": "HIGH",
"n_self_listings": 38
},
{
"investor_id": "inv_0a20a550f33b",
"investor_name": "ZAK VENTURES LLC",
"investor_display_name": "ZAK VENTURES LLC",
"kind": "LANDLORD",
"member_name": null,
"link_basis": "SELF_LISTING",
"confidence": "HIGH",
"n_self_listings": 38
}
],
"has_investor_link": true
},
"meta": {
"generated_at": "2026-09-09T12:00: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": 8,
"registry_version": "v4-metro-review-fixes",
"dataset_version": 1788982375,
"loaded_at": "2026-09-09T19:32:54.902Z",
"metro_buy_to_resale_ratio": 0.7192,
"universe_kind": "metro",
"universe_zips": null,
"point_tolerance_miles": 20,
"n_parcels": 1836307,
"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"
}
}Early access: while the developer tier is in beta, the API serves this route to Investorlift’s team and trusted partners. Investorlift will restrict the route further before it opens to every key.
Use it when
The agent drawer, opened from a listing’sagents[].agent_id, a search hit or an investor profile’s
agent_links[]. For their listings, use
GET /v1/agents/{id}/listings.
Read the response
identity_basisis how the registry decided who this is. For the fourLICENSE_values, the registry keyed the agent on the state licence roll. That roll is a public record that is stable across spellings and brokerages. ForCONTACT_CLUSTER,NAME_BROKERAGEandNAME_ONLY, the registry keyed the agent on the feed alone.license_candidatesof 2 or more means several licensees share the name and nothing told them apart. So the API serves no licence, and the rows can belong to more than one person.license.statusis the state’s status on the snapshot date: an agent with old listings can hold a lapsed licence.license.employeris the state roll’s brokerage, often not the one on the feed rows (current_brokerage).listingsis a lower bound. The feed keeps one listing per parcel, the latest, and names agents at full coverage only from about 2018. The API measures every window againstmeta.coverage[].listings_data_end, never today.investor_linksare the investors this agent is a person member of, HIGH confidence first, each with its ownconfidenceandn_self_listings. The profile’s ownn_self_listingscounts only the listings on parcels held by a HIGH-confidence link: their own inventory, told apart from clients’ listings.meta.resolved_fromis present when a registry run replaced the id you sent. Store the newid.
Gotchas
- This host does not serve
name,name_variants,license,contactandinvestor_links[].member_name. They are null, withcontact_redacted: true.licenseis also null when the registry matched no licence. - A retired id is
410 gonewithsuperseded_by: null: search by name instead. A merged id is not an error: you get the new profile withmeta.resolved_from. An id the API never issued is a 404. - Pass
marketwhen an id exists in more than one loaded market.400 market_requiredsays so. - For a market with no published agent registry, the API answers
422 agents_unavailable.
Authorizations
API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.
Path Parameters
Listing agent id, agt_ followed by 12 hex characters, for example agt_fdfd4a0f8bae. The API follows an old id from an earlier registry run to the current agent (meta.resolved_from). It answers 410 for a retired id.
Query Parameters
Market code, for example phx. The loaded markets are in meta.coverage[]. Send it only when the id exists in more than one loaded market. 400 market_required says so, and a licence-keyed agent has the same id in every market where it lists. Otherwise the API uses the id's own market.
Required string length:
1 - 16Response
The agent profile. meta.resolved_from lists the old ids that redirected here.
The agent profile. meta.resolved_from lists the old ids that redirected here.
The profile of one listing agent: who they are, where they work, what they list, and which investors they belong to as a person. Who they are is the name spellings, the state licence the registry keyed them on and how sure that key is. Where they work is the brokerages, and what they list is the counts by status and year.
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?