curl --request GET \
--url https://api.investorlift.com/v1/agents/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/agents/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/agents/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "agt_fdfd4a0f8bae",
"market": "phx",
"kind": "PERSON",
"name": null,
"license_state": null,
"license_number": null,
"identity_basis": "LICENSE_NAME",
"license_candidates": 1,
"current_brokerage": "Delex Realty",
"n_listings": 105,
"n_active": 3,
"last_listed_on": "2026-07-24",
"n_investor_links": 2,
"match": "exact",
"similarity": null
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 1,
"capped": false
},
"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"
}
}Find a listing agent by name or licence number
Finds a listing agent by name, in either order or in part, or by state licence number. Returns the stable agent id to open the profile with.
From a listing you already have, skip the search: the id is on the listing block as listing.agents[].agent_id. The API returns at most 50 hits, ranked by match quality, with no cursor. page.capped says when more matched.
curl --request GET \
--url https://api.investorlift.com/v1/agents/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v1/agents/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v1/agents/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "agt_fdfd4a0f8bae",
"market": "phx",
"kind": "PERSON",
"name": null,
"license_state": null,
"license_number": null,
"identity_basis": "LICENSE_NAME",
"license_candidates": 1,
"current_brokerage": "Delex Realty",
"n_listings": 105,
"n_active": 3,
"last_listed_on": "2026-07-24",
"n_investor_links": 2,
"match": "exact",
"similarity": null
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 1,
"capped": false
},
"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"
}
}Authorizations
API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.
Query Parameters
The agent to look for: a name in either order ("Dana Rivera" or "Rivera Dana"), part of a name, or a state licence number. An Arizona licence number is SA or BR plus nine digits, for example "SA555000123". Case and punctuation do not matter. A name needs at least 3 letters after normalisation. The API answers 400 to a shorter name.
1 - 200Market code, for example phx. The loaded markets are in meta.coverage[]. It narrows the search to that market. The API answers 400 when that market is not loaded, 422 agents_unavailable when the market has no published agent registry. Without it the API searches every loaded market with a registry and each hit carries its market.
1 - 16Agents to return, 1 to 50 (default 10).
1 <= x <= 50Response
Agents whose name or licence number matches the query, best match first. page.next_cursor is always null and page.capped is true when the API cut the page at limit.
Agents whose name or licence number matches the query, best match first. page.next_cursor is always null and page.capped is true when the API cut the page at limit.
The hits, best match first.
Show child attributes
Show child attributes
The page block of a name search: no cursor, the limit applied, the hits returned and if the API cut the page at the limit.
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?