Find a listing agent by name or licence number
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"
}
}
Listing agents
Find a listing agent
Find a listing agent by name, in either order or in part, or by state licence number.
GET
/
v1
/
agents
/
search
Find a listing agent by name or licence number
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"
}
}
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
You build an agent typeahead. You have a name or a licence number and need the agent id.If you already have a listing, skip the search. The listing block already carries the agent’s id as
listing.agents[].agent_id.Read the response
match says how the API found the hit, best first:
match | How it matched |
|---|---|
license | The query is a licence number and equals one of the agent’s licence numbers. |
exact | The normalised query equals the name. |
tokens | Every word of the query appears in the name, in any order. |
trigram | Fuzzy, similarity 0.55 or more. The API tries it only when fewer than 10 agents matched otherwise. |
identity_basisandlicense_candidatessay how sure the registry is of who this is. The registry keys the fourLICENSE_values on the state roll.NAME_ONLYwithlicense_candidatesof 2 or more means that several licensees share the name. The rows under that name can belong to more than one person. See the Listing agent object.- Within one match level, the agents with the most listings come first. A name reads given name first, as the MLS feed writes it.
page.cappedis true when the API cut the page atlimit. The envelope’spageblock has the rule and what to do when it is true.- Without
market=, the API searches every loaded market with an agent registry. A licence-keyed agent has the same id in every market and appears once per market.
Gotchas
- A name of fewer than three letters after normalisation is a 400. The API matches a licence number exactly, so a partial number finds nothing.
- No cursor:
page.next_cursoris always null. - This host does not serve
name,license_stateandlicense_number. They are null withcontact_redacted: true. You can still open the profile byid. - A market with no published agent registry answers
422 agents_unavailable. With no market loaded at all, the search answers503 not_ready.
Related
Who is this listing agent?.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.
Required string length:
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.
Required string length:
1 - 16Agents to return, 1 to 50 (default 10).
Required range:
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?